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
Plan: Linie und Raster, Dateibrowser, Einfügen ins laufende Terminal
Kai-Jungsthoefelf59f1fbd89ff
diff --git a/PLAN.md b/PLAN.mdindex 10ed871..d347796 100644--- a/PLAN.md+++ b/PLAN.md@@ -202,7 +202,7 @@ Agenten befolgen `AGENTS.md` nicht zuverlässig. Sie können Dateien verschieben- **Kopfzeile:** Dokumentmenü (Neu, Öffnen, zuletzt geöffnete Modelle, Speichern unter, im Explorer zeigen, Startseite), Speicherstand („Nicht gespeichert · zuletzt 13:41“), Build-Anzeige in den Zuständen gebaut, baut (mit Abbrechen), fehlgeschlagen (mit Zeile) und „Code geändert“ bei ausgeschaltetem Auto-Build. Schaltet man Auto-Build wieder ein, baut die App den veralteten Stand gleich nach. Kurzbefehle Strg+S, Strg+Umschalt+S, Strg+O, Strg+N, Strg+B (nicht im Terminal).- **Viewer:** schwebende Bauteilkarte mit Auge, Suche, Referenzen-Abschnitt und Kontextmenü (Isolieren, Ausblenden, Kamera, Code zeigen, An Agent geben, Exportieren). Auswahlkarte mit Flächenart und Codeausschnitt. Fehlerkarte mit Meldung, Codezeile und Ablauf, das Modell bleibt gedimmt sichtbar. Ansichtswürfel (Oben, Vorne, Rechts), Einpassen, Standardansicht, Darstellungsmenü.- **Export (E34):** Menü mit allen 12 Formaten, für alle Bauteile oder die Auswahl, über `soma export` nach `exports/`.-- **Dateien und Code:** Dateibaum mit eingeklappten App-Dateien. Dateien und Ordner, die man ins Fenster zieht, landen in `inputs/`, Vorhandenes wird nie überschrieben (E33). Code-Panel zum Lesen mit Hervorhebung, der Auswahl im Viewer folgend.+- **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).@@ -211,7 +211,7 @@ Agenten befolgen `AGENTS.md` nicht zuverlässig. Sie können Dateien verschieben*Schritt 4, Markierung (erledigt, E16; 53 Prüfungen im Smoke-Test, 53 im Verlaufstest, 8 Einheitentests):*- **Ablauf:** „Markieren“ im Viewer oder „Markierung“ in der Übergabeleiste friert die aktuelle Ansicht in voller Auflösung ein. Bauteilkarte, Würfel und Karten treten zurück, ein gestrichelter Rahmen zeigt den Modus. „An Agent geben“ legt das Bild als `.soma/feedback/markierung-JJJJMMTT-HHMM.png` ab (nie überschreibend, bei Gleichstand `-2`) und fügt `[Markierung: <Pfad>] ` in die Eingabe des aktiven Terminals ein, ohne abzuschicken (E11).-- **Werkzeuge:** Stift, Pfeil, Rechteck, Kreis oder Ellipse (mit Umschalt: Quadrat und Kreis), Text. Farbmenü mit 10 Farben und eigener Farbe (Farbdialog), Rückgängig und Wiederholen (Strg+Z, Strg+Y), „Leere Fläche“ zum Skizzieren ohne Modell. Striche und Text haben einen dunklen Schatten, damit sie auch auf hellen Bauteilen lesbar bleiben.+- **Werkzeuge:** Stift, Linie und Pfeil (mit Umschalt: 15°-Schritte), Rechteck, Kreis oder Ellipse (mit Umschalt: Quadrat und Kreis), Text. Farbmenü mit 10 Farben und eigener Farbe (Farbdialog), Rückgängig und Wiederholen (Strg+Z, Strg+Y), „Leere Fläche“ zum Skizzieren ohne Modell, „Raster“ zum Ein- und Ausschalten. Striche und Text haben einen dunklen Schatten, damit sie auch auf hellen Bauteilen lesbar bleiben.- **Formen bleiben bearbeitbar (Wunsch des Nutzers):** Mit „Auswählen“ lässt sich jede Form anklicken und verschieben (auch mit den Pfeiltasten), an den Ecken skalieren (die gegenüberliegende Ecke bleibt stehen, Umschalt hält das Seitenverhältnis), am Punkt über dem Rahmen drehen (Umschalt: 15°-Schritte), umfärben und mit Entf löschen. Doppelklick auf einen Text, oder Klick mit dem Textwerkzeug, bearbeitet ihn. Jede Form speichert Mittelpunkt, Drehung und Skalierung getrennt von ihrer Geometrie, deshalb wächst die Strichstärke beim Skalieren nicht mit. Auswahlrahmen und Griffe kommen nicht ins Bild.- **Vorschau alter Stände:** Wird ein alter Stand markiert, nennt der eingefügte Text den Stand (Kurz-Hash und Nachricht), damit der Agent nicht mit dem aktuellen Code vergleicht.- **Robustheit:** Scheitert das Speichern, bleibt die Zeichnung offen. Der Hauptprozess nimmt nur PNG bis 64 MB an. Der Pfadschutz (`resolveInside`) prüft bei noch nicht vorhandenen Dateien jetzt den nächsten vorhandenen Ordner darüber, sonst hätte ein Verweis `.soma` → außen Dateien außerhalb des Projekts landen lassen.@@ -333,6 +333,12 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- Markierung: Eingefügt wird `[Markierung: .soma/feedback/markierung-JJJJMMTT-HHMM.png] ` (gleiche Form wie Auswahl und Build-Fehler). Beide Knöpfe („Markieren“ im Viewer, „Markierung“ in der Übergabeleiste) öffnen die Zeichenfläche- Markierung: Escape verwirft eine Zeichnung erst beim zweiten Druck, „Abbrechen“ sofort. Text wird mit Enter oder beim nächsten Klick übernommen- Markierungen zählen nicht als ungespeicherte Änderung und werden nie aufgeräumt (`.soma/feedback/` wächst, siehe ZIP-Größe unten)+- Markierung, Raster: 20 px weit, jede fünfte Linie kräftiger, halbtransparent. Es **steht mit im Bild** (wie Karopapier, der Agent sieht dieselben Kästchen). Linie, Pfeil, Rechteck und Ellipse rasten an den Kreuzungen ein, Alt beim Ziehen hebt das auf, der Stift rastet nie. Die Einstellung bleibt für die nächste Markierung, aber nicht über einen Neustart+- Dateibaum, Sperren: Nicht anlegen, umbenennen oder löschen lassen sich App-Dateien (`AGENTS.md`, `CLAUDE.md`, `.gitignore`), `output/` und `.soma/` (bis auf die Bilder in `.soma/feedback/`, die man umbenennen und löschen kann). `model.py` lässt sich nicht umbenennen oder löschen, `inputs/` und `parts/` nicht umbenennen (der Agent sucht sie unter diesem Namen). Dieselbe Regel prüfen Renderer und Hauptprozess (`fileOpBlockReason`)+- Dateibaum, Löschen: nur in den Papierkorb, nie endgültig. Klappt der Papierkorb nicht, bleibt die Datei und es kommt eine Meldung. Umbenennen und Löschen werden abgelehnt, solange die Datei (oder eine im Ordner) im Editor ungespeichert ist. Offene Reiter ziehen beim Umbenennen mit+- Dateibaum, Öffnen: „Mit Standardprogramm öffnen“ lehnt Ausführbares ab (`.exe`, `.bat`, `.ps1`, `.js`, `.py`, `.lnk` …), weil der Arbeitsordner nicht vertrauenswürdig ist. Klick auf ein Bild öffnet es mit dem Bildprogramm des Systems. „Pfad an Agent geben“ fügt `[Datei: <Pfad>] ` ein+- Dateibaum, Symbole: nur die Form unterscheidet die Typen, nicht die Farbe (Farben haben feste Bedeutungen)+- Einfügen in den Agenten (Auswahl, Markierung, Build-Fehler, Pfad): immer ins aktive Terminal. Ist es beendet, ins zuletzt benutzte, das noch läuft (es kommt nach vorn). Nur wenn keines mehr läuft, kommt der Hinweis auf „+“- Editor: **CodeMirror 6** statt Monaco (leichter, braucht keine Worker, passt zur Sicherheitsrichtlinie, lässt sich mit den eigenen Farben gestalten). Keine Autovervollständigung und keine Prüfung beim Tippen, das übernimmt der Build- Editor (E39, Auslegung): **Strg+S im Editor** speichert Code und baut, ohne ZIP und Snapshot. **Strg+S außerhalb** und „Speichern“ oben speichern das ganze Modell. Grund: Beim Ausprobieren im Code soll nicht jedes Speichern einen Snapshot anlegen und beim neuen Modell nach dem ZIP-Ort fragen. Änderungen des Agenten baut weiter der Auto-Build- Editor: Nach Strg+S ohne Änderung oder nur an Notizen wird nicht gebaut (E40). „Jetzt bauen“ speichert vorher und baut immer. Bei einem Konflikt wird weder gespeichert noch gebaut