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
Doku: Arbeitsdokumente nur noch lokal, Verweise nachgezogen (E88)
Kai-Jungsthoefel03a2fedec089
diff --git a/.gitignore b/.gitignoreindex d73b150..00fc736 100644--- a/.gitignore+++ b/.gitignore@@ -21,5 +21,10 @@ app/test/shots/examples/+# Arbeitsdokumente der Entwicklung, nur lokal (E88)+PLAN.md+DECISIONS.md+IDEA.md+# Trailer (Remotion-Projekt, Aufnahmen und Renderings)video/diff --git a/CHANGELOG.md b/CHANGELOG.mdindex b7ca1ef..14e72ab 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -10,13 +10,16 @@ eigenen Abschnitt mit Datum und Git-Tag.- FEM mit Schrauben: `study.bolt("Schraube 1")` spannt eine Schraube aus `soma.fasteners` vor, dann wirken die Lasten. Das Ergebnis nennt je Schraube Vorspannung, Zug und Querkraft am Ende und die Auslastung der Streckgrenze, der Kontakt der Fuge zeigt, ob sie klafft oder rutscht. Ohne Angabe 70 % der Streckgrenze, bei Kunststoffteilen begrenzt auf das, was die Fläche unter dem Kopf trägt. Mutter, Scheibe und verschraubte Teile rechnen von selbst mit (E84).+### Geändert++- Die mitgelieferten Skills haben englische Dateinamen, etwa `3d-printing.md` statt `3d-druck.md`. Ältere Modelle behalten ihre Kopien unter dem alten Namen, die App erkennt sie weiter als denselben Skill. Eigene Fassungen mitgelieferter Skills in den Einstellungen ziehen beim Start mit um (E87).+### Behoben- Ein Klick auf Analysis oder Animation in der Leiste links zeigt die Liste, statt gleich ein Ergebnis zu öffnen (E86).- FEM: Die Kraft, die ein Kontakt trägt, stimmt jetzt auch, wenn das Teil zusätzlich an etwas hängt oder der Kontakt auf die Kante eines Lagers drückt. Vorher konnten Kontaktkraft und Gleichgewicht der Lagerkräfte dort deutlich danebenliegen.- FEM: Netze mit einzelnen umgeklappten Elementen in engen Spalten (etwa zwischen Scheibe und Mutter) werden geglättet, statt mit „distorted elements“ abzubrechen.- FEM: Kein „-0.0“ mehr in Kräften im Ergebnis.-- FEM mit Kontakt: Eine Platte, die nur über den Kontakt gehalten wird (etwa ein Halter mit Arm), brach mit „a part moves without limit“ oder „The contact does not settle“ ab. SOMA hielt das Suchen der Berührfläche zu früh für Pendeln, und das weiche Ersatzgesetz drückte die Teile auseinander. Jetzt rechnet der Kontakt weicher (Steifigkeit gleich dem E-Modul statt dem Zehnfachen, Verschiebungen 0.4 % anders), darf länger suchen, und das Ersatzgesetz richtet sich nach der Last (E84).- Skill „Strength with FEM“: Reibung zwischen verschraubten Teilen hält nur mit `bolt()`, der Skill sagt das jetzt.diff --git a/CLAUDE.md b/CLAUDE.mdindex b67ffd1..b48b0c3 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -6,6 +6,7 @@ Anweisungen für Claude Code bei der Entwicklung von SOMA (*Solid Object ModelinEine Desktop-App (Electron, TypeScript), in der ein Nutzer mit einem CLI-Agenten seiner Wahl (Claude Code, OpenCode …) 3D-Modelle in CadQuery entwirft. Wir bauen **keinen eigenen Harness**. Die App liefert Terminal, 3D-Viewer, Projektformat (`.soma`, eine ZIP mit Git, E79) und die Hilfsbibliothek `soma`.+- `PLAN.md`, `DECISIONS.md` und `IDEA.md` liegen nur lokal, nicht im Repo (E88, in `.gitignore`, im Git-Verlauf bis `v0.5.0`). Fehlen sie, gibt es keinen Plan und kein Log nachzuziehen.- `PLAN.md` ist der gültige Plan mit Phasenstand (Abschnitt 10) und offenen Punkten (Abschnitt 11). Er geht vor `IDEA.md`.- `DECISIONS.md` ist das Entscheidungslog. `(E12)` in Plan und Code verweist darauf. Neue Entscheidungen des Nutzers kommen als neue Zeile ans Ende, alte Zeilen werden nicht umgeschrieben.- `IDEA.md` ist die Ursprungsidee und bleibt unverändert.@@ -77,6 +78,7 @@ node test/run-all.mjs smoke editor # einzelne Suiten parallel, nach npm run bu- CadQuery-Versionen fest pinnen: cadquery 2.8.0 braucht `cadquery-ocp<8` und `multimethod<2`, ungepinnt kommt Inkompatibles.- `dugite` bleibt im esbuild-Bundle extern (sein Git-Pfad ist relativ zum Paket).- Windows-Kurznamen (`NAME~1`) in Temp-Pfaden: Pfade nicht als Strings vergleichen.+- Zeilenenden: `.gitattributes` checkt alle Textdateien mit LF aus, auch bei `core.autocrlf=true`. Vorlage und Skills gehen so in Nutzerprojekte, Tests vergleichen mit `\n`.## Doku und Arbeitsweisediff --git a/DECISIONS.md b/DECISIONS.mddeleted file mode 100644index 45b7b32..0000000--- a/DECISIONS.md+++ /dev/null@@ -1,91 +0,0 @@-# Entscheidungslog: SOMA (CAD mit KI-Agenten)--> Chronologischer Log aller Entscheidungen aus der Planungsphase. Die Nummern werden im [PLAN.md](PLAN.md) referenziert. Spätere Entscheidungen können frühere präzisieren oder ersetzen (in der Spalte „Anmerkung" vermerkt). Stand: 2026-10-01--| # | Thema | Entscheidung | Anmerkung |-|---|---|---|---|-| 1 | Basis | Eigene Desktop-App | Kein VS-Code-Fork/Extension. Framework siehe Entscheidung 23 |-| 2 | Plattformen | Windows, macOS, Linux von Anfang an | Betrifft Python-Bundling, PTY-Terminal, Pfad-Wiederherstellung |-| 3 | Zielgruppe | Nicht-Programmierer | Python + CAD-Framework werden mitgeliefert (isolierte Umgebung) |-| 4 | Agent-Setup | Nutzer installiert Agent selbst, App hilft | Erkennung installierter Agenten, Startbuttons, Installationshinweise. Login/Abo beim Nutzer |-| 5 | Chat-Historie | Nur Projektordner in der ZIP, Chats bleiben lokal | Stabiler Pfad pro Projekt hält Chats auf demselben Rechner erhalten. Auf anderen Rechnern gehen sie verloren (bewusst akzeptiert) |-| 6 | Modellstruktur | `model.py` als fester Einstiegspunkt, `parts/` für Bauteile, `inputs/` für mitgebrachte Dateien (z. B. STEP), `output/model.step` als Hauptergebnis mit benannten Komponenten | Orientierung an CAD-Konzepten (Part/Assembly/Referenz/Parameter). Einfacher Fall = alles in `model.py`. Ordnernamen im Detail noch offen |-| 7 | Git / Historie | Jedes Projekt bekommt ein Git-Repo (in der ZIP enthalten). Der **Agent committet selbst** nach sinnvollen Iterationen (Anweisung in `AGENTS.md`) | Nutzer bringt ohnehin einen CLI-Agenten mit, daher kein "unsichtbares Git" nötig |-| 8 | Git & STEP | `output/model.step`, Skripte und `inputs/` werden getrackt. Abgeleitete Viewer-Daten (Tessellation/Meshes) und Cache in `.gitignore`. Beim Speichern der ZIP committet die App verbliebene Änderungen als **Auto-Snapshot** | Framework-Version wird im Projekt festgehalten (Reproduzierbarkeit) |-| 9 | Viewer-Technik | Mesh-Viewer (three.js) + Python-Prozess für exakte Werte | Nach jedem Build wird STEP → GLB (mit Bauteilnamen, Farben, Flächen-/Kanten-IDs) tesselliert. Punkt-zu-Punkt und Bounding-Box im Viewer, exakte Messungen (Radius, Durchmesser, Flächenabstand) per Anfrage an Python/OCP. Kein zweiter CAD-Kern im Frontend |-| 10 | Geometrie ⇄ Code-Mapping | Mitgelieferte **Hilfsbibliothek ist verbindlich**: `model.py` registriert jedes Bauteil über unsere Funktion (z. B. `add_part("Deckel", obj)`) und exportiert darüber. Die Bibliothek merkt sich Datei und Zeile, schreibt Namen in den STEP-Baum und Positionen in `output/model.map.json` | Mapping zunächst nur auf Bauteilebene. Später optional: Flächen-/Feature-Tags. Automatisches Topological-Naming-Tracing bewusst nicht im Scope. Funktionsnamen und API sind noch Entwurf |-| 11 | Agent-Anbindung | MVP: Screenshots/Skizzen als Datei in `feedback/` (nicht in Git, nur auf Wunsch ins Projekt übernehmen); App fügt Pfad bzw. Auswahltext (Bauteilname, Datei, Zeilen) in die Eingabezeile des Terminals ein, Nutzer schickt selbst ab. Später: MCP-Server der App (Screenshot, Auswahl, Messungen abfragbar) | Agent-unabhängig, funktioniert mit jedem CLI-Agenten |-| 12 | CAD-Framework | **CadQuery** (fest). OpenSCAD ausgeschlossen (kein STEP/B-Rep) | Begründung: Nutzer kennt CadQuery, größte Community und meiste Trainingsdaten/Datasets. build123d wäre Alternative gewesen (Labels/Farben im STEP belegt, schlankeres Paket, in einer Studie höhere Ausführungsquote). **Zu prüfen:** (a) STEP-Export mit Bauteilnamen bei `cq.Assembly` (Doku deutet auf Verlust im Standardmodus hin; `fused` wäre unbrauchbar) – notfalls eigener XCAF-Export über OCP in der Hilfsbibliothek; (b) Installationsgröße ohne VTK; (c) Python 3.11+ und Versions-Pinning. Gegenmaßnahmen für fehleranfällige Fluent-API: strikte `AGENTS.md`-Idiome, Beispiele, Feedback-Loop (ausführen, messen, rendern) |-| 13 | Vorgehen / Phasen | **Phase 0:** technischer Prototyp ohne App (Hilfsbibliothek, STEP mit Bauteilnamen/Farben, GLB mit Flächen-IDs, Klick→Codezeile-Mapping, Python-Einbettung, einfacher Browser-Viewer). **Phase 1:** MVP-Kern als Desktop-App (Projekt neu/speichern/öffnen als ZIP mit Git, Editor, Terminal mit Agent, Viewer mit Bauteilbaum und Ein-/Ausblenden, Screenshot mit Markup, `AGENTS.md`). **Danach:** Messen, Schnittansicht, Versions-Schieber, Skills, MCP (siehe Entscheidung 22) | Riskanteste Annahmen werden in Phase 0 günstig geprüft |-| 14 | Phase-0-Umfang | Fünf Prüfpunkte: (1) STEP mit Bauteilnamen/Farben (ca. 5 Bauteile, Baum nach Export + Reimport intakt); (2) GLB mit Flächen-IDs (eigener Mesher, Dreiecksbereich pro Fläche); (3) Klick im Browser-Viewer → Datei + Zeile aus `model.map.json`; (4) Import eines mitgebrachten STEP, Messen, Aussparung, Anzeige als Referenzobjekt; (5) isolierte Python-Umgebung mit CadQuery ohne VTK, Installationsgröße gemessen | Agent-Test (Agent baut Beispielmodell mit erster `AGENTS.md`) folgt in Phase 1 |-| 15 | Grundlayout | Von links nach rechts: **Tree** → **Editor (optional, ein-/ausblendbar)** → **3D-Viewer / 2D-Sketch** (gleicher Bereich, umschaltbar) → **Terminal** rechts mit mehreren Tabs. **Top Bar** für Optionen und Operationen | Tree hat zwei Reiter: **Modell** (Bauteilbaum, Standard; Ein-/Ausblenden, Klick → Viewer + Codezeile) und **Dateien** (Dateibaum, Drag-and-drop für Inputs). **Versions-Schieber** als Leiste unter dem Viewer. Offen: Ist der Mittelbereich Tab-Umschaltung oder Split (Viewer/Sketch)? Docking später |-| 16 | 2D-Sketching | Nur **Bild-Markup ohne Maßhaltigkeit**: Zeichnen auf Viewer-Screenshots und auf leerer Fläche (Freihand, geometrische Formen, Pfeile, Text). Ergebnis ist ein PNG in `feedback/`, Pfad wird dem Agenten übergeben. Maße stehen als Text daneben | Kein Constraint-Sketcher. Bei späterem Bedarf eigenes Teilprojekt |-| 17 | Skills | Aktivierte Skills werden als Markdown nach `skills/` im Projekt kopiert und in der `AGENTS.md` aufgelistet (App pflegt die Liste bei An-/Abwahl). Agentenunabhängig, wandert mit ZIP und Git. MVP mit wenigen **mitgelieferten** Skills (z. B. 3D-Druck, Toleranzen, Gehäusebau) | Eigene Nutzer-Skills später. Aktivierung pro Projekt (Projekteinstellungen). Inhalt der Skills noch zu erarbeiten |-| 18 | AGENTS.md | **Zwei getrennte Dateien:** app-verwaltete `AGENTS.md` (Konventionen, Skill-Liste, Git-Regeln, Hilfsbibliothek; wird bei App-Updates erneuert, Nutzer ändert sie nicht) und nutzerverwaltete Notizdatei (Arbeitsname z. B. `NOTES.md`; Projektnotizen von Nutzer/Agent, wird nie überschrieben). `AGENTS.md` verweist auf die Notizen. Für Claude Code zusätzlich `CLAUDE.md` als Verweis auf `AGENTS.md` | Risiko: Nicht jeder Agent folgt Verweisen zuverlässig, daher Verweis in `AGENTS.md` ganz oben und explizit formulieren; im Agent-Test prüfen. Versionsnummer in `AGENTS.md` für Updates. Dateiname der Notizen noch offen |-| 19 | Terminal | **Freies Terminal** (normale Shell-Tabs im Projektordner) + **Startvorlagen** (Buttons starten erkannte Agenten wie Claude Code, OpenCode per Befehl) + **Auto-Start** des zuletzt benutzten Agenten beim Öffnen, **ohne automatisches Resume** (kein `--continue` o. Ä.). Mehrere Tabs möglich | Interpretation: Auto-Start bleibt, nur das Fortsetzen der Session entfällt. Falls Auto-Start ebenfalls nicht gewünscht ist, bitte korrigieren. Nutzer kann Sessions im Agenten selbst fortsetzen |-| 20 | Build | **Auto-Build bei Änderung** von `model.py`/`parts/` (Hintergrund, Debounce, abbrechbar), **abschaltbar**; dann Build manuell per **Knopf** oder durch den **Agenten**. Gemeinsamer Build-Befehl für App und Agent (Arbeitsname `cadide build`, in `AGENTS.md` festgelegt) erzeugt STEP, GLB und Mapping aus einem Lauf | Grund für Abschaltbarkeit: Große Modelle bauen lange und würden die App lahmlegen. Offen: Standard an/aus, Statusanzeige und Fehlerpanel, Verhalten wenn ein Build läuft und die Datei sich erneut ändert |-| 21 | Speichern/Öffnen | Jedes Projekt hat eine **feste ID (UUID)** in der ZIP (z. B. `project.json`). Arbeitsordner immer unter `<App-Daten>/workspaces/<uuid>/` (nicht im OS-Temp, damit er nicht aufgeräumt wird). Beim Öffnen: Ordner existiert nicht → ZIP entpacken; Ordner existiert mit ungespeicherten Änderungen oder Abweichung → **Rückfrage** (Wiederherstellen oder ZIP laden). **Speichern nur ausdrücklich** (kein Autosave in die ZIP), dazu Absturz-Wiederherstellung | Neue Projekte starten im Arbeitsordner ohne ZIP, bis der Nutzer erstmals speichert. Offen: Erkennung von Abweichungen (Zeitstempel oder Git-Commit), mehrere Fenster/Projekte parallel, Aufräumen alter Workspaces, Verhalten bei ZIP auf Netzlaufwerk |-| 22 | Viewer-Umfang | **Phase 1 (MVP):** Navigation, Standardansichten (Vorne/Oben/Iso), Darstellungsmodi (schattiert, Kanten, Drahtgitter, Transparenz), Ein-/Ausblenden über den Modell-Tree, Klick auf Bauteil → Codezeile, **Screenshot mit Markup** (Kernvorteil ggü. normalen IDEs). **Danach:** Messen (Punkt-zu-Punkt, Bounding-Box, exakte Werte), Schnittansicht (wichtig für Gehäuse/Wandstärken), Versions-Schieber. **Später:** Volumen/Gewicht, Versionsvergleich, Explosionsansicht | Ändert Entscheidung 13: Screenshot/Markup rückt in Phase 1 vor, Messen und Schnitt folgen direkt danach |-| 23 | Desktop-Framework | **Electron** (TypeScript). Terminal: xterm.js + node-pty. Python-Prozess für CAD als Kindprozess | Gründe: Einheitliches Chromium auf allen 3 OS (WebGL/three.js identisch), erprobtes Terminal, großes Ökosystem, Größe spielt wegen mitgeliefertem Python kaum eine Rolle. Konkretisiert Entscheidung 1 |-| 24 | Python-Anbindung | **Langlebiger Python-Dienst pro Projekt** für die App (Modell und importierte STEP im Speicher, schnelle Messungen; Kommunikation z. B. JSON über stdin/stdout oder lokalen Socket) **plus** eigenständiger **Einmal-Prozess** für den Build-Befehl des Agenten (funktioniert auch ohne laufende App) | Offen: Abstürze/Neustart/Abbrechen des Dienstes; Pakete siehe Entscheidung 25 |-| 25 | Python-Pakete | **Basisumgebung** (Python + CadQuery) bleibt unverändert. Pro Projekt eine **eigene Umgebung** im Arbeitsordner (nicht in der ZIP). Jedes Terminal startet mit **aktivierter Projektumgebung im PATH**, der Agent nutzt **normales `pip`/`python -m pip`**. Die App liest installierte Pakete per `pip freeze` aus (nach Build und beim Speichern), zieht die Basispakete ab und schreibt eine gepinnte **Paketliste** (z. B. `requirements.txt`) ins Projekt (ZIP und Git). Beim Öffnen auf einem anderen Rechner wird die Umgebung aus der Liste neu aufgebaut. App zeigt neu hinzugekommene Pakete an | Ersetzt den ursprünglichen Vorschlag `cadide add` (Idee des Nutzers, einfacher und robuster). Keine Bestätigung pro Paket. Offen: Agent nutzt anderes Python an der Umgebung vorbei (`--user`, voller Pfad), Offline-Fall, Paketcache, Installation beim Öffnen ohne Internet |-| 26 | Ordnerstruktur | **Hauptordner:** `AGENTS.md`, `CLAUDE.md`, `NOTES.md`, `requirements.txt`, `model.py`, `parts/`, `inputs/`, `output/model.step`. **`.cadide/`:** `project.json` (ID, App-/Framework-Version, aktive Skills), `skills/`, `feedback/`, GLB-Cache, `model.map.json`. Dazu `.git/` und `.gitignore` | Präzisiert 6, 10, 11, 17: Skills, Feedback und Mapping liegen unter `.cadide/` (Pfade in diesen Zeilen entsprechend lesen). `output/model.step` bleibt im Hauptordner. Skills liegen in einem versteckten Ordner, `AGENTS.md` muss sie daher mit vollem Pfad nennen. Dateibaum der App kann App-Dateien ausblenden. Offen: was von `.cadide/` getrackt wird (`project.json`, `skills/` ja; `feedback/` und Cache nein) |-| 27 | Projektzustand | Wichtiger Zustand (ID, Einstellungen, aktive Skills, Hauptdatei) liegt **doppelt**: `.cadide/project.json` im Projekt (wandert in die ZIP) und eine **Kopie in den App-Daten** (`<App-Daten>/workspaces/<uuid>/state.json`). Bei Löschung oder Beschädigung Wiederherstellung aus der Kopie; bei Abweichung Zeitstempel bzw. Rückfrage. ZIP ohne Kopie (anderer Rechner): Datei aus der ZIP gilt | Setzt Regel 4 des Leitprinzips um. Restrisiko: Arbeitsordner und App-Daten beide verloren, dann zählt nur die letzte ZIP |-| 28 | Struktur-Check als CLI | Befehl **`cadide check`**: **nur prüfen und melden, nie automatisch reparieren** (kein `--fix`). Verständliche Ausgabe mit **konkreten Handlungshinweisen** (was ist falsch, was ist zu tun), zusätzlich maschinenlesbar. Der Agent behebt Probleme selbst anhand der Hinweise, mehrdeutige Fälle gehen als Frage an den Nutzer. **Derselbe Code** wie der Projekt-Check der App. `cadide build` führt vorab einen kurzen Check aus und gibt Warnungen mit aus. Die App prüft zusätzlich unabhängig vom Agenten (Öffnen, Bauen, Speichern) | Entscheidung des Nutzers: Der Agent kann den Workspace prüfen und sich Fehler anzeigen lassen und **repariert dann nach eigenem Ermessen**. Kein `--fix`, **kein Reparieren-Button** in der App (ersetzt den Vorschlag mit drei Reparaturklassen). **Offen:** (a) Ob das Wiederherstellen von `project.json` aus der App-Kopie (Entscheidung 27) trotzdem automatisch geschehen darf, oder nur gemeldet wird (Vorschlag: als App-Zustand automatisch wiederherstellen und dem Nutzer anzeigen); (b) Format der maschinenlesbaren Ausgabe |-| 29 | Sicherheit | **Keine Sandbox, kein eigener Schutz vor dem Agenten.** Für Schutz sind **Nutzer und Agenten-Harness verantwortlich**. Das ist ein Grund, keinen eigenen Harness zu bauen (sonst wären wir für das Verhalten des Agenten verantwortlich). Die App startet Terminals im Projektordner mit der Projektumgebung, mehr nicht | Beim ersten Start ein klarer Hinweis, dass der Agent mit den Rechten des Nutzers läuft (Vorschlag, nicht bestätigt). Projekt-Check und Zustandskopie (27, 28) sind Robustheit, keine Sicherheit. Sandbox nicht geplant |-| 30 | Ziel / Lizenz | **Open Source.** Konkrete Lizenz noch offen (MIT oder Apache-2.0 naheliegend, vereinbar mit CadQuery Apache-2.0, Electron/three.js/xterm.js MIT, OpenCascade LGPL). Folgen: Installer für 3 OS, Auto-Updates, öffentliches Repo, Doku, Community-Support | Zu prüfen: Lizenzen aller mitgelieferten Komponenten (Python, OCP/OpenCascade, VTK falls doch mitgeliefert, Git), Code-Signing für Windows/macOS, Updater |-| 31 | Git-Bereitstellung | **Git wird mitgeliefert** (eingebettetes Git, z. B. dugite, für alle drei OS, gleiche Version bei allen Nutzern) und in den PATH der Terminals gelegt. Agent und App nutzen dasselbe `git` | Lizenztexte (Git ist GPL) beilegen. Offen: Konkrete Einbettung, Updates des Git-Binaries |-| 32 | Auslieferung | **Nur eine Variante: „alles drin"** (Python, CadQuery, Git mitgeliefert). **Kein Bring-your-own** und keine Lite-Variante geplant | Grund: eine getestete Umgebung, keine Testmatrix aus fremden Versionen, passt zum Leitprinzip der Robustheit. Ein späterer Installer mit Nachladen der geprüften Umgebung bleibt denkbar, ist aber nicht geplant |-| 33 | Importe / Fremd-STEP | Mitgebrachte Dateien werden einfach **in `inputs/` abgelegt** (Drag-and-drop im Dateien-Tab). Der **Agent bindet sie im Skript ein** (nur dort ist die Position festgelegt). Der Viewer kann **beliebige weitere STEP-Dateien anzeigen**, dann im Basismodus **ohne** Bauteilbaum-Mapping, Klick→Code und weitere Zusatzfunktionen. **Standardanzeige ist immer das Hauptmodell** (`output/model.step`) | Deckt sich mit Rückfallweg (Regel 2 des Leitprinzips). Rollen siehe Entscheidung 34 |-| 34 | Export & Rollen | **`output/model.step` enthält immer alles**, auch Referenzen. **Export einzelner Bauteile** über einen **Befehl** (Arbeitsname `cadide export <Bauteil\|--all> --format <step\|stl\|…>`) und über das **Kontextmenü im Modell-Tree**, jeweils auf Basis der registrierten Bauteile und des gebauten Modells. Ausgabe nach `exports/`. Kein Exportcode im Skript nötig (bleibt erlaubt, ist aber nicht der vorgesehene Weg). Die Hilfsbibliothek kennt die Rolle **`reference`** (`add_part(..., role=...)`) nur als **Markierung**: halbtransparent im Viewer, eigener Ast im Tree, standardmäßig nicht in `--all` | **Offen/zu prüfen in Phase 0:** unterstützte Formate über STEP und STL hinaus (3MF, AMF, DXF, SVG); Verhalten bei veraltetem Modell (Hinweis oder vorher bauen); ob `exports/` getrackt wird. Rolle im Code gesetzt, kein Umwidmen per App. Rolle `reference` und Standardwerte sind Vorschlag und noch nicht ausdrücklich bestätigt |-| 35 | Versions-Schieber: Zurückspringen | Der Schieber zeigt alte Stände als **Vorschau** (STEP per `git show`, Arbeitsordner unberührt). Ein Knopf **Stand wiederherstellen** kopiert die Dateien des gewählten Stands in den Arbeitsordner und legt einen **neuen Commit** an. Historie bleibt vollständig, kein Checkout/Reset, keine Branches. Warnung bzw. Sperre bei uncommitteten Änderungen | Konkretisiert 7, 8. Offen: Ob der Agent währenddessen weiterarbeitet (Sperre?), Umgang mit Änderungen des Agenten am Repo (Branch-Wechsel, Reset, History-Umschreiben, siehe Störfall-Tabelle), Beschriftung der Punkte (Commit-Nachricht, Vorschaubild) |-| 36 | Updates | Die **Hilfsbibliothek** (Paket `cadide`) liegt in der **mitgelieferten Basisumgebung**, nicht im Projekt. Neue App-Versionen bringen sie mit, alte Projekte profitieren von Fixes. **`api_version` in `project.json`** sichert Abwärtskompatibilität. Beim Öffnen eines Projekts mit älterer Regelversion wird die app-verwaltete **`AGENTS.md`** (laut Entscheidung 18 ganz app-verwaltet, Notizen liegen getrennt) und **`skills/`** erneuert, **dem Nutzer angezeigt** und als **Commit gesichert** | Die Projektumgebung (25) muss die Basisumgebung sehen, damit `cadide` importierbar bleibt. Offen: Regeln für Abwärtskompatibilität der API (wie lange werden alte `api_version` unterstützt), was passiert, wenn ein Projekt eine **neuere** `api_version` hat als die App, Auto-Update der App selbst (Updater, Signierung) |-| 37 | Installationsgröße | **Vorerst nicht optimieren.** Die volle CadQuery-Umgebung wird genommen, wie sie ist (inklusive aller VTK-Bibliotheken). | Präzisiert 31 und 32. Auslöser war die Messung in Phase 0: OCP hängt hart an VTK, `import cadquery` lädt alle 209 VTK-DLLs, gut 0,7 bis 1,0 GB installiert. Details in `prototype/phase0/ERGEBNISSE.md`. Optimierung (Casadi, VTK-Teilmenge, Komprimierung) bleibt für später |-| 38 | Oberfläche | **Entwurf „Modell zuerst" umgesetzt** (`design/ui-entwurf.html`, vom Nutzer freigegeben). Der Viewer bekommt die größte Fläche. Die **Bauteilliste schwebt als Karte im Viewer** (nur so hoch wie ihr Inhalt, einklappbar, Referenzen als eigener Abschnitt). **Dateien und Code klappen links aus einer schmalen Leiste aus**, immer nur ein Panel. Die Kopfzeile zeigt **Zustände statt Knopfreihen**: Modellname als Dokumentmenü (Neu, Öffnen, Zuletzt geöffnet, Speichern unter), Speicherstand in Worten, Build-Anzeige mit Auto-Build-Schalter, dazu nur Exportieren und Speichern. Die Statusleiste entfällt. Werkzeuge und Ansichtswürfel schweben im Viewer. Der **Agent-Bereich** rechts ist einklappbar, Agenten starten über „+", eine **Übergabeleiste** fügt Auswahl, Markierung oder Build-Fehler in die Eingabe des Agenten ein. Dazu eine Startseite | Ersetzt den Tree mit den Reitern *Modell* und *Dateien* aus 15. Die Aufteilung von links nach rechts (Tree/Panels, Editor, Viewer, Terminal) bleibt. Farben mit fester Bedeutung: Orange Aktion und Auswahl, Violett Vorschau alter Stände, Grün/Gelb/Rot Status. Offen: helles Farbschema, Anordnung bei sehr kleinen Fenstern |-| 39 | Editor: Speichern und Bauen | **Kein automatisches Speichern im Editor.** Gespeichert wird nur, wenn der Nutzer es auslöst (Strg+S oder Knopf), **gebaut erst danach**. Beim Tippen ändert sich nichts auf der Platte, und es wird nicht gebaut | Ersetzt das automatische Sichern nach 0,6 s aus dem ersten Stand des Editors. Auslegung (nicht ausdrücklich bestätigt): Strg+S im Editor und „Speichern und bauen“ schreiben die Dateien und bauen, ohne ZIP und Snapshot. „Speichern“ oben speichert Editor, Snapshot und ZIP wie bisher. Änderungen des Agenten baut weiter der Auto-Build (E20, abschaltbar). Vor Modellwechsel, Wiederherstellen und Beenden fragt die App bei ungespeicherten Eingaben nach (Speichern, Verwerfen mit Sicherung, Abbrechen) |-| 40 | Editor: Was gebaut wird | **Gebaut wird nach dem Speichern nur, wenn eine gespeicherte Datei das Modell betrifft** (Python). Wer eine Markdown-Datei wie `NOTES.md` bearbeitet, speichert nur, es wird nicht gebaut | Präzisiert 39. Auslegung (nicht ausdrücklich bestätigt): dieselbe Regel wie bei der Dateiüberwachung, also neben `.py` auch Dateien in `inputs/` (etwa Tabellen, die `model.py` einliest). Der Knopf heißt dann „Speichern“ statt „Speichern und bauen“. „Jetzt bauen“ baut immer |-| 41 | Oberfläche: Meldungen | **Kurze Meldungen** (etwa „In die Eingabe von … eingefügt“) erscheinen **oben rechts**, unter der Kopfzeile und den Reitern des Agent-Bereichs | Weicht vom Entwurf (38) ab, dort standen sie unten im Agent-Bereich. Grund: Unten lagen sie über der Eingabezeile des Agenten |-| 42 | Gruppen und Transparenz | **Gruppen im eigenen Modell und beim Import:** `add_part(..., group="Gehäuse/Schrauben")`, und importierte STEP-Baugruppen behalten ihre Struktur (jeder Körper ein Bauteil mit Name und Farbe, Unterbaugruppen als Gruppen). Die Bauteilkarte zeigt einen Baum, die Ausgabe-STEP dieselben Gruppen. **Jedes Bauteil und jede Gruppe lässt sich transparent schalten**, zusätzlich zum Aus- und Einblenden | Präzisiert 10 und 34. Auslegung (nicht ausdrücklich bestätigt): Import mit Struktur über `import_assembly()`, `import_step()` bleibt beim einen Körper. Transparente Teile lassen Klicks durch, damit man dahinter auswählen und messen kann |-| 43 | Name | Die Software heißt **SOMA** (*Solid Object Modeling with Agents*, griechisch σῶμα „Körper“). Der Name gilt **überall**: Oberfläche, Python-Paket und Befehl `soma`, Projektordner `.soma/`, Umgebungsvariablen `SOMA_*`, App-Daten unter `%LOCALAPPDATA%\soma` | Ersetzt die Arbeitsnamen „CAD-IDE“ und `cadide` (u. a. in 27, 28, 34 und 36). **Ohne Rückfallweg** für ältere Projekte: ZIPs mit `.cadide/` öffnet die App nicht mehr, ein `model.py` mit `from cadide import` baut nicht mehr. Ausgenommen sind `prototype/` und die Entwicklungsumgebung unter `%LOCALAPPDATA%\cadide-phase0` (ein verschobener venv läuft nicht mehr) |-| 44 | Icon | Das Zeichen von SOMA ist **„Dialog“**: der Würfel aus der Kopfzeile als **Sprechblase mit orangem, gefülltem Deckel**. Als App-Icon (Fenster, Taskleiste) steht es auf einer Graphit-Fläche mit runden Ecken, in der Kopfzeile allein in Orange | Gewählt aus fünf Entwürfen (`design/icon-vorschlaege.html`). Auslegung (nicht ausdrücklich bestätigt): Graphit-Fläche fürs App-Icon, kleine Größen (bis 48 px) mit dickerem Strich und größerem Zeichen |-| 45 | Skills: Inhalte | **Mitgeliefert wird ein Satz allgemeiner Skills in drei Gruppen.** Arbeitsweise: Konstruktionsablauf, Sauber modellieren (CadQuery). Fertigungsverfahren: 3D-Druck FDM, 3D-Druck Harz und Pulver, CNC-Fräsen und Drehen, Laserschneiden, Blech. Konstruktionswissen: Toleranzen und Passungen, Verbindungen, Normteile, Festigkeit und Steifigkeit, Baugruppen und Bewegung. **Anwendungs-Skills** (Gehäusebau, Halterungen, Griffe …) werden vorerst nicht ausgebaut. Die Skills sind **kurz und knapp**, damit auch kleinere Modelle sie befolgen | Präzisiert 17. Gehäusebau bleibt, wie er ist. Auslegung (nicht ausdrücklich bestätigt): Werte sind Richtwerte, jeder Wert steht möglichst nur in einem Skill, ein Verfahrens-Skill geht den allgemeinen Toleranzen vor |-| 46 | Skills: Kategorien und Standard | **Jeder Skill nennt seine Kategorie**, das Panel zeigt die Skills unter Überschriften (Arbeitsweise, Fertigungsverfahren, Konstruktionswissen, Anwendungen). **Ob ein Skill bei neuen Modellen eingeschaltet ist, lässt sich einstellen** | Präzisiert 17 und 45. Auslegung (nicht ausdrücklich bestätigt): Der Kopf des Skills gibt den Standard vor (`default: on`, ab Werk Konstruktionsablauf und Sauber modellieren), der Nutzer stellt ihn je Skill für die ganze App um. Gilt nur für neu angelegte Modelle, Einstellungswerte gehören nicht dazu |-| 47 | Skills: Gehäusebau | **Der Skill „Gehäusebau“ wird nicht mehr mitgeliefert** | Ersetzt den Teil von 45, nach dem er bleibt. Anwendungs-Skills gibt es damit vorerst keine. Projekte, die ihn eingeschaltet haben, behalten ihre Kopie (gilt weiter, die Karte meldet, dass die App ihn nicht mitbringt) |-| 48 | Normteile | **Eigene Bibliothek `soma.fasteners`** für Schrauben, Muttern, Scheiben und Gewindeeinsätze, gebaut auf den **Maßtabellen von bd_warehouse** (Apache 2.0), **ohne Gewinde**. Der Agent soll sie **leicht positionieren** können. **Neue Rolle `hardware` (Zukaufteil):** deckend, in der STEP bei ihrer Gruppe, von `soma export --all` übersprungen. **Die Anleitung für den Agenten steht im Skill „Normteile“, nicht in `AGENTS.md`, und der Skill ist bei neuen Modellen an.** Danach sollen Zukaufteile wie NEMA-17-Motoren und V-Slot-Profile folgen | Ergänzt 34 (Rollen) und 46: Ab Werk an sind damit Konstruktionsablauf, Sauber modellieren und Normteile. Auslegung (nicht ausdrücklich bestätigt): Lage über den Auflagepunkt `at` und die Richtung ins Material, `sunk` für versenkte Köpfe, `on=` sucht die Auflage. Nur Normlängen, Sonderlängen ausdrücklich. Normteile sind ohne Angabe `hardware`. Die Tabellen liegen unverändert in `python/soma/data/fasteners/`, der Code ist eigener |-| 49 | Knopf „Markieren“ | **Der Knopf „Markieren“ in der Werkzeugleiste des Viewers ist nicht mehr dauerhaft hervorgehoben**, er sieht aus wie „Messen“ und „Schnitt“ | Weicht vom Entwurf (38) ab: Die orange Fläche dort sah aus wie ein eingeschaltetes Werkzeug und verwirrte. Orange Fläche bleibt dem gedrückten Zustand vorbehalten |-| 50 | Bilder markieren | **Bilder im Dateibaum lassen sich mit dem Markierwerkzeug öffnen**: Das Bild ist der Hintergrund, die Markierung landet wie sonst in `.soma/feedback/` und ihr Pfad in der Eingabe des Agenten | Ergänzt 16. Auslegung (nicht ausdrücklich bestätigt): über den Eintrag „Markieren“ im Kontextmenü, das Original bleibt unverändert, der eingefügte Text nennt das Bild |-| 51 | Markdown-Ansicht | **Markdown-Dateien bekommen eine Ansicht als Dokument und lassen sich bearbeiten** | Auslegung (nicht ausdrücklich bestätigt): im Code-Panel umschaltbar zwischen „Ansicht“ (Standard) und „Bearbeiten“ (Quelltext im Editor), Aufgaben in der Ansicht abhakbar, kein HTML aus der Datei |-| 52 | Klick auf ein Bild | **Klick auf ein Bild im Dateibaum öffnet es immer in SOMA** (Zeichenfläche der Markierung), **nur der Rechtsklick öffnet es im Standardprogramm** | Ersetzt die Auslegung zu 50, nach der nur das Kontextmenü markiert. Ist schon eine Markierung offen, kommt ein Hinweis statt sie zu ersetzen |-| 53 | Von Bild zu Bild | **Beim Wechsel von Bild zu Bild erscheint keine Meldung**, das neue Bild öffnet direkt | Ersetzt den Hinweis aus 52. Auslegung (nicht ausdrücklich bestätigt): Ist schon etwas gezeichnet, fragt ein Dialog „Verwerfen und wechseln“ oder „Abbrechen“, damit keine Zeichnung still verloren geht |-| 55 | Skills: Stufen | **Jeder Skill hat je Modell eine von drei Stufen: Aus, Bei Bedarf (Standard) und Immer.** „Bei Bedarf“ liegt er im Projekt und `AGENTS.md` nennt ihn mit Anlass. Der Agent liest ihn, wenn das Gespräch auf das Thema kommt (etwa „jetzt für den 3D-Druck optimieren“), ohne dass der Nutzer erst umstellt. „Immer“ befolgt der Agent bei jeder Änderung (bisher „an“). „Aus“ sieht der Agent ihn nicht. Dazu: zwei Listen in `AGENTS.md`, in der Kopie eines Skills „Bei Bedarf“ ein Hinweis, dass seine Werte Standardwerte der App sind (nennen oder nachfragen) und dass der Agent in `NOTES.md` festhält, wenn er ihm folgt | Ersetzt das An/Aus aus 17 und den Schalter aus 46 (jetzt eine Stufe für neue Modelle). Namen der Stufen, zwei Listen, Hinweis in der Kopie und Festhalten in `NOTES.md` hat Claude vorgeschlagen, der Nutzer hat sie gutgeheißen. Alte Modelle sind unwichtig (es gibt kaum welche), Widersprüche zwischen Skills ebenso (der Agent liest nur passende). Auslegung (nicht ausdrücklich bestätigt): ab Werk „Immer“ für Konstruktionsablauf, Sauber modellieren und Normteile, alle übrigen „Bei Bedarf“ |-| 56 | Explosionsansicht | **Das Modell lässt sich zur Darstellung auseinanderziehen, per Skript ohne KI, allein aus der Lage der Bauteile.** Erste Stufe: Teile rücken von der Mitte ihrer Gruppe weg, Gruppen gemeinsam, Normteile entlang ihrer Achse aus dem Material heraus. Danach kommt die Demontage-Analyse (in welche Richtung lässt sich ein Teil kollisionsfrei herausziehen) | Vorgezogen aus „Später“. Auslegung (nicht ausdrücklich bestätigt): Schieber 0–100 %, Start bei 50 %, gestrichelte Wege, Referenzen bleiben stehen, Messen setzt das Modell zusammen, nichts wird gespeichert |-| 57 | Explosion entlang einer Achse | **Die Explosion zieht entlang einer Achse auseinander und stapelt die Teile mit gleicher Lücke**, statt jedes Teil schräg von der Mitte wegzuschieben. Ob ein Teil nach oben oder unten geht, entscheidet ein einfacher Strahltest, keine vollständige Demontage-Analyse | Ersetzt die Richtungsregel aus 56. Auslegung (nicht ausdrücklich bestätigt): Richtung „Auto“ aus den Normteilen, sonst aus aufeinanderliegenden Teilen, sonst Z, dazu X/Y/Z wählbar. Das größte Teil bleibt stehen. Gruppen als Block, abschaltbar. Normteile quer zur Achse ziehen entlang ihrer eigenen Achse heraus |-| 58 | Animation, Analyse, Bilder und Videos | **Weitere Fähigkeiten (FEM, CFD, Animation …) kommen als optionale Skills, die App zeigt die Ausgaben. Zuerst allgemeine Analyse und Animation.** Eine Animation ist eine Beschreibung in Python, kein Video: eigene Dateien `animations/*.py`, Bewegungen, Kamerafahrten und Texte des Agenten. Der Nutzer sieht sie in 3D und bekommt vom Agenten MP4-Videos, die die App abspielt. Aus Videos gehen Standbilder mit Zeitstempel und Markierung an den Agenten. Der Agent sieht Ergebnisse als Text und als Bild. Wo möglich Bestehendes, das Agenten kennen (Ablauf wie in manim, Drehachsen wie in CadQuery, glTF, WebVTT, MP4) | Vorschlag aus dem Brainstorming, vom Nutzer so zur Umsetzung gegeben. Kein Ton (WAV war ein Versehen). FEM und CFD später auf demselben Weg (Ergebnis mit Wert je Stelle). Umsetzung und Auslegungen in PLAN.md Abschnitt 10 und 11 |-| 59 | Explosion mit Demontage-Analyse | **Die Explosion zerlegt das Modell so, wie man es auseinanderbauen würde**: Jedes Teil kommt in der Richtung heraus, in der es frei ist, in der Reihenfolge des Auseinanderbaus, und wandert mit dem Teil, an dem es hängt. Teile, die sich gegenseitig sperren, kommen als Baugruppe heraus und werden danach in sich zerlegt. Weiterhin per Skript ohne KI | Ersetzt die Regel aus 57 (eine Achse für alles, Gruppen als Block). Auslegung (nicht ausdrücklich bestätigt): Strahltest auf den Netzen im Viewer mit `three-mesh-bvh`, Kandidaten ±X/±Y/±Z und Achsen der Normteile, Normteile dürfen entlang ihrer Achse durch ihr Gewinde, die Richtungswahl der Karte gilt nur noch als Vorzug |-| 60 | Explosion: schräge Richtungen, Schritt für Schritt | **Teile können auch schräg herauskommen**, entlang der Achsen ihrer Zylinder oder der Normalen ihrer großen Flächen, und **die Explosion lässt sich Schritt für Schritt abspielen**, in der Reihenfolge des Auseinanderbaus, die auch an den Agenten gehen kann | Ergänzt 59 (dort als Schritte B und C vorgeschlagen). Auslegung (nicht ausdrücklich bestätigt): Der Mesher schreibt Normale und Achse in die Flächendaten, eine schräge Richtung nur für das Teil, zu dessen Form sie gehört, höchstens 12 zusätzliche, ein Schritt dauert 0,7 s, der Schieber beendet das Abspielen |-| 61 | Explosion ohne Richtungsknöpfe | **Die Knöpfe Auto/X/Y/Z der Explosion entfallen** | Seit der Demontage-Analyse (59, 60) wirkten sie nur noch als Vorzug bei Gleichstand. Die Vorzugsachse bestimmt die App selbst (Achse der meisten Normteile, sonst die, entlang der Teile aufeinanderliegen, sonst Z) |-| 62 | Oberfläche aufgeräumt (Entwurf 2) | **Entwurf „Aufgeräumt“ umgesetzt** (`design/ui-entwurf-2.html`, vom Nutzer freigegeben). **Bauteile wandern in die Seitenleiste** (Leiste links: Bauteile, Dateien, Skills, eine Ansicht zur Zeit), der Viewer bleibt frei. **Code wird eine eigene Spalte** neben der Seitenleiste, Dateien und Code sind gleichzeitig offen. **Schalter oben rechts** blenden Seitenleiste, Code und Agent unabhängig ein und aus. Im Viewer hat jeder Ort eine Frage: oben links der **Umschalter „Modell ▾“** (was zu sehen ist: Modell, Analysen, Animationen, Videos, neue mit Punkt), oben in der Mitte nur noch **Messen, Schnitt, Explosion, Markieren**, beim Würfel **Einpassen, Standardansicht, Darstellung**, unten links die **Karten**. **Skills als Liste** mit kleinem Stufen-Schalter je Zeile, Beschreibung und Einstellungen in einer **Karte daneben**, Orange nur für „Immer“. **Die Übergabeleiste unter dem Agenten entfällt**, dafür lassen sich Bauteile und Dateien ins Terminal ziehen. Platz für ein späteres **Parameter-Panel** in der Seitenleiste ist vorgesehen | Ersetzt in E38 die schwebende Bauteilkarte, das Ausklappen von Dateien und Code (immer nur eins), die Übergabeleiste und die Werkzeuge Analyse und Animation in der Werkzeugleiste. Kritik des Nutzers: Dateien und Code nicht gleichzeitig, zu viele verschiedene Knöpfe oben, Skill-Menü, Bauteilfenster zu groß, Knöpfe unter der Konsole nutzlos. Auslegungen in PLAN.md Abschnitt 11 |-| 63 | Export mit Dateidialog | **Exportieren fragt nach dem Ziel:** ein Bauteil per Speichern-Dialog in eine Datei, alle Bauteile per Ordnerauswahl (je Bauteil eine Datei). **Die Karte eines angeklickten Bauteils bekommt einen Knopf „Exportieren“.** Die App schreibt nicht mehr nach `exports/` im Projekt | Ergänzt E34 (dort Ausgabe nach `exports/`). `soma export --out` geht für die App in einen leeren Ordner unter Temp, kopiert wird danach. Vorhandene Dateien im Ordner ersetzt die App nur nach Rückfrage, beim Einzelexport fragt der Speichern-Dialog selbst. `soma export` im Terminal schreibt weiter nach `exports/` |-| 64 | Verbesserungen aus Agent-Tests allgemein | **Rückmeldungen aus einem Agent-Test sind Beispiele: Verbessert wird, was in jedem Projekt hilft, ohne neue Begriffe für den Agenten.** Umgesetzt: Analyse rechnet am Grenzwert mit der Netzgenauigkeit, ein Bauteil geht vor einer gleichnamigen Gruppe, Problemstellen mit Größe und Lage, Hinweis auf eine bessere Druckrichtung. `soma anim check` rechnet auf den Dreiecksnetzen, Berührung und Spiel aus dem Modell gelten als gewollt. Lange Befehle zeigen den Fortschritt. Animationen führen das Modell nicht noch einmal aus, `soma anim info` fasst Schleifen zusammen. Normteile haben `rotate()`, `translate()` und `moved()` wie CadQuery-Formen. Eine Regel für Maße (`parts/params.py`). Zwischenergebnisse kommen nicht in Verlauf und ZIP, auch in älteren Projekten. **Zurückgestellt:** gekoppelte Gelenke, Zahnräder, Lager, Federn | Anlass: Agent-Test am Einzylindermotor (2026-10-06), `anim check` lief dort über 25 Minuten. Dazu der Wunsch des Nutzers, das langsame Speichern zu beheben: Ergebnisse von `soma analyze` (bis 70 MB je Auswertung) landeten in Snapshot und ZIP |-| 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 |-| 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 |-| 70 | Changelog und README | **SOMA führt einen Changelog** (`CHANGELOG.md`, Aufbau nach Keep a Changelog, auf Deutsch), jede Version bekommt ein Git-Tag (`v0.1.0` gesetzt). **Die README im Hauptordner ist auf Englisch** und stellt das Projekt vor: Ziel (agentisches Arbeiten in parametrischem CAD ohne überladene Software für Menschen), Bilder, Funktionen, freie Wahl des CLI-Agenten. Schlicht, knapp, ohne Emojis | Wunsch des Nutzers. Ausnahme von der Sprachregel (Doku auf Deutsch) nur für die README, weil sie die Startseite des GitHub-Repos ist. Die Lizenz folgt als eigener Schritt. Die Bilder zeigen das Hotwire-Modell des Nutzers, aufgenommen mit der App |-| 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 |-| 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 |-| 76 | Technische Zeichnungen | **Der Agent zeichnet selbst, soma liefert einen Werkzeugkasten statt automatischer Anordnung oder Bemaßung.** Eine Zeichnung ist eine Python-Datei `drawings/*.py`: Blatt mit Rahmen und Schriftfeld (abschaltbar), Ansichten aus beliebigen Formen (Bauteil, Gruppe, Zusammenbau, eigene CadQuery-Form) mit verdeckten Kanten, Schnitte, Einzelheiten, Maße an Modellpunkten mit gemessenem Wert, dazu freies Zeichnen direkt mit ezdxf. Ausgabe DXF, PDF und **ein** PNG in hoher Auflösung, Ausschnitte schneidet der Agent bei Bedarf selbst zu. `check` meldet nur. **Best Practices kommen in einen optionalen Skill** | Wunsch des Nutzers nach Brainstorming: „nicht zu viel automatisieren. Der Agent muss viel Spielraum haben … notfalls auch Sachen komplett selbst zeichnen“, dazu „auf jeden Fall einen Skill … für Best Practices“ und „ich glaube nicht, dass mehrere Exporte nötig sind“. Der erste Vorschlag (Ansichten und Maße legt soma selbst an) ist damit verworfen. Technik: verdeckte Kanten mit HLR aus OCP, DXF mit ezdxf, PDF und PNG aus derselben DXF über matplotlib, keine neuen Pakete. Umsetzung und Auslegungen in PLAN.md, Abschnitte 10 und 11 |-| 77 | Skill: Parametrische Modelle | **Mitgeliefert wird ein Skill „Parametric models“ (`parametrik.md`), damit Agenten mit `param()` gute parametrische Modelle bauen:** Konstruktionsabsicht zuerst, wenige unabhängige Parameter, alles Übrige abgeleitet, Bereiche, in denen jeder Wert baut, Formelemente, die Änderungen überstehen, Felder im Panel, Prüfung an den Bereichsgrenzen | Wunsch des Nutzers („ein Skill … damit die Agenten möglichst gute parametrische Modelle produzieren, mit der param() Funktion“). Ergänzt 45 und 74. Auslegung (nicht ausdrücklich bestätigt): Kategorie Arbeitsweise, ab Werk „Immer“ (jedes Modell hat Parameter, Regel 7 in `AGENTS.md`), Einstellungen Höchstzahl der Parameter und Umfang der Bereichsprüfung, Prüfung ohne neuen Befehl über eine Kopie des Projekts. Umsetzung in PLAN.md, Abschnitte 10 und 11 |-| 78 | Eigene Skills, Einstellungen | **Ein Einstellungsfenster (der bisher ausgegraute Knopf „Options“ unten in der Leiste) mit der Bibliothek der Skills: Nutzer können Skills ändern und eigene hinzufügen.** | Wunsch des Nutzers („können wir irgendwie einfügen, dass Nutzer ihre eigenen Skills einfügen können?“, „in der Settings Menü, was es noch nicht gibt. Die Option zu geben, Skills zu ändern und neue hinzuzufügen“). Ersetzt in E17 „Eigene Nutzer-Skills später“. Auslegung (nicht ausdrücklich bestätigt): Eigene Skills gelten für die ganze App und liegen in den App-Daten, ein geänderter mitgelieferter Skill ist eine eigene Fassung mit derselben Kennung (die mitgelieferte bleibt und kommt mit „Reset“ zurück), Modelle behalten ihre Kopien. Umsetzung und Auslegungen in PLAN.md, Abschnitte 10 und 11 |-| 79 | Dateiformat .soma | **Modelle werden als `.soma` gespeichert, nicht mehr als `.zip`. Die App öffnet weiter auch ZIP-Dateien. Im Export-Menü gibt es „Everything as ZIP“, das ganze Modell als ZIP** | Wunsch des Nutzers („Die Dateien sollen nicht mehr als .zip gespeichert werden sondern als eine .soma. Die app soll aber immer noch zips öffnen können. Beim Export Menü soll es dann noch die Option geben alles als zip zu exportieren“). Ändert E21 nur in der Endung: Eine `.soma` ist innen dieselbe ZIP mit Arbeitsordner, `.git` und Marker. Auslegungen (nicht ausdrücklich bestätigt) und Umsetzung in PLAN.md, Abschnitte 4, 10 und 11 |-| 80 | DXF-Ansicht | **DXF-Dateien öffnen in SOMA: Ein Klick im Dateibaum zeigt sie als Reiter im Code-Panel, zum Ansehen (zoomen, verschieben, Layer ein- und ausblenden), nicht zum Bearbeiten** | Wunsch des Nutzers („Können wir einen einfachen DXF Viewer einbauen?“). Bisher gab es für DXF nur „Open with default app“. Auslegung (nicht ausdrücklich bestätigt): im Code-Panel neben der PDF-Ansicht statt im Viewer, gezeichnet von ezdxf in Python (dasselbe Zeichenmodul wie für PDF und Bild der technischen Zeichnungen, E76, keine neuen Pakete) statt mit einer JavaScript-Bibliothek, dunkler Grund wie im Modellbereich eines CAD-Programms, „Mark up view“ gibt den sichtbaren Ausschnitt mit seinen Koordinaten an den Agenten. Umsetzung und Auslegungen in PLAN.md, Abschnitte 10 und 11 |-| 81 | Einstellungen: Viewer, Speicher, Info | **Die Einstellungen bekommen neben „Skills“ die Reiter „Viewer“, „Storage“ und „About“.** Viewer: Mausbelegung nach bekannten CAD-Programmen, Zoomrichtung umkehren, perspektivisch oder orthografisch, Darstellung beim Öffnen eines Modells (Kanten, Drahtgitter, Transparent), Nachkommastellen beim Messen. Storage: Größe der App-Daten je Bereich, Ordner öffnen, Vorschau-Cache leeren, Sicherungen nur zeigen. About: Versionen, Komponenten mit Lizenz, gefundene Agenten, Ordner, Systemangaben kopieren. **Für die Skills ändert sich nichts** | Wunsch des Nutzers („Lets expand the settings window“), ausgewählt aus meiner Liste mit sieben Reitern: „Alles in Viewer“, „Alles in Storage“, „Alles in About“. App-weite Standardwerte für Skill-Einstellungen waren zuerst gewünscht und sind wieder verworfen: „bei den skills brauchen wir nix ändern da man ja bei editieren der skills die standard werte ändern kann“ (die Werte im Kopf eines bearbeiteten Skills gelten für neue Modelle). Die übrigen Vorschläge (General, Agent & Terminal, Build & Python) bleiben offen. Auslegungen in PLAN.md, Abschnitte 10 und 11 |-| 82 | Strukturbaum im Viewer, Reiter Analyse und Animation | **Die Bauteile wandern aus der Seitenleiste als Strukturbaum ganz oben links in den Viewer, wie in CATIA: eingeklappt nur der Name des Modells, ohne Hintergrund, aufgeklappt mit Baumstrichen und direkt vor jedem Namen je einem Knopf für Ausblenden und Transparent. Der Baum ist in Modell, Analyse und Animation derselbe. Analysis und Animation werden eigene Reiter, die Leiste zeigt Parameters und Files, dann Analysis und Animation, dann Skills, getrennt durch Striche. Der Reiter Parts und der Umschalter oben links entfallen.** Entwurf in `design/strukturbaum-entwurf.html` | Wunsch des Nutzers nach der Kritik am Ergebnis-Panel der FEM und drei Runden Entwurf („Analyse und Animation kommen in die linke Leiste, dafür verschwindet Modell aus der Leiste und wird links im Viewer angeordnet … eher wie Catia“, „Der Dateibaum soll gar keinen Hintergrund haben, damit er möglichst wenig im Weg ist“, „das ‚Modell‘ oben brauchen wir doch nicht mehr“, „erst die Baumstriche, dann vor dem Namen des Objekts/Gruppe die Knöpfe“), freigegeben mit „gefällt mir“. Ersetzt in E62 die Bauteile in der Seitenleiste und den Umschalter oben links. Zum Entwurf gehört der ruhige Bericht der Analyse (eine Zahl groß, Annahmen je eine Zeile zum Aufklappen, Farbe nur als Statuszeichen). Verworfen aus meinen Entwürfen: ein Kontext-Reiter, der dem Viewer folgt, Rechtsklick auf Körper im Bild, Augen im Bericht, Knöpfe in fester Spalte. Noch nicht umgesetzt. Auslegungen in PLAN.md, Abschnitt 11 |-| 83 | Nutzeranleitung | **Eine Nutzeranleitung in zwei Formen aus einer Quelle: in der App (Knopf „Help“) und als Skill für den Agenten, damit er Fragen zur App beantworten kann.** Kurz und knackig. Die Oberfläche erklären Screenshots mit Nummern an den Elementen, darunter je eine nummerierte Liste. Die Quelle ist Markdown (der Skill `soma-app.md`), nicht HTML, Teile nur für den Agenten stehen zwischen `<!-- agent -->` und `<!-- /agent -->`. Der Agent sieht die Bilder über ihre Pfade an, ASCII-Skizzen und Textbeschreibungen der Oberfläche entfallen | Wunsch des Nutzers („Okay wir brauchen eine Nutzeranleitung. In 2 Formen“, „kurz und Knackig“, „nur eine Quelle aus der der Ageten skill erzeugt wird“). Die Idee des Nutzers war eine HTML mit Abschnitten nur für den Skill, mein Gegenvorschlag Markdown (Skills sind Markdown, die App zeigt Markdown schon an). Dazu der Hinweis „wir können davon ausgehen das der Agent Bilder verstehen kann“ und „Um das GUI zu erklären am besten screenshots benutzen mit Zahlen auf den elementen“, freigegeben mit „Ja klingt gut“. Auslegungen (nicht ausdrücklich bestätigt) und Umsetzung in PLAN.md, Abschnitte 10 und 11 |-| 84 | CalculiX als Rechenwerk der FEM, Kontakt | **Die FEM rechnet künftig mit CalculiX (`ccx`) statt mit dem eigenen Solver. CalculiX wird mitgeliefert, aus den Paketen von conda-forge (mit OpenBLAS, nicht MKL), je Betriebssystem beim Bauen des Installers geholt.** Der Lastfall bleibt in `analyses/*.py`, neue Fähigkeiten (Kontakt, Schrauben, Eigenfrequenzen …) kommen auf diesem Weg dazu | Vorschlag nach der Frage des Nutzers, wie die FEM besser wird (Kontaktflächen), freigegeben mit „finde ich gut“ nach einem Testlauf unter Windows: gleiches Netz und gleiche Lasten, Verschiebungen gleich bis auf 1e-6, bei 10 000 bis 250 000 Unbekannten 2- bis 3-mal schneller als pyamg, bei 440 000 etwa gleich (CalculiX 3 GB Speicher). Windows: 11 Dateien, 53 MB (16 MB gezippt). Auslegung (nicht ausdrücklich bestätigt): Spannungen weiter selbst aus den Verschiebungen rechnen (CalculiX mittelt über Werkstoffgrenzen), eigener Solver als Rückfallweg, wenn `ccx` fehlt oder abbricht. Ersetzt in E65 das eigene Rechenwerk. **Teile, die sich berühren, bleiben standardmäßig verklebt, `soma` nennt sie im Ergebnis samt Fläche. Neue Fähigkeiten kommen als wenige Verben im Lastfall: `study.contact(a, b, friction=)`, später `bolt()` für Normteile mit Vorspannung, `Modes` und `Buckling` als eigene Studien, große Verformung und Plastizität über Hinweise im Ergebnis.** Brainstorming freigegeben mit „okay go“. Ursprünglich als E83 eingetragen, gleichzeitig mit der Nutzeranleitung aus einer anderen Sitzung, deshalb umnummeriert |-| 85 | Kritik eines Agenten | **Aus dem Bericht eines Agenten nach einem längeren Modell werden die Punkte umgesetzt, die jedem Agenten helfen:** pdfplumber in der Basisumgebung für PDFs aus `inputs/`, eine knappe Regel zur Vorderseite (−Y) in `AGENTS.md`, `soma render` mit freier Richtung, Ausblenden, Einpassen und Zoom, Teile in Animationen auch als „Gruppe/Teil“, in Zeichnungen Textbreite vorab, Seite der Hinweislinie und Tabellen ohne feste Spaltenbreiten. Anweisungen bleiben knapp und allgemein, ohne Sonderfälle aus einzelnen Projekten | Wunsch des Nutzers („welche davon wirkliche Probleme sind … um das Arbeiten für alle Agenten zu verbessern“), freigegeben mit „go“. pdfplumber statt PyMuPDF auf Rückfrage: PyMuPDF steht unter AGPL und könnte über einen Import im Modell die Modelle der Nutzer binden (E72), pdfplumber ist MIT und rendert Seiten über pypdfium2 ebenfalls als Bild. Zur Achse: „nicht den grundriss erwähnen … mit solchen sachen verwirren wir nur die agenten und blähen unsere instruktionen nur unnötig auf“. Nicht umgesetzt: die Kamera der Animation (`fit` und `zoom` gibt es schon, nur ein Satz im Skill), der falsche Bildname war ein veralteter Docstring. Umsetzung in PLAN.md, Abschnitt 10 |-| 86 | Reiter Analysis und Animation | **Ein Klick auf den Reiter Analysis oder Animation zeigt die Liste aller Ergebnisse und bringt nichts von selbst ins Bild.** Ein Ergebnis öffnet erst ein Klick in der Liste | Präzisiert E82, dort zeigte der Reiter das zuletzt gezeigte Ergebnis, beim ersten Mal das neueste. Ist schon ein Ergebnis im Bild, zeigt der Reiter dessen Bericht, „‹ Analyses“ führt zur Liste |diff --git a/IDEA.md b/IDEA.mddeleted file mode 100644index 6927c31..0000000--- a/IDEA.md+++ /dev/null@@ -1,93 +0,0 @@-# Ursprungsidee: CAD-IDE mit KI-Agenten--> Stand: 2026-09-29 · Status: Ursprungsidee (Konzeptphase, noch keine Umsetzung)--## 1. Kurzbeschreibung--Ein Desktop-Programm für CAD-Arbeit zusammen mit KI-Agenten. Der Nutzer entwirft 3D-Modelle im Dialog mit einem Coding-Agenten, der Code (z. B. CAD-Skripte) schreibt und ausführt. Das Ergebnis ist ein 3D-Modell (STEP), das direkt im Programm angezeigt, geprüft und per Feedback iterativ verbessert wird.--Technisch ist das Programm im Kern eine **IDE mit integrierter Konsole**, in der der Nutzer den Coding-Agenten seiner Wahl laufen lässt (Claude Code, OpenCode, …). Darum herum liegen CAD-spezifische Werkzeuge und ein Workflow, der sich wie 3D-Modellierung anfühlt, nicht wie Softwareentwicklung.--## 2. CAD-Grundlage: Code-basierte CAD-Frameworks--Die 3D-Modelle entstehen **per Code** mit einem Coding-CAD-Framework. Der Agent schreibt und ändert das Skript, das Skript erzeugt die STEP-Datei, der Viewer zeigt sie an.--Das Framework ist **fest vorgegeben** (kein Wechsel durch den Nutzer). Das vereinfacht Konventionen, `CLAUDE.md`/`AGENTS.md`, Skills und das Mapping zwischen Viewer und Code. **Welches Framework das ist, ist noch offen und muss geprüft werden.** Kandidaten: CadQuery (Favorit, da bereits im Fokus), build123d, OpenSCAD u. a.--## 3. Grundprinzip: Kein eigener Harness--Wir bauen **keinen eigenen Agenten-Harness**, sondern nutzen bestehende (Claude Code, OpenCode, …) in einer eingebetteten Konsole.--**Vorteile**-- Deutlich weniger Entwicklungsaufwand: Agentenlogik, Tool-Use, Kontextverwaltung usw. kommen fertig mit.-- Maximale Flexibilität: Der Nutzer wählt den Agenten, den er kennt, bezahlt oder bevorzugt.-- Wir profitieren automatisch von der Weiterentwicklung der Harnesses.--## 4. Abgrenzung zu einer normalen IDE (z. B. VS Code)--Was macht das Projekt mehr als „VS Code mit Terminal"? Sieben Kernunterschiede:--### 4.1 Workflow: „3D-Modell" statt „Code-Projekt"--- Ein „Projekt" ist eine **einzelne ZIP-Datei**, die frei verschoben, geteilt und archiviert werden kann.-- Beim Neuanlegen wird zunächst in einem **temporären Verzeichnis** gearbeitet, bis der Nutzer das Modell speichert.-- Beim Speichern wird der Projektordner als ZIP abgelegt.-- Beim Öffnen wird **derselbe Temp-Ordner (gleicher Pfad) wiederhergestellt**. Dadurch bleiben Chatverläufe und Konfigurationen der KI-Agenten erhalten – diese werden von den Harnesses meist separat und mit Referenz auf den Arbeitsordner gespeichert.-- Für den Nutzer fühlt es sich an wie „ein 3D-Modell erstellen und speichern", nicht wie „ein Coding-Projekt starten".--### 4.2 Integrierte Agenten-Anweisungen (`CLAUDE.md` / `AGENTS.md`)--- Eine mitgelieferte, von der Software verwaltete Anweisungsdatei erklärt dem Harness, wie er vorgehen soll, welche Möglichkeiten es gibt und welche Konventionen gelten.-- Sie definiert u. a. die **Struktur von Code und Ausgabedateien** – Voraussetzung für viele weitere Funktionen der Software.--### 4.3 Integrierter 3D-Viewer--- Zeigt die **STEP-Datei direkt** an.-- Objekte ein-/ausblenden, Visualisierungsoptionen.-- **Messfunktionen** (Nachmessen am Modell).-- Wenn möglich: **Objekt im Viewer anklicken → zugehörige Codestelle wird im Editor hervorgehoben** (Rückverfolgung Geometrie → Code).-- **Screenshots** des Viewers mit einem Klick speichern und **in diesen Bildern skizzieren/markieren**, um dem Agenten visuell mitzuteilen, was geändert werden soll.--### 4.4 2D-Sketching-Tool--- Freihandzeichnen, geometrische Formen, Text usw.-- Dient als visuelle Kommunikation mit dem Agenten (Skizzen, Anmerkungen, Vorlagen).--### 4.5 Feste Dateistruktur und Namenskonventionen--- Ein fest definiertes Layout im Projekt, damit die Software Inhalte eindeutig zuordnen kann.-- Beispiel: Die Software weiß immer, **welches das Skript** ist und **welche die Haupt-Ausgabedatei** ist.--### 4.6 Skills (weitere Markdown-Dateien)--- Regelwerke für spezifische Anforderungen, z. B. **3D-Druck** und **Toleranzen**.-- Werden nur angewendet, wenn der Nutzer sie für das Modell aktiviert hat.--### 4.7 Integrationen mit gängigen KI-Harnesses (wenn möglich)--- Z. B. markierter Code, Viewer-Auswahl oder Screenshots werden **direkt in den Chat des Agenten übernommen**.-- Ziel: nahtlose Zusammenarbeit zwischen Editor/Viewer/Sketching und dem Agenten.--## 5. Überblick der Bausteine--| Baustein | Zweck |-|---|---|-| Code-Editor | Skripte ansehen und bearbeiten |-| Eingebettete Konsole | Beliebiger Coding-Agent (Claude Code, OpenCode, …) |-| 3D-Viewer (STEP) | Anzeigen, Messen, Ein-/Ausblenden, Auswahl, Screenshots |-| 2D-Sketching | Skizzen und Markierungen als Feedback an den Agenten |-| Projektverwaltung | Temp-Ordner ⇄ ZIP, wiederherstellbarer Arbeitskontext |-| Agenten-Anweisungen | Integrierte `CLAUDE.md`/`AGENTS.md` mit Konventionen |-| Skills | Zuschaltbare Regelwerke (3D-Druck, Toleranzen, …) |-| Harness-Integrationen | Auswahl/Screenshots direkt in den Agenten-Chat |--## 6. Offene Punkte für die nächste Phase--Nicht Teil der Ursprungsidee, aber absehbar zu klären:--- Technologiewahl (Desktop-Framework, Terminal-Einbettung, Editor-Komponente, 3D-Kernel/Viewer für STEP).-- **Framework-Evaluation:** Welches Coding-CAD-Framework wird das feste Framework (CadQuery, build123d, OpenSCAD, …)? Mögliche Kriterien: Qualität des Agenten-generierten Codes, STEP-Export, Möglichkeit zur Zuordnung Geometrie ⇄ Code (Namen/Labels/Assemblies), Reife und Community, Lizenz, Verteilbarkeit mit der Software (Python-Einbettung), Performance.-- Mapping Geometrie ⇄ Code (wie werden Objekte im STEP identifizierbar mit Codestellen verknüpft?).-- Konkrete Ordnerstruktur und Namenskonventionen im Projekt.-- Wie stabil und portabel ist die Wiederherstellung des Temp-Pfads (Pfadabhängigkeit der Agenten-Chatverläufe)?-- Schnittstellen der einzelnen Harnesses für Integrationen (Kontext einfügen, Bilder übergeben).diff --git a/PLAN.md b/PLAN.mddeleted file mode 100644index bd5569f..0000000--- a/PLAN.md+++ /dev/null@@ -1,737 +0,0 @@-# Plan: SOMA (CAD mit KI-Agenten)--> Stand: 2026-09-30 · Status: **Phase 0 abgeschlossen** ([Ergebnisse](docs/phase0-ergebnisse.md)), **Phase 1 läuft** (Schritte 1 bis 5 erledigt, Messen vorgezogen, siehe Abschnitt 10 und [app/README.md](app/README.md))-> Ursprung: [IDEA.md](IDEA.md) · Begründungen und Historie: [DECISIONS.md](DECISIONS.md)-> Zahlen in Klammern, z. B. (E12), verweisen auf Entscheidungen im Log.--## 1. Vision--Eine Desktop-App, in der ein Nutzer zusammen mit einem KI-Coding-Agenten seiner Wahl (Claude Code, OpenCode, …) 3D-Modelle entwirft. Technisch ist sie eine IDE mit Terminal, Editor und einem eingebauten 3D-Viewer. Sie fühlt sich aber an wie „ein 3D-Modell erstellen und speichern", nicht wie „ein Coding-Projekt starten". Ein Modell ist eine ZIP-Datei, die man frei verschieben kann.--**Abgrenzung zu VS Code:** Modell-Workflow (ZIP, Versions-Schieber), integrierter STEP-Viewer mit Klick auf Code, Screenshot mit Markup als Rückmeldung an den Agenten, feste Projektstruktur, Skills für 3D-Druck und Toleranzen.--**Zielgruppe:** Nicht-Programmierer, die einen eigenen CLI-Agenten mitbringen (E3, E4). **Ziel:** Open Source (E30). **Plattformen:** Windows, macOS, Linux von Anfang an (E2).--## 2. Grundsätze--1. **Kein eigener Harness** (E29). Agenten, Berechtigungen und Schutz vor dem Agenten liegen bei Nutzer und Agent, nicht bei uns. Keine Sandbox.-2. **Agentenunabhängig.** Wir setzen nur auf Dateien, Text und Kommandozeile, nicht auf Eigenheiten einzelner Agenten. Tiefere Integration (MCP) kommt später (E11).-3. **Der Code ist die Wahrheit.** Änderungen am Modell laufen über das Skript. Die App schreibt den Modellcode nicht selbst, sondern übergibt Aufträge an den Agenten (E11, E34).-4. **Eine getestete Umgebung.** Python, CadQuery und Git werden mitgeliefert, kein Bring-your-own (E31, E32).-5. **Robust gegen Abweichungen des Agenten**, siehe Abschnitt 9. Dieser Grundsatz gilt für alle anderen.--## 3. Architektur--```-+---------------------- Electron-App (TypeScript) ----------------------+-| Oberfläche: Panels (Dateien, Code) | 3D-Viewer / Sketch | Agent-Tabs |-| Hauptprozess: Projekte, ZIP, Git, Dateiüberwachung, Prozessverwaltung |-+-----------+-------------------------------+---------------------------+- | |- Terminals (xterm.js + node-pty) Python-Dienst pro Projekt (langlebig)- Shell im Projektordner, Modell im Speicher, Build, Mesher,- Projektumgebung im PATH, Messungen (OCP/OpenCascade)- mitgeliefertes git |- | |- CLI-Agent (Claude Code, …) Paket `soma` (Basisumgebung)- nutzt `soma build|check|export` Hilfsbibliothek + CLI-```--- **Desktop:** Electron, TypeScript (E23). Editor: CodeMirror 6 (Phase 1, Schritt 5).-- **Python-Dienst:** Pro Projekt ein langlebiger Prozess für die App (schnelle Messungen, Modell im Speicher). Der Build-Befehl des Agenten läuft zusätzlich als eigenständiger Einmal-Prozess und funktioniert auch ohne App (E24). **Umgesetzt für das Messen** (`soma serve`), gebaut wird weiter im Einmal-Prozess. Damit der Start von Python und der Import von cadquery (rund 3 bis 4 s) nicht bei jedem Build anfallen, hält die App einen vorgewärmten `soma warm` bereit, einen für die ganze App und schon ab dem Start (E66). Was er tun soll (Build, Vorschau eines alten Standes, Export, Animation, Auswertung), erfährt er erst mit einer Auftragszeile. Jeder Auftrag bleibt ein frischer Prozess, ein warmer Build dauert rund 0,5 s statt 4 bis 5 s.-- **CAD-Framework:** **CadQuery**, fest (E12). OpenSCAD ist ausgeschlossen (kein STEP, kein B-Rep).-- **Viewer:** three.js zeigt ein GLB, das nach jedem Build aus der STEP-Datei erzeugt wird (Bauteilnamen, Farben, Flächen- und Kanten-IDs). Exakte Messwerte (Radius, Flächenabstand) fragt die App beim Python-Dienst ab. Es gibt keinen zweiten CAD-Kern im Frontend (E9).--## 4. Projektformat--**Ein Projekt ist eine `.soma`-Datei** (innen eine ZIP, bis E79 hieß sie auch so, ältere `.zip` öffnet die App weiter). Die App arbeitet in einem Arbeitsordner (E21):--- Jedes Projekt hat eine feste **UUID**. Der Arbeitsordner liegt immer unter `<App-Daten>/workspaces/<uuid>/`, nicht im OS-Temp.-- Neue Projekte starten im Arbeitsordner ohne ZIP, bis der Nutzer zum ersten Mal speichert.-- **Speichern nur ausdrücklich**, kein Autosave in die ZIP. Dazu Absturz-Wiederherstellung.-- **Öffnen:** Existiert der Arbeitsordner nicht, wird die ZIP entpackt. Existiert er mit ungespeicherten Änderungen oder Abweichungen, **fragt die App nach** (wiederherstellen oder ZIP laden).-- Der stabile Pfad hält die **Agenten-Chats auf demselben Rechner** erhalten. Auf einem anderen Rechner gehen sie verloren, das ist bewusst akzeptiert (E5).--**Ordnerstruktur (E26)**--```-<projekt>/-├── AGENTS.md app-verwaltet: Regeln, Konventionen, Skill-Liste, Git-Regeln, Befehle-├── 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-├── output/-│ └── 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 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-│ ├── feedback/ Screenshots und Skizzen (nicht in Git)-│ ├── anim/, results/ gebaute Animationen und Ergebnisse von soma analyze (nicht in Git, E58)-│ ├── env/ Projektumgebung für Zusatzpakete (nicht in Git und ZIP, E67)-│ ├── model.map.json und GLB-Cache (nicht in Git)-└── .git/ .gitignore-```--Einfacher Fall: alles steht in `model.py`. Bei wachsender Komplexität lagert der Agent Bauteile nach `parts/` aus (E6).--**Git (E7, E8, E35)**--- 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`, `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.--**Projektzustand (E27):** ID und Einstellungen liegen doppelt: in `.soma/project.json` (ZIP) und als Kopie in den App-Daten. Bei Verlust dient die jeweils andere Quelle als Rückfall.--## 5. Hilfsbibliothek und Befehle (`soma`)--Das Paket `soma` liegt in der mitgelieferten **Basisumgebung**, nicht im Projekt. Neue App-Versionen bringen es mit, alte Projekte profitieren von Fixes. `api_version` in `project.json` sichert die Abwärtskompatibilität (E36). Paket und Befehl heißen `soma` (E43).--| 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) |-| `soma export <Bauteil\|--all> --format …` | Einzelexport auf Basis der registrierten Bauteile, auch per Kontextmenü im Tree. Formate (in Phase 0 geprüft): STEP, STL, 3MF, AMF, BREP, IGES, OBJ, VRML, GLB/GLTF. 2D: DXF (Schnitt), SVG (Projektion) (E34) |-| `soma.anim` | Animationen in `animations/*.py` (E58): `Animation("Name")`, Gelenke `hinge`, `slider`, `part`, Zeitleiste `play`, `wait`, `title`, Kamera `set`, `move`, `orbit`, `zoom`, Texte `caption`, `label`, Zustände `highlight`, `hide`, `show`, `ghost` |-| `soma anim build \| list \| info \| check` | Animationen bauen (glTF nach `.soma/anim/`), auflisten, als Text beschreiben, auf Überschneidung und Mindestabstand prüfen (E58) |-| `soma analyze overhang \| thickness \| clearance` | Wert an jeder Stelle der Oberfläche, Zusammenfassung je Bauteil, Ergebnis nach `.soma/results/` (E58) |-| `soma analyze fem analyses/<x>.py` | Festigkeit mit FEM: Lastfall als Python-Datei, Sicherheit, Spannung und Verschiebung je Stelle, Ergebnis nach `.soma/results/` (E65) |-| `soma render` | Bild, Übersicht oder Video über die App nach `renders/` (E58). Nur in den Terminals der App |-| `soma drawing build \| list \| info` | Technische Zeichnungen aus `drawings/*.py` (`soma.drawing`) als PDF und DXF nach `output/drawings/`, dazu ein Bild zum Prüfen, Hinweise der Prüfung mit Zeile (E76) |--**Bauen (E20):** Auto-Build bei Änderung von `model.py` und `parts/` (Hintergrund, Debounce, abbrechbar). Er ist **abschaltbar**, weil große Modelle sonst die App bremsen. Dann baut der Nutzer per Knopf oder der Agent per Befehl.--**Pakete (E25, E67):** Zusatzpakete sind der Sonderfall. Die Basisumgebung bleibt unverändert. Jedes Projekt hat eine eigene kleine Umgebung im Arbeitsordner (`.soma/env`, nicht in der ZIP), die die Basis mitbenutzt. Der Agent tippt nur `pip install <paket>`, die Terminals leiten pip dorthin. `soma build` trägt die Pakete, die das Modell importiert, in `requirements.txt` ein. Auf einem anderen Rechner installiert die App sie vor dem ersten Build. Umsetzung in Abschnitt 10.--## 6. Agenten-Anbindung--- **Terminal (E19):** Freies Terminal mit mehreren Tabs im Projektordner. Startbuttons für erkannte Agenten. Der zuletzt benutzte Agent startet beim Öffnen automatisch, **ohne Resume**. Der Nutzer installiert den Agenten selbst, die App hilft mit Erkennung und Hinweisen (E4).-- **`AGENTS.md` (E18):** Ganz app-verwaltet, Notizen stehen getrennt in `NOTES.md`. Beim Öffnen eines Projekts mit älterer Regelversion wird sie erneuert, dem Nutzer angezeigt und als Commit gesichert (E36). Der Verweis auf die Notizen steht ganz oben.-- **Skills (E17, E55):** Markdown-Regeln (z. B. 3D-Druck, Toleranzen, CNC-Fräsen), je Modell in drei Stufen: Aus, Bei Bedarf (der Agent liest sie, wenn das Thema aufkommt) und Immer. Eingeschaltete Skills liegen in `.soma/skills/` und stehen mit vollem Pfad in `AGENTS.md`, „Bei Bedarf“ mit Anlass. Mitgelieferte und eigene des Nutzers, angelegt und geändert in den Einstellungen (E78).-- **Rückmeldung an den Agenten (E11):** Markierungen (Viewer-Bild oder leere Fläche mit Zeichnung) landen als PNG in `.soma/feedback/`, Auswahlen (Bauteilname, Datei, Zeilen, Fläche) und Build-Fehler gehen als Text. Die App fügt Pfad oder Text in die Eingabezeile des Terminals ein, der Nutzer schickt selbst ab. Später kommt ein MCP-Server der App dazu.-- **Bilder und Videos für den Agenten (E58):** `soma render` schickt den Auftrag über eine lokale Verbindung an die App (HTTP nur auf 127.0.0.1, freier Port, Schlüssel je App-Start, beides als `SOMA_APP` und `SOMA_APP_TOKEN` in den Terminals der App). Ein unsichtbares Fenster rendert mit demselben Viewer, der Agent öffnet die PNG-Dateien. Videos kann er nicht ansehen, zu jedem Video entsteht deshalb eine Übersicht mit Standbildern und Zeiten. Dieselbe Verbindung kann später den MCP-Server tragen.--## 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 (*Parameter* (E74) und *Dateien*, dann *Analyse* und *Animation*, dann *Skills*, getrennt durch Striche, eine Ansicht zur Zeit, E82), 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 **Strukturbaum** (E82, die Bauteile, eingeklappt nur der Name des Modells), 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), unten in der Mitte bei einer Analyse oder Animation deren **Leiste** mit dem × zurück zum Modell. „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):**--| Phase | Funktionen |-|---|---|-| **Phase 1 (MVP)** | Navigation, Standardansichten, Darstellungsmodi (schattiert, Kanten, Drahtgitter, Transparenz), Ein-/Ausblenden über den Tree, Klick auf Bauteil → Codezeile, **Screenshot mit Markup** |-| **Danach** | Messen (Punkt-zu-Punkt, Bounding-Box, exakte Werte, **umgesetzt**), Schnittansicht (wichtig für Gehäuse, **umgesetzt**), Versions-Schieber (umgesetzt in Schritt 2), Explosionsansicht (mit Demontage-Analyse **umgesetzt**, E56, E57, E59) |-| **Später** | Volumen/Gewicht, Versionsvergleich |--Der Viewer zeigt auch **beliebige weitere STEP-Dateien** im Basismodus, ohne Mapping und Zusatzfunktionen. Standardanzeige ist immer das Hauptmodell.--**2D-Sketching (E16):** Nur Bild-Markup ohne Maßhaltigkeit auf Viewer-Screenshots und leerer Fläche (Freihand, Formen, Pfeile, Text). Ergebnis ist ein PNG. Kein Constraint-Sketcher. Umgesetzt in Phase 1, Schritt 4 (Abschnitt 10).--**Animation, Analyse und Video (E58, E62, E82):** Ergebnisse des Agenten, gewählt in den Reitern Analysis und Animation, Videos spielen über dem Viewer. Umgesetzt, siehe Abschnitt 10.--**Strukturbaum und Reiter (E82, Entwurf in [design/strukturbaum-entwurf.html](design/strukturbaum-entwurf.html), umgesetzt, siehe Abschnitt 10):** Die Leiste zeigt Parameters und Files, dann Analysis und Animation, dann Skills, getrennt durch Striche. Der Reiter Bauteile und der Umschalter oben links entfallen. Die Bauteile stehen als Strukturbaum ohne Hintergrund ganz oben links im Viewer, eingeklappt nur der Name des Modells, aufgeklappt mit Baumstrichen und direkt vor jedem Namen Auge (ausblenden) und Halbkreis (transparent). Derselbe Baum gilt in Modell, Analyse und Animation. Die Reiter Analysis und Animation zeigen Liste und Bericht, das × rechts in der Leiste unten im Bild führt zurück zum Modell.--**Dateien im Code-Panel:** Python und Text im Editor, Markdown als Dokument (E51), PDF (E54) und DXF (E80) in eigenen Ansichten nur zum Lesen. Bilder öffnen auf der Zeichenfläche der Markierung (E52), Videos über dem Viewer.--## 8. Umgebung, Auslieferung, Lizenz--- **Eine Variante „alles drin"** mit mitgeliefertem Python, CadQuery und Git (E31, E32). Kein Bring-your-own.-- **Lizenz:** GPL-3.0 oder später (E71, Text in `LICENSE`, auch in `app/package.json` und `python/pyproject.toml`). Modelle der Nutzer sind davon frei: zusätzliche Erlaubnis nach Abschnitt 7 der GPL in `MODEL-EXCEPTION.md` (E72). Lizenzen aller mitgelieferten Komponenten sind zu prüfen und dem Installer beizulegen (E30).-- **Auslieferung:** Installer für drei Betriebssysteme, Code-Signing und Auto-Update der App sind noch zu klären.--## 9. Robustheit gegen Abweichungen des Agenten--Agenten befolgen `AGENTS.md` nicht zuverlässig. Sie können Dateien verschieben oder löschen, eigene Umgebungen (z. B. `.venv`) anlegen, `AGENTS.md` ändern, Git umbauen oder an der App vorbei arbeiten. **Die App darf dadurch nicht kaputtgehen.**--**Regeln (Entwurf, noch nicht ausdrücklich bestätigt)**--1. **Der Arbeitsordner ist nicht vertrauenswürdig.** `AGENTS.md` ist eine Bitte, keine Garantie.-2. **Jede Konvention braucht einen Rückfallweg.** Ohne Hilfsbibliothek zeigt der Viewer trotzdem die STEP-Datei, ohne Klick→Code.-3. **Erkennen und erklären statt abstürzen.** Der **Projekt-Check** läuft beim Öffnen, Bauen und Speichern. Keine automatischen Reparaturen, kein Reparieren-Button (E28).-4. **App-kritischer Zustand ist aus einer zweiten Quelle wiederherstellbar** (E27).-5. **Nichts wird stillschweigend überschrieben oder zerstört.** Wo die App doch eingreift, gibt es vorher Backup oder Git-Stand und einen Hinweis.--**Störfälle** (Reaktionen sind Richtungen, keine fertigen Spezifikationen)--| Störfall | Mögliche Folge | Richtung |-|---|---|---|-| `model.py` fehlt, umbenannt oder verschoben | Kein Build | Einstiegspunkt in `project.json` wählbar, Hinweis |-| Agent exportiert selbst oder ohne Hilfsbibliothek | Kein Mapping/GLB | STEP-Fallback im Viewer, Hinweis |-| Mehrere oder anders benannte STEP-Dateien | Unklar, was angezeigt wird | Hauptausgabe in `project.json`, sonst Auswahlliste |-| Agent legt `.venv` an und installiert dort | Build findet Pakete nicht, `.venv` landet in ZIP/Git | **Umgesetzt:** `.venv`/`venv`/`env` nie in ZIP, Dateibaum und Watcher, der Projekt-Check meldet sie. `AGENTS.md` verbietet sie (E67) |-| Agent nutzt anderes Python oder `pip --user` | Paketliste unvollständig | **Umgesetzt (E67):** Jedes `pip` im Terminal installiert über `PIP_PYTHON` in die Projektumgebung, `--user` lehnt pip dort ab. Ein Python mit vollem Pfad am Terminal vorbei bleibt möglich, der Build scheitert dann am Import |-| Agent will ein Paket, das eine andere Version eines Basispakets braucht (z. B. `numpy<2`) | CadQuery oder OCP liefen nicht mehr | **Umgesetzt (E67):** Die Versionen der Basis sind in der `pip.ini` der Projektumgebung festgelegt, pip lehnt mit klarer Meldung ab |-| `AGENTS.md` verändert oder gelöscht | Regeln fehlen | Prüfsumme, im Check melden. Erneuerung nur beim Versions-Update (E36) |-| `.soma/` oder `project.json` gelöscht | ID und Einstellungen weg | Aus App-Daten bzw. ZIP wiederherstellen (siehe offene Punkte) |-| `.git` gelöscht, neu initialisiert, History umgeschrieben, anderer Branch | Zeitleiste kaputt | Zeitleiste tolerant aus `git log`, Bruch im Check melden |-| Agent committet nie oder zu oft, riesige Dateien | Leerer Schieber, große ZIP | Auto-Snapshot, Größenwarnung |-| `inputs/` verändert | Mitgebrachte Datei verfälscht | Git-Stand, Hinweis |-| Build hängt oder dauert endlos | App blockiert | Timeout, Abbrechen, Dienst neu starten |-| Agent arbeitet außerhalb des Projektordners | Ergebnisse fehlen in der ZIP | Nicht verhinderbar, wo möglich erkennen |-| Agent ändert eine Datei, die der Nutzer gerade im Editor bearbeitet | Eine der beiden Fassungen ginge verloren | **Umgesetzt:** nichts überschreiben, Hinweis im Editor, der Nutzer wählt, die andere Fassung kommt in eine Sicherung |-| Python-Dienst stürzt ab | Viewer/Messen tot | Automatischer Neustart, Meldung |--## 10. Phasen--**Phase 0: technischer Prototyp ohne App (E13, E14). Abgeschlossen**, alle Punkte bestanden. Details und Zahlen in [phase0-ergebnisse.md](docs/phase0-ergebnisse.md), Code und Tests im Git-Verlauf (zuletzt im Tag `v0.5.0` unter `prototype/phase0/`):--1. **STEP mit Namen und Farben:** `cq.Assembly.export` genügt, kein eigener XCAF-Export nötig. Nicht-ASCII-Namen werden beim Export zerstört, daher ASCII-Namen in der STEP.-2. **GLB mit Flächen-IDs:** eigener Mesher (rund 150 Zeilen), alle IDs gegen OCC verifiziert. Die IDs gelten nur für einen Build. Der Python-Anteil ist nicht der Engpass, das Meshen in OCC ist es.-3. **Klick → Datei und Zeile:** in echtem Browser bestanden, auf Ebene von Bauteil und Fläche. Verknüpft wird der `add_part`-Aufruf mit Zeilenbereich.-4. **Fremd-STEP, Messen, Aussparung, Referenz:** bestanden, Abstände und Radien exakt über die IDs. Der Basismodus für fremde STEP-Dateien funktioniert. Getestet nur mit synthetischer Platine.-5. **Umgebung:** VTK lässt sich nicht entfernen (OCP hängt hart daran). Installiert 0,76 bis 1,04 GB, vorerst hingenommen (E37).-6. **Exportformate:** 12 Formate, PLY und X_T entfallen.--**Phase 1: MVP-Kern als Desktop-App. In Arbeit.** Projekt neu, speichern und öffnen als ZIP mit Git. Editor, Terminal mit Agent, Viewer (Umfang siehe Abschnitt 7), Screenshot mit Markup, `AGENTS.md`, `soma build`. Hier folgt auch der **Agent-Test**: Ein Agent baut mit erster `AGENTS.md` und Hilfsbibliothek ein Beispielmodell, geprüft wird u. a., ob er den Verweisen folgt.--*Schritt 1, lauffähiges Gerüst (erledigt, Ende-zu-Ende-Test mit 21 Prüfungen in `app/test/smoke.mjs`):*--- **App:** Electron und TypeScript, Layout aus Abschnitt 7 (Tree mit Reitern *Modell* und *Dateien*, Viewer, Terminal-Tabs, Top Bar, Statusleiste, verschiebbare Trennleisten). Arbeitsordner unter `<App-Daten>/workspaces/<uuid>/`, Projektzustand doppelt (E27), Projekt-Check meldet nur (E28).-- **`soma` (Python-Paket in `python/`):** `add_part` mit Datei und Zeilenbereich, `soma build` (STEP, GLB, Mapping, `build.json`), `soma export` (12 Formate). Fehler in `model.py` (Syntax, Laufzeit, doppelter Name, kein Bauteil, Einstiegspunkt fehlt) kommen mit Datei, Zeile und gekürztem Traceback zurück, der letzte gute Stand bleibt sichtbar.-- **Build (E20):** Auto-Build beim Speichern, entprellt, abschaltbar. Änderungen während eines Builds führen zu genau einem Folgebuild. Zeitlimit und Abbruch sind eingebaut.-- **Viewer:** Klick liefert Bauteil, Fläche und markierte Codezeile. Ein- und Ausblenden, Standardansichten, Kanten, Drahtgitter, Transparenz. Kamera, Sichtbarkeit und Auswahl bleiben über Rebuilds erhalten.-- **Terminal:** Echte Shell (node-pty) im Projektordner mit `python`, `pip` und `soma` der Basisumgebung im PATH. Startbuttons für erkannte Agenten (Claude Code, OpenCode, Codex, Gemini CLI).-- **Vorlage:** `model.py`, erste `AGENTS.md`, `CLAUDE.md` (Verweis), `NOTES.md`, `.gitignore`.--*Erster Agent-Test (informell, vom Nutzer):* Claude Code hat mit dieser Vorlage eine Wanduhr gebaut, 6 Bauteile mit deutschen Namen, Parameter als Konstanten, kein `.venv`, `AGENTS.md`, `CLAUDE.md`, `NOTES.md` und `.gitignore` unverändert. Das ist ein Datenpunkt, kein vollständiger Agent-Test. Damals gab es noch kein Git.--*Zweiter Agent-Test (informell, vom Nutzer, nach Schritt 2):* Claude Code hat nach dem Build **selbst committet**, mit deutscher Nachricht („Vereinfachte Wanduhr: Gehäuse, Zifferblatt, …“), `model.py` und `output/model.step` im selben Commit, der Verlauf blieb unangetastet. Auch das ist eine einzelne Iteration mit einem Agenten. Ungeprüft sind lange Sitzungen und andere Agenten (OpenCode, Codex, Gemini CLI).--*Schritt 2, Git und ZIP (erledigt, 46 Prüfungen in `app/test/versions.mjs`):*--- **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, 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.--*Schritt 3, Oberfläche nach Entwurf (erledigt, E38; 31 Prüfungen im Smoke-Test, 50 im Verlaufstest, 4 Einheitentests in `app/test/unit.mjs`):*--- **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 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, die Kopien der Skills aus `.soma/skills/` eingeklappt als Gruppe „Skills“ (nur zum Lesen). Der Rest von `.soma/` bleibt verborgen. Code-Panel zum Lesen mit Hervorhebung, der Auswahl im Viewer folgend.-- **Verlauf:** Punkte unterscheiden Stände der App (Commit-Trailer `Created-by: SOMA`, bis E73 `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** 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):*--- **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, 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.-- **Bilder aus dem Projekt markieren (E50):** Klick auf ein Bild im Dateibaum (PNG, JPG, GIF, WebP, BMP, SVG) oder Rechtsklick „Markieren“ (E52). Ein Klick auf ein anderes Bild wechselt direkt. Nur wenn schon etwas gezeichnet ist, fragt die App, ob die Zeichnung verworfen werden soll. Das Bild wird unverzerrt in die Zeichenfläche eingepasst und behält seine Auflösung (Fläche im Seitenverhältnis des Viewers, höchstens 8192 px Kantenlänge). Das Ergebnis ist eine neue Datei in `.soma/feedback/`, das Original bleibt. Eingefügt wird `[Markierung: <Pfad>, gezeichnet auf <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.-- **Git und ZIP:** Markierungen sind nicht in Git (E11) und zählen nicht als ungespeicherte Änderung, wandern aber beim nächsten Speichern mit der ZIP.--*Agent-Test Markierung (informell, vom Nutzer):* Mit `[Markierung: …]` in der Eingabe hat Claude Code das Bild geöffnet und umgesetzt.--*Schritt 5, Editor (erledigt, E39, E40; 29 Prüfungen in `app/test/editor.mjs`, 15 Einheitentests):*--- **Editor im Code-Panel:** CodeMirror 6 mit Zeilennummern, Python-Hervorhebung in den Farben der Codeausschnitte (Konstanten wie `LENGTH` eigens), Klammern, Einrückung mit 4 Leerzeichen, Suchen und Ersetzen (Strg+F, deutsch beschriftet), Rückgängig je Datei. Die Auswahl im Viewer markiert die Zeilen des `add_part`-Aufrufs, die Fehlerkarte die Fehlerzeile in Rot. Während getippt wird, springt der Editor nicht, nur die Markierung wandert mit.-- **Markdown als Dokument (E51):** `.md`-Dateien öffnen als gerendertes Dokument (Überschriften, Listen, Aufgaben, Tabellen, Code, Zitate, Bilder aus dem Projekt). Der Umschalter „Ansicht / Bearbeiten“ im Kopf wechselt in den Editor (mit Markdown-Hervorhebung und Zeilenumbruch), Doppelklick auf einen Absatz springt im Editor an diese Zeile. Die Ansicht zeigt auch ungespeicherte Eingaben, Aufgaben lassen sich direkt abhaken (ändert den Text, gespeichert wird wie sonst mit Strg+S). Links auf Dateien öffnen sie wie ein Klick im Dateibaum, Web-Adressen im Browser.-- **Speichern nur auf Wunsch (E39):** Beim Tippen passiert nichts auf der Platte und es wird nicht gebaut. Der Reiter zeigt einen Punkt, die Infozeile „Nicht gespeichert · Strg+S“ und den Knopf „Speichern und bauen“, der Speicherstand oben zählt die Eingaben mit. Strg+S im Editor und der Knopf schreiben die Dateien (erst in eine Nebendatei, dann umbenennen) und bauen **genau einmal**, aber nur, wenn eine gespeicherte Datei das Modell betrifft (E40: Python und `inputs/`, dieselbe Regel wie die Dateiüberwachung in `src/shared/editable.ts`). Bei `NOTES.md` heißt der Knopf nur „Speichern“. Die Dateiüberwachung erkennt, dass die Änderung schon im laufenden Build steckt, und baut nicht noch einmal. „Speichern“ oben (und Strg+S außerhalb des Editors) speichert zuerst den Editor, dann Snapshot und ZIP. „Jetzt bauen“ speichert ebenfalls vorher.-- **Rückfragen statt Verlust:** Vor Modellwechsel, Wiederherstellen, Schließen eines Reiters und Beenden fragt die App bei ungespeicherten Eingaben: Speichern, Verwerfen (die Eingabe kommt vorher in eine Sicherung) oder Abbrechen. Beim Beenden ist das eine gemeinsame Frage mit der nach der ZIP. Jede Schreibanfrage trägt die ID des Modells, eine verspätete für ein altes Modell wird als Sicherung abgelegt statt ins neue geschrieben.-- **Agent und Nutzer an derselben Datei:** Der Editor kennt den Stand, den er zuletzt von der Platte hatte. Ändert der Agent die Datei und im Editor liegt nichts Ungesichertes, übernimmt der Editor die neue Fassung (nur den geänderten Teil, Schreibmarke bleibt, nicht im Rückgängig). Liegt etwas Ungesichertes da, wird nichts überschrieben: Ein Hinweis bietet „Meine Fassung behalten“ oder „Fassung von außen laden“, die jeweils andere Fassung kommt nach `workspace-backups/<id>-editor/`. Gelöschte Dateien lassen sich mit der eigenen Fassung neu anlegen. Beim Beenden mit offenem Konflikt sichert die App die eigene Fassung und nennt den Pfad.-- **Nur lesen:** `AGENTS.md`, `CLAUDE.md`, `.gitignore`, `output/`, `exports/`, `.soma/`, `.git/` (Regel in `src/shared/editable.ts`, der Hauptprozess prüft sie beim Schreiben noch einmal), dazu Dateien über 2 MB und solche, die nicht als UTF-8 lesbar sind. Der Grund steht über dem Text.-- **Zeilenenden** der Datei bleiben erhalten (CRLF bleibt CRLF).-- **Höhe:** Der Editor füllt das Panel bis unten und lässt sich bei langen Dateien bis zum Ende scrollen (CodeMirror erzwingt `position: relative`, die Höhe kommt deshalb über `height`).-- **Nebenbei:** Die App nutzt jetzt das dunkle Farbschema des Systems (`color-scheme: dark`), Scrollleisten sind dunkel. Im schmalen Viewer (etwa bei offenem Code-Panel) rückt die Fehlerkarte nach unten, statt über den Rand zu ragen. Behoben: Der Speicherstand oben konnte nach dem Speichern fälschlich „Noch nicht gespeichert“ zeigen, wenn die regelmäßige Git-Abfrage gerade lief (sie las den Stand der App vor ihren Git-Aufrufen).--*Messen (vorgezogen aus „Danach“, E9, E22, E24; 23 Prüfungen in `app/test/measure.mjs`):*--- **Ablauf:** „Messen“ im Viewer schaltet den Messmodus. Ein Klick wählt einen Eckpunkt, eine Kante oder eine Fläche, in dieser Reihenfolge (Punkte mit 9 px Fangradius, Kanten mit 7 px, Verdecktes zählt nicht), und zeigt die exakten Werte: Lage eines Punkts, Durchmesser und Radius (Zylinder, Kreis, Kugel), Achse oder Normale, Länge, Flächeninhalt, dazu die Außenmaße des Bauteils. Ein zweiter Klick misst zum ersten: Abstand paralleler Ebenen (Wandstärke, Spaltmaß), Abstand der Achsen oder Mittelpunkte (Bohrungen), vom Punkt aus den Abstand zur Ebene, Achse oder Geraden, zwischen zwei Punkten ihren Abstand, sonst den kürzesten Abstand, dazu Punkt zu Punkt mit ΔX/ΔY/ΔZ und den Winkel. Punkte kamen auf Wunsch des Nutzers dazu, der Mesher legt dafür eine Tabelle der Eckpunkte mit exakten Koordinaten ins GLB. Der dritte Klick beginnt von vorn, Escape verwirft erst die Messung, dann den Modus.-- **Anzeige:** Elemente in Orange hervorgehoben, unter dem Zeiger leicht aufgehellt, die Hauptstrecke als Linie mit Beschriftung, Punkt zu Punkt gestrichelt. Die Karte unten links ersetzt solange die Auswahlkarte. „An Agent geben“ fügt die Messung als Text ein (Zahlen mit Punkt, drei Stellen).-- **Exakt gerechnet:** Der Build legt die Bauteile zusätzlich als BREP unter `.soma/geometry/<build>.brep` ab, die Kennung steht auch in `model.map.json`. Ein langlebiger Python-Dienst (`soma serve`, JSON-Zeilen) startet beim Einschalten des Messmodus und lädt den Stand gleich vorab (`prepare`, bei großen Baugruppen Sekunden), nach einem neuen Build erneut. Die Messkarte zeigt dabei „Messdienst startet …“ bzw. „Geometrie wird geladen (N Bauteile) …“ mit Sekunden und laufendem Balken. Klicks gehen schon, ihre Messung wartet auf das Laden. Gerechnet wird mit OCC. Jede Anfrage trägt die Build-Kennung und den Flächeninhalt bzw. die Länge aus dem Viewer, so fällt jede Verwechslung auf. Nach einem neuen Build beginnt die Messung von vorn. Auch Vorschauen alter Stände lassen sich vermessen.-- **Git und ZIP:** `.soma/geometry/` ist ein Zwischenergebnis. Neue Projekte haben es in der `.gitignore`, bei älteren klammert die App es selbst aus (Status, Snapshot, ZIP). Dabei fiel auf, dass `git add` mit einem Ausschluss auf einen ignorierten Ordner scheitert: Die App nimmt den Ordner deshalb nach dem Hinzufügen wieder aus dem Index.--*Ansicht (Wunsch des Nutzers; 8 Prüfungen im Smoke-Test):*--- **Ansichtswürfel in 3D** (`viewcube.ts`, eigene kleine Szene): dreht sich mit der Kamera, jede Seite ist in 3 × 3 Felder geteilt, ein Klick auf Seite, Kante oder Ecke dreht die Ansicht animiert in eine der 26 Richtungen. Ziehen am Würfel dreht frei, beim Überfahren leuchtet das Feld orange und ein Hinweis nennt die Richtung. Achsen X, Y, Z an der Ecke links vorne unten. Einpassen und Standardansicht darunter wie bisher, die sechs Ansichten auch im Menü „Darstellung“ (per Tastatur erreichbar).-- **Drehpunkt verschieben:** Doppelklick ins Modell macht die Stelle zum Drehpunkt, die Ansicht verschiebt sich dafür, ohne zu drehen. Das Mausrad zoomt zur Mausposition, die rechte Maustaste verschiebt. Während der Bewegung zeigt ein Punkt den Drehpunkt. Die vordere Schnittebene folgt dem Abstand, so lassen sich Ecken von ganz nah ansehen, ohne dass sie weggeschnitten werden.--*Gruppen und Transparenz (E42; 17 Prüfungen in `app/test/groups.mjs`):*--- **Gruppen:** `add_part("Deckel", lid, group="Gehäuse")`, verschachtelt mit „/“. Eine STEP-Datei mit Struktur kommt mit `import_assembly("inputs/platine.step")` und `add_part("Platine", asm, role="reference")` herein: Jeder Körper wird ein Bauteil mit seinem Namen und seiner Farbe, Unterbaugruppen werden Gruppen unter „Platine“, verschoben wird mit `asm.loc`. Doppelte Namen aus der Datei bekommen „(2)“. Die Ausgabe-STEP enthält die Gruppen als Unterbaugruppen (Referenzen unter „Referenz“), auch die Vorschau alter Stände zeigt sie.-- **Bauteilkarte als Baum:** Gruppen auf- und zuklappbar, mit Anzahl. Jede Zeile hat ein Auge und einen Schalter „transparent“, bei Gruppen für alle Teile darin (teilweise transparente Gruppen sind gekennzeichnet). Rechtsklick auf eine Gruppe: Isolieren, Aus-/Einblenden, Transparent, Kamera auf Gruppe. Die Suche zeigt Treffer samt ihren Gruppen. Der Auswahltext für den Agenten nennt die Gruppe.-- **Transparent:** deutlich durchsichtig, ohne zu verdecken. Klicks und Messungen gehen durch transparente Teile hindurch, sie selbst werden nur getroffen, wenn dahinter nichts liegt.-- **Nebenbei behoben:** Die Verlaufsleiste konnte einen veralteten Stand behalten, wenn sich zwei Abfragen überholten (fiel im Gesamtlauf der Tests auf, als `.git` verschwand).--*Name und Icon (E43, E44):*--- **SOMA** (*Solid Object Modeling with Agents*) ersetzt den Arbeitsnamen CAD-IDE überall: Oberfläche, Paket und Befehl `soma`, Projektordner `.soma/`, Umgebungsvariablen `SOMA_*`, App-Daten unter `%LOCALAPPDATA%\soma`. Ohne Rückfallweg: Projekte mit `.cadide/` öffnet die App nicht mehr, ein `model.py` mit `from cadide import` baut nicht mehr. Die alten Ordner `%LOCALAPPDATA%\cadide` (App-Daten mit Arbeitsordnern) und `%LOCALAPPDATA%\cadide-dev` (lokale Electron-Kopie) bleiben liegen und werden nicht mehr benutzt.-- **Icon „Dialog“ (E44):** der Würfel als Sprechblase mit orangem Deckel. In Kopfzeile und Startseite als Symbol `logo` (`icons.ts`), für Fenster und Taskleiste als `resources/icon.ico` (16 bis 256 px, kleine Größen mit dickerem Strich), erzeugt mit `app/scripts/make-icon.py`. Ins Programm selbst (EXE) kommt das Icon erst mit dem Installer.--*Schnitt (vorgezogen aus „Danach“, Wunsch des Nutzers; 26 Prüfungen in `app/test/section.mjs`):*--- **Ablauf:** „Schnitt“ im Viewer öffnet die Karte unten rechts. Die Ebene steht senkrecht zu X, Y oder Z, zuerst mitten im Modell. Weggeschnitten wird die Seite, von der die Standardansicht kommt (rechts, vorne, oben), so sieht man gleich hinein. „Seite wechseln“ dreht das um, „Blick auf den Schnitt“ dreht die Kamera senkrecht auf die Ebene. Die Lage stellt ein Schieber ein oder ein Eingabefeld in mm (Komma oder Punkt, Enter übernimmt, Pfeiltasten 1 mm, mit Umschalt 10 mm, mit Alt 0,1 mm).-- **An einer Fläche ausrichten:** „Fläche“ und dann eine ebene Fläche anklicken: Die Ebene liegt parallel dazu, anfangs mitten durch das Bauteil der Fläche, eingestellt wird die Tiefe ab der Fläche. Unter dem Zeiger leuchtet die Fläche auf, eine gekrümmte wird abgelehnt, Escape bricht ab.-- **Darstellung:** Die Schnittfläche ist gefüllt, je Bauteil in seiner Farbe (abgedunkelt) und schraffiert, die Richtung der Schraffur wechselt von Bauteil zu Bauteil. Eine dunkle Kontur umrandet sie. Gefüllt werden nur sichtbare, deckende, geschlossene Körper (der Mesher schreibt dafür `solid` ins GLB), bei transparent geschalteten Teilen und Referenzen sieht man ohnehin hinein. Kanten, Hervorhebungen und Messmarken der Elemente werden mitgeschnitten, Messstrecken nicht. Das Vorschaubild der Startseite zeigt das Modell ohne Schnitt.-- **Klicks und Messen:** Was weggeschnitten ist, lässt sich nicht anklicken, der Klick geht dorthin, wo man hinsieht. Ein Klick auf die Schnittfläche wählt das Bauteil („Schnittfläche · ganzes Bauteil“), Doppelklick setzt dort den Drehpunkt. Beim Messen wählt ein Klick nahe der Kontur die geschnittene Fläche, so misst man Wandstärken direkt im Schnitt (zwei Konturlinien ergeben den Abstand der Ebenen). Die Schnittfläche selbst hat keine exakte Geometrie, ein Klick darauf gibt nur einen Hinweis und verwirft die Messung nicht.-- **Für den Agenten:** Eine Markierung im Schnitt nennt die Ebene und die weggeschnittene Seite (`Schnittansicht bei X = 0.000 mm, weggeschnitten ist X > 0.000`), sonst hielte der Agent die Schnittfläche für eine echte Fläche.-- Der Schnitt ändert nichts am Modell, bleibt über neue Builds und Vorschauen erhalten und wird nicht gespeichert.-- **Technik:** eine Schnittebene von three.js für alle betroffenen Materialien, die Füllung über den Schablonenpuffer (Rückseiten zählen hoch, Vorderseiten herunter, wo etwas übrig bleibt, zeichnet eine Platte in der Ebene), die Kontur aus den Dreiecken des Netzes.-- **Nebenbei behoben:** Ein nur lesbarer Reiter im Editor, dessen Datei gelöscht wurde, galt als Konflikt und blockierte das Speichern des Modells. Er schließt sich jetzt. Ein Konflikt erledigt sich auch, wenn die Datei wieder so ist wie zuletzt gelesen.--*Explosion (vorgezogen aus „Später“, Wunsch des Nutzers, E56, E57, E59, E60; 50 Prüfungen in `app/test/explode.mjs`, dazu am Motormodell des Nutzers gesichtet):*--- **Ablauf:** „Explosion“ im Viewer öffnet die Karte unten rechts, die Bauteile gleiten auf 50 % auseinander. Der Schieber stellt den Abstand ein: bis 50 % gleiten die Teile aus der Einbaulage in die Explosion, darüber wird die Lücke bis aufs Dreifache größer. Richtungsknöpfe gibt es nicht (E61): Ist ein Teil in mehrere Richtungen frei, bevorzugt die Analyse die Achse der meisten Normteile, ohne Normteile die, entlang der Teile aufeinanderliegen, sonst Z. „Wege“ zeigt gestrichelt den eigenen Weg jedes Teils (ab seinem Elternteil), „Einpassen“ holt das größere Modell ins Bild. Schließen setzt das Modell gleitend wieder zusammen.-- **Demontage-Analyse (per Skript ohne KI, E59):** Ein Strahltest im Viewer bestimmt, was jedem Teil in welcher Richtung im Weg steht. Er schießt von bis zu 600 Punkten knapp unter der Oberfläche jedes Teils Strahlen in alle Kandidatenrichtungen (±X, ±Y, ±Z und die Achsen der Normteile), gegen alle Teile zugleich (BVH aus `three-mesh-bvh`, MIT). Ein Strahl liefert beides: wen das Teil trifft und wer in der Gegenrichtung gegen das Teil stieße. Treffer unter 0,5 mm gelten als Berührung. Beim Motor dauert das rund 0,4 s.-- **Reihenfolge:** Das größte Teil (kein Normteil) bleibt stehen. Runde für Runde kommt heraus, was frei ist. Bei mehreren freien Richtungen gilt nacheinander: bei Normteilen die eigene Achse aus dem Material, dann die Richtung, in der das Teil von etwas abhebt, worauf es liegt, dann die Vorzugsachse, dann weg vom Anker. Ist kein einzelnes Teil frei, kommt eine **Baugruppe** heraus, die nur sich selbst im Weg steht (eine Senke im Blockiergraph, Tarjan), und wird danach genauso in sich zerlegt. Erst wenn auch das nicht geht, muss das Teil mit den wenigsten Hindernissen trotzdem heraus, der Hinweis nennt es.-- **Wer mit wem wandert:** Jedes Teil wandert mit einem Elternteil, das später herauskommt: dem, an dem es aus den meisten Richtungen anliegt. Teile in dieselbe Richtung kommen immer in Frage, solche quer dazu nur, wenn sie es umschließen, entgegenlaufende nie. So wandert eine Schraube mit dem Deckel, eine Mutter mit der Welle, in deren Tasche sie steckt, ein Stößel aber nicht mit dem Nockenrad, auf dem er nur aufsitzt.-- **Lage:** Jedes Teil rückt von seinem Elternteil weg, bis es mit gleicher Lücke (5 % der Modelldiagonale) vor allem liegt, was seine Grundfläche überdeckt, mindestens eine halbe Lücke. Innen zuerst, ein Teil zieht seinen ganzen Teilbaum mit, eine Baugruppe ist dabei ein Block.-- **Normteile und Gewinde:** Die Achse leitet `add_part` aus `direction` ab, der Build legt sie als `axis` in die GLB-Metadaten. Ein Normteil entlang seiner Achse ignoriert, womit es sich überschneidet (Gewinde im Kernloch): Beginnt ein Strahl schon in einem Teil, tritt also beim ersten Treffer aus, überschneiden sich die beiden.-- **Am Motormodell (26 Teile):** Schrauben kommen zuerst entlang ihrer Achse, das Schwungrad nach hinten, Ventile und Stößel nach oben über ihre Führungen, Nockenräder und Kurbelwelle nach vorn. Kolben, Pleuel und Bolzenhülse kommen als Baugruppe nach vorn, darin das Pleuel nach unten aus dem Kolben, die Mutter der Kurbelwange mit der Welle und dann seitlich aus ihrem Schlitz. Nichts steckt fest.-- **Schräge Richtungen (E60):** Der Mesher schreibt zu jeder ebenen Fläche die Normale (nach außen) und zu Zylinder und Kegel die Achse in die Flächendaten. Jedes Teil bringt daraus seine eigenen Richtungen mit: Achsen seiner Zylinder und Kegel, Normalen seiner großen ebenen Flächen (ab 20 % der größten). Die schrägen davon (höchstens 12, die häufigsten) kommen zu den Kandidaten. Ein Teil darf eine schräge Richtung nur nehmen, wenn sie zu seiner Form gehört, sonst schickte die Fase eines Nachbarn es schräg hinaus. Normteile bringen keine Flächenrichtungen mit (ihr Sechskant gäbe nur nutzlose 60°-Richtungen), sie haben ihre Achse. So kommt ein Stift in einer schrägen Bohrung entlang ihrer Achse heraus. Teile, die in verschiedene Richtungen gehen, weichen einander aus, wo sich ihre Hüllquader wirklich überschneiden (der schräge Stift und der Deckel darüber).-- **Schritt für Schritt (E60):** In der Karte Zurück, „Zusammenbauen abspielen“, „Auseinanderbauen abspielen“ (der laufende Knopf hält an), Weiter, ein Tempo von 0,25× bis 2× und die Anzeige „Schritt 3 von 9“, darunter, was in diesem Schritt herauskommt (Nachbesserung nach der Kritik des Nutzers, vorher nur Auseinanderbau und ein fester Takt). Ein Schritt ist eine Runde des Auseinanderbaus, eine Baugruppe zerfällt gleich danach in sich. Jedes Teil geht die Wege seiner Kette (eigener Weg, dann die seiner Eltern), jeden erst, wenn dessen Schritt dran ist: Erst kommen die Schrauben aus dem Deckel, dann hebt der Deckel mit ihnen ab. Am Ende steht die ganze Explosion. Der Schieber verlässt das Abspielen. Der Pfeil rechts fügt die Reihenfolge als Liste in die Eingabe des Agenten ein („1. "Schraube 1" nach +Z; … Zum Zusammenbau rückwärts lesen“). Eine Markierung im Schrittmodus nennt den Schritt.-- **Grenzen:** Der Strahltest arbeitet mit Stichproben und kann sehr dünne Stege übersehen. Montage mit Drehung (Bajonett, Einschrauben) und Bewegungen in mehreren Schritten kennt er nicht. Gruppen aus `group=` spielen keine Rolle mehr, die Baugruppen ergeben sich aus der Geometrie (der Schalter „Gruppen“ aus E57 entfällt).-- **Klicks, Schnitt, Messen:** Auswahl und Hervorhebung arbeiten in der verschobenen Lage, die Hervorhebung wandert mit. Der angeklickte Punkt, den der Agent bekommt, steht in Einbaulage. Der Schnitt schneidet das auseinandergezogene Modell, sein Bereich folgt den Teilen, seine Karte rückt über die der Explosion. Gemessen wird nur in Einbaulage (die exakte Geometrie kennt keine Explosion): „Messen“ setzt das Modell sofort zusammen, „Explosion“ beendet das Messen.-- **Für den Agenten:** Eine Markierung in der Explosion sagt dazu, dass die Teile nur zur Darstellung auseinandergezogen sind und nicht in Einbaulage stehen.-- Die Explosion ändert nichts am Modell, bleibt über neue Builds und Vorschauen erhalten (die Richtungen werden neu bestimmt) und wird nicht gespeichert. Getestet unter Windows.-- **Ladeanzeige (Wunsch des Nutzers, große Baugruppen):** Der Strahltest läuft in Häppchen von 30 ms und gibt dazwischen die Oberfläche frei. Dauert er länger als 0,2 s, deckt eine Ladeanzeige den Viewer ab: „Explosion wird vorbereitet“, Zahl der Bauteile, Fortschrittsbalken, Sekunden, „Abbrechen“ (auch Escape) beendet die Explosion. Die Karte erscheint erst mit dem Ergebnis. Ein neuer Build während der Analyse verwirft sie und beginnt neu.--*Skills (E17, E46, E55; 47 Prüfungen in `app/test/skills.mjs`, 14 Einheitentests):*--- **Panel „Skills“** in der Leiste links: die mitgelieferten Skills mit Kurzbeschreibung, Umschalter für die Stufe und aufklappbar den Themen. Mitgeliefert sind 17 Skills in `app/resources/skills/` (siehe „Skill-Inhalte“ unten, zwei kamen mit E58 dazu, FEM mit E65, Technische Zeichnungen mit E76, Parametrische Modelle mit E77). Inhalt und Kopf (Titel, Beschreibung, Themen, Einstellungen für die Oberfläche) sind auf Englisch, der Kopf war bis E73 deutsch. Die CadQuery-Befehle darin (Kollisionsprüfung, Abstand, Senkungen) sind gegen die Basisumgebung geprüft.-- **Stufen (E55, Wunsch des Nutzers):** Jeder Skill steht je Modell auf **Aus**, **Bei Bedarf** oder **Immer** (Umschalter mit drei Feldern in der Karte, „Immer“ hebt die Karte orange hervor, „Aus“ nimmt sie zurück). Bei Bedarf und Immer kopieren den Skill nach `.soma/skills/<id>.md`, tragen ihn in `project.json` ein (`skills` für Immer wie bisher, `skills_on_demand` für Bei Bedarf, auch in der App-Kopie, E27) und listen ihn im Abschnitt am Ende der `AGENTS.md` (zwischen `<!-- soma:skills -->` und `<!-- /soma:skills -->`, bei älteren Projekten ohne diesen Abschnitt wird er angehängt). Der Abschnitt hat zwei Listen: „Always follow“ (vor jeder Änderung lesen und befolgen) und „Read when relevant“ (je Skill der Anlass aus dem neuen Kopffeld `when`, etwa „Read when the parts will be 3D printed on a filament printer (FDM)“, nicht alle vorab lesen). Die Kopie eines Skills „Bei Bedarf“ hat unter der Überschrift einen Hinweis: dem Skill folgen, solange das Thema gilt, das in `NOTES.md` unter `## Requirements` festhalten (sonst weiß eine spätere Sitzung nichts davon), die Werte sind Standardwerte der App (vom Nutzer eingestellte nennt er mit Namen), also nennen oder nachfragen, und in der App lässt er sich auf „Immer“ stellen. **Aus** entfernt Kopie und Eintrag. Jedes Umstellen zählt als ungespeicherte Änderung und wandert mit Snapshot, Git und ZIP. Ein Wechsel zwischen Bei Bedarf und Immer schreibt die Kopie neu, eine unveränderte ohne Sicherung.-- **Einstellungen (Wunsch des Nutzers):** Ein Skill erklärt im Kopf Variablen, etwa `var overhang: 45 | ° | Max. Überhangwinkel | 10..85` (Standard, Einheit, Bezeichnung, Bereich) oder eine Auswahl `var material: PLA | | Material | PLA, PETG, ABS, ASA, TPU` (Einträge auch als `wert=Anzeige`). Im Text stehen Platzhalter wie `{{overhang}}`. Im Panel stehen die Einstellungen im aufgeklappten Skill: Zahlenfelder (Komma oder Punkt, Enter übernimmt, Escape verwirft) und Auswahllisten, geänderte Werte orange mit Knopf „zurück auf den Standard“, darunter in der Karte „Eingestellt: …“. Die App prüft jeden Wert (Bereich, Auswahl) und lehnt Falsches mit Grund ab. Gespeichert werden nur abweichende Werte, in `project.json` unter `skill_settings`, auch für ausgeschaltete Skills (sie gelten beim Einschalten). Die Kopie im Projekt enthält die eingesetzten Werte, im Text und im Kopf, der Agent liest also konkrete Zahlen. Eine Änderung schreibt die Kopie eines eingeschalteten Skills neu, eine von Hand geänderte Kopie kommt vorher in die Sicherung. Welche Einstellungen die mitgelieferten Skills haben, steht unten. Ein Skill ohne Einstellungen ist erlaubt.-- **Agent:** Ein laufender Agent liest `AGENTS.md` nicht von selbst neu. Die Meldung nach dem Umstellen oder Einstellen sagt das, „An Agent geben“ fügt `[Skill: .soma/skills/<id>.md] ` ein, mit geänderten Einstellungen etwa `[Skill: .soma/skills/3d-druck.md, Einstellungen: Max. Überhangwinkel = 50°] `. `AGENTS.md` erklärt dem Agenten diese Notiz. Den Knopf gibt es bei Bedarf und Immer, bei Bedarf heißt er: jetzt anwenden.-- **Ansehen:** Die Kopie öffnet sich im Code-Panel, nur lesbar („Kopie eines Skills“).-- **Kategorien (E46, Wunsch des Nutzers):** `category` im Kopf ordnet einen Skill unter eine Überschrift im Panel: Arbeitsweise, Fertigungsverfahren, Konstruktionswissen, Prüfen und Zeigen (E58). Eine Kategorie steht dort, wo ihr erster Skill laut `order` steht, Skills ohne Kategorie (etwa aus einer neueren App) unter „Weitere“ am Ende.-- **Skills für neue Modelle (E46, E55, Wunsch des Nutzers):** `default:` im Kopf gibt die Stufe bei neuen Modellen vor (`always`, `on-demand` oder `off`, ohne Angabe Bei Bedarf). Mitgeliefert: Immer für Konstruktionsablauf, Sauber modellieren, Parametrische Modelle (E77) und Normteile (E48), alle übrigen Bei Bedarf. Im aufgeklappten Skill stellt die Auswahl „Stufe bei neuen Modellen“ das für die ganze App um. Gespeichert wird nur, was vom Kopf abweicht, in `state.json` der App-Daten (`skill_defaults`, Einträge von vor E55 mit an/aus gelten als Immer/Bei Bedarf). Das offene Modell bleibt dabei, wie es ist. Ein neues Modell bekommt die Skills vor dem ersten Build, mit Kopie, Eintrag in `project.json` und `AGENTS.md`, also schon im Startcommit, und mit den Standardwerten. Weicht die Vorgabe von „Bei Bedarf“ ab, nennt die Karte sie („Bei neuen Modellen: Immer“). Lässt sich ein Skill nicht kopieren, bleibt er aus, das Anlegen geht weiter.-- **Robustheit (E28):** Nichts wird still ersetzt: Weicht die Kopie im Projekt von der mitgelieferten Fassung ab (vom Agenten geändert, ältere App), meldet die Karte das, und vor dem Überschreiben oder Entfernen kommt sie nach `workspace-backups/<id>-skills/`. Fehlt die Datei eines eingeschalteten Skills, nennt das die Karte und der Projekt-Check, angelegt wird nichts. Fehlt `AGENTS.md`, wird der Skill trotzdem umgestellt, mit Warnung, die Datei wird nicht neu erzeugt. Nennt `AGENTS.md` einen eingeschalteten Skill nicht oder unter der anderen Stufe (etwa nach dem Zurückholen einer alten Fassung), steht das in der Karte. Skills, die nur im Projekt liegen (aus einer neueren App), bleiben gültig.--*Skill-Inhalte (E45):* allgemeine Regeln, kurz gehalten (meist 40 bis 60 Zeilen samt Kopf), damit auch kleinere Modelle sie befolgen. Die Reihenfolge im Panel folgt `order`: Arbeitsweise (1 bis 3), Verfahren (10 bis 14), Konstruktionswissen (20 bis 24), Prüfen und Zeigen (30 bis 31). Den Gehäusebau gibt es nicht mehr (E47). In Projekten, die ihn eingeschaltet haben, bleibt die Kopie gültig, die Karte meldet „Diese App bringt den Skill nicht mit“.--| Skill | Inhalt | Einstellungen |-|---|---|---|-| Konstruktionsablauf | Anforderungen klären und in `NOTES.md` festhalten, vom Groben ins Feine, kleine Schritte, kurzer Bericht | Fehlende Angaben (erst fragen oder annehmen), Detailgrad (Konzept, Prototyp, fertigungsreif) |-| Sauber modellieren (CadQuery) | Parameter, ein Teil je Funktion, Reihenfolge der Schritte, robuste Selektoren, typische Fehler, Gültigkeit prüfen | keine |-| Parametrische Modelle (E77) | Konstruktionsabsicht (was die Größe bestimmt, was stehen bleibt, innen oder außen), Auswahl der Parameter (unabhängig, Kommazahl oder ganze Zahl, Auswahl mit Tabelle), Bereiche, in denen jeder Wert baut, alles Übrige abgeleitet, Formelemente, die Änderungen überstehen, Felder im Panel, Bereichsprüfung über eine Kopie des Projekts, spätere Änderungen | Höchstzahl der Parameter (15), Bereichsprüfung (jeder Parameter, nur Hauptmaße, nur auf Wunsch) |-| 3D-Druck (FDM) | überarbeitet: Materialhinweise, Prüfcode für Bauraum und Überhänge (nur ebene Flächen) | wie bisher |-| 3D-Druck Harz und Pulver | Wände, Ablauflöcher, Stützen und Saugwirkung, Spiel, Gewinde | Verfahren (SLA, SLS), Mindestwand, Spiel |-| CNC-Fräsen und Drehen | Innenradien, Taschentiefe, Aufspannungen, Bohrungen und Gewinde, Drehteile, Angaben für die Werkstatt | Material, kleinster Fräser, Achsen |-| Laserschneiden | Schnittbreite bei Schlitzen und Zinken, Stege, Platten flach bauen, DXF über einen Schalter `FLAT` | Material, Plattenstärke, Schnittbreite |-| Blech | Biegungen als Rundungen innen R und außen R + T, Schenkel, Abstände, Freistiche, Abwicklungslänge | Material, Dicke, Innenradius, K-Faktor |-| Toleranzen und Passungen | gekürzt: Der Laser-Teil und seine Einstellung wanderten zum Laserschneiden, die Kopfdurchmesser zu den Normteilen. Der Skill des Verfahrens geht vor | Fertigung, Durchgangslöcher, Mindestabstand |-| Verbindungen | Schrauben (Einschraubtiefe, Randabstand, Werkzeug, Längen), Schnapphaken, Scharniere, Stifte, Magnete, Kleben | Bevorzugte Schraube |-| Normteile | Schrauben, Muttern, Scheiben und Einsätze über `soma.fasteners` (E48), Mutternfallen mit `trap()`, Maße von Kugellagern, Stiften, Profilen | keine |-| Festigkeit und Steifigkeit | Gestaltungsregeln, Biegebalken als Überschlag, Werkstoffwerte, Gewicht | Sicherheitsfaktor |-| Baugruppen und Bewegung | gemeinsame Bezüge, Schnittstellen einmal definiert, Montierbarkeit, bewegte Teile über den Weg prüfen (für mehrere Schritte über eine Animation und `soma anim check`), Stückliste | Mindestabstand bewegter Teile |-| Analyse (E58) | `soma analyze` für Überhang, Wandstärke und Spalt, Grenzwerte aus den anderen Skills, Bild mit `soma render --result`, Grenzen der Auswertung | keine |-| Festigkeit mit FEM (E65) | Lastfall in `analyses/*.py`, Werkstoffe, Flächen wählen, Ergebnis lesen und prüfen (Lagerkräfte, Netzprüfung, Spitzen), Grenzen der linearen Rechnung | Sicherheitsfaktor |-| Animation und Video (E58) | Aufbau einer Datei in `animations/`, Gelenke, Zeitleiste, Kamera, Texte, prüfen mit `soma anim info` und `check`, ansehen als Übersicht, Video nur auf Wunsch | keine |-| Technische Zeichnungen (E76) | Zweck klären und planen, Blatt und Maßstab, Ansichten und Projektionsmethode, Schnitte und Einzelheiten, Bemaßung nach ISO 129 (Funktionsmaße, jedes Maß einmal, nie tippen), Toleranzen und Hinweise, Zusammenbau mit Positionen und Stückliste, frei zeichnen mit ezdxf, bauen und das Bild ausschnittweise prüfen | Norm (ISO, ASME), Blattgröße, Allgemeintoleranz, Sprache auf der Zeichnung |--Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuche, Mutternfalle, Tasche mit Innenradius, Blechwinkel mit gleicher Dicke in der Biegung, Bewegungsprüfung, Lagerplatte der Parametrik an allen Bereichsgrenzen, Zeichnung einer Platte ohne Hinweise der Prüfung).--*Normteile (E48, Wunsch des Nutzers; 35 Prüfungen in `app/test/fasteners.mjs`):*--- **Bibliothek `soma.fasteners`:** Schrauben ISO 4762, ISO 7380, ISO 10642, ISO 4017, ISO 4014, DIN 931 und ISO 4026, Muttern ISO 4032, ISO 4033, ISO 4035 und DIN 557, Scheiben ISO 7089, ISO 7091 und ISO 7093, Gewindeeinsätze von ruthex (Standard), CNC Kitchen, McMaster-Carr, Hilitchi und AE-SamZhihui. Vereinfacht ohne Gewinde: Köpfe mit Innensechskant, Sechskant mit 30°-Fase, Schaft mit Fase am Ende. Die Maße kommen aus 13 CSV-Tabellen von bd_warehouse, unverändert in `python/soma/data/fasteners/` mit Lizenz und Herkunftsvermerk (`QUELLE.md`). Gleiche Teile werden einmal gebaut und nur verschoben, 60 Schrauben brauchen deutlich unter einer Sekunde.-- **Lage:** `at` ist der Punkt auf der Achse, an dem das Teil aufliegt (Kopfunterseite, Stirnseite von Mutter und Scheibe, Oberseite bei Senkschraube, Gewindestift und Einsatz). `direction` zeigt von dort ins Material, Standard `-Z`. `at` darf auch eine `cq.Location` oder eine Workplane auf einer Fläche sein, dann gilt deren Normale. `on=teil` sucht die Auflage selbst (Schnitt der Geraden mit dem Teil). `sunk=True` versenkt bündig, `sunk=0.5` tiefer, `angle` dreht um die Achse. `seat`, `outer`, `tip` und `point(d)` sind Punkte auf der Achse, so stapelt der Agent Scheibe und Mutter am anderen Ende.-- **Bohrungen als Werkzeuge für `cut()`:** `clearance_hole(fit, depth, oversize, recess)` nach ISO 273 (fein, mittel, grob), bei versenktem Kopf mit Senkung (Kopf plus Spiel des Lochs), bei Senkschrauben mit 90°-Kegel. `tap_hole()` ist das Kernloch, `HeatSetInsert.hole()` die Bohrung nach der Tabelle, 1 mm tiefer als der Einsatz. `Nut.trap(clearance, slot, slot_length)` ist die Tasche für Sechskant- und Vierkantmuttern, mit Schlitz zum seitlichen Einschieben, so breit wie die Mutter quer zum Schlitz. Alle Werkzeuge ragen 1 mm über die Oberfläche, damit `cut()` keine deckungsgleichen Flächen bekommt.-- **Längen:** nur Normlängen der Tabelle (`lengths()`, `pick_length(min, max)`), sonst ein Fehler mit der Liste. Sonderlängen mit `check_length=False`.-- **Rolle `hardware`:** `add_part` gibt Normteilen ohne Angabe diese Rolle und ihre Farbe (Stahlgrau, Einsätze Messing). Sie stehen deckend bei den eigenen Teilen im Bauteilbaum, die Auswahl zeigt „(Zukaufteil)“, in `output/model.step` stehen sie bei ihrer Gruppe. `soma export --all` überspringt sie und sagt das, einzeln lassen sie sich exportieren. Die App brauchte dafür nur den Zusatz in der Auswahl.-- **Fehler erklärt (Abschnitt 9):** unbekannte Norm mit Liste, alte DIN-Namen mit dem ISO-Nachfolger, fehlende Größe mit den vorhandenen, fehlender Punkt, Gerade ohne Treffer, mehrdeutiger Einsatz. Für die M10-Einsätze nennt die Tabelle als Bohrer „M14“, größer als der Einsatz: `soma` lehnt sie ab, statt eine unbrauchbare Bohrung zu liefern.-- **Für den Agenten (Wunsch des Nutzers):** Die Anleitung steht im Skill „Normteile“, nicht in `AGENTS.md`. Der Skill ist bei neuen Modellen an. Er enthält Beispiel, Lage, Normen, Längen, Mutternfallen, Rolle. Seine Schraubentabelle ist entfallen (nur eine Quelle für die Maße). Der Test führt den Codeblock des Skills aus. „Verbindungen“ nennt `pick_length()`.--*Animation, Analyse, Bilder und Videos (E58, Wunsch des Nutzers; 46 Prüfungen in `app/test/animation.mjs`, 1 Einheitentest):*--- **Grundidee:** Eine Animation ist eine Beschreibung, kein Video. Der Agent schreibt sie in Python in `animations/*.py` mit `soma.anim`: Zeitleiste wie in manim (`play`, `wait`, `run_time`), Drehachsen durch zwei Punkte wie `cq rotate()`, Lagen als `cq.Location`. `soma anim build` führt das Modell aus, dann die Datei (`from model import …` geht, `add_part` bleibt dabei wirkungslos), tastet mit 30 Bildern je Sekunde ab und schreibt eine glTF-Animation nach `.soma/anim/<id>.glb` (je bewegtem Bauteil ein Knoten, Kamera und Zielpunkt, Texte und Zustände in den extras) und `.soma/anim/index.json`. Fehler stehen mit Datei und Zeile im Index.-- **Gelenke, Kamera, Texte:** `hinge` (Drehachse), `slider` (Richtung), `part` (freie Lage), Gelenke auf Gelenken mit `parent=`, ein Gelenk je Teil. Die Kamera kennt die Ansichten des Viewers, `fit` passt Teile über die ganze Bewegung ein, `orbit` kreist um Z, `zoom`. Titelkarten, Untertitel (zum Video auch als WebVTT) und Beschriftungen, die mit ihrem Bauteil wandern. Gemalt werden die Texte auf einer 2D-Fläche über dem Bild, im Viewer wie im Video gleich.-- **Prüfen:** `soma anim info` beschreibt den Ablauf als Text mit Zeiten. `soma anim check` prüft im Abstand von 0,1 s bewegte Teile gegen alle anderen: Überschneidung und Mindestabstand (`--gap`). Seit E64 auf den Dreiecksnetzen, Berührung und Spiel aus der Lage im Modell gelten als gewollt (siehe unten).-- **Im Viewer:** „Animation“ öffnet unten links die Karte: Auswahl, Abspielen (Leertaste), Schieber, Tempo, Schleife, „Kamera“ (folgen), „Texte“ (Titel, Untertitel und Beschriftungen aus- und einblenden, Wunsch des Nutzers), „Video erzeugen“, „An Agent geben“ (`[Animation: "Name" (animations/x.py) bei 1.50 s]`). Die Teile bewegen sich im echten Modell, Schnitt und Auswahl gehen weiter, der angeklickte Punkt geht in Einbaulage an den Agenten, eine Markierung nennt Animation und Zeit. Messen, Explosion, Animation und Analyse schließen sich aus.-- **Bauen im Hintergrund:** Ändert sich eine Datei in `animations/`, baut die App sie neu (mit Auto-Build, entprellt, eine nach der anderen), das Modell baut dafür nicht. Ist eine Animation älter als der Code, baut die Karte sie beim Öffnen neu.-- **soma render:** über die App (Abschnitt 6). Standbild (`--view` als Name oder Richtung `x,y,z`, `--hide`, `--only`, `--fit`, `--zoom` seit E85, `--size`, `--out`), Zeitpunkt einer Animation (`--at`), Übersicht mit Standbildern und Zeiten (`--sheet 3x3`), Video (`--video`: MP4 mit H.264, 1280 x 720, 30 Bilder je Sekunde, dazu WebVTT und Übersicht), Ergebnis einer Analyse mit Legende (`--result`). Ausgabe nach `renders/`. Die App wartet vorher auf einen laufenden Build und sagt, wenn der letzte fehlschlug oder der Code neuer ist. Kodiert wird mit WebCodecs im Render-Fenster, verpackt mit mediabunny (MPL-2.0). Ein Video von 8 s braucht rund 15 s.-- **Video in der App:** Klick auf ein Video im Dateibaum spielt es über dem Viewer (Bild vor und zurück, Schieber, Leertaste). „Zeit an Agent“ fügt `[Video: renders/x.mp4 bei 00:03.20]` ein, „Markieren“ öffnet das Standbild auf der Zeichenfläche, die Notiz nennt Video und Zeitstempel.-- **Analyse:** `soma analyze overhang` (Winkel nach unten zeigender Flächen zur Senkrechten, Flächen auf dem Druckbett ausgenommen), `thickness` (Strahl von der Oberfläche nach innen bis zur Gegenseite), `clearance` (Spalt entlang der Flächennormalen bis zum nächsten anderen Teil, negativ bei Überschneidung, Berührung innerhalb der doppelten Netztoleranz gilt als 0 und ist nicht kritisch). Das Netz wird dafür unterteilt (Kanten bis 1 % der Modelldiagonale, mindestens 0,2 mm), ein Wert je Dreieck, Strahltests mit VTK aus der Basisumgebung. Ergebnis: `.soma/results/<name>.glb` mit dem Attribut `_VALUE` und den Metadaten (Größe, Einheit, Grenzwert, Spanne, Zusammenfassung, Befehl).-- **Analyse im Viewer:** Der Umschalter oben links (E62) zeigt das gewählte Ergebnis farbig statt des Modells. Über dem Bild steht ein Fadenkreuz wie beim Messen, neben dem Zeiger ein Schild mit Wert, Farbpunkt und Bauteil. Ausblenden und Transparent aus der Seitenleiste und der Schnitt gelten auch für das Ergebnis: Rot kritisch, Gelb nahe am Grenzwert, Grün unkritisch, weit davon Grau, Berührung Blaugrau. Legende und Zusammenfassung je Bauteil in der Karte, der Wert unter dem Zeiger, ein Klick merkt die Stelle für „An Agent geben“. Ist der Code neuer, steht das da, „Neu berechnen“ wiederholt die Auswertung mit ihren Angaben.-- **Für den Agenten:** zwei neue Skills „Analyse“ und „Animation und Video“ (Kategorie „Prüfen und Zeigen“, Bei Bedarf). `AGENTS.md` nennt `animations/`, `renders/`, `soma render` (Bild, um die eigene Arbeit anzusehen), `soma analyze`, `soma anim` und die neuen Notizen. „3D-Druck“ und „Baugruppen“ verweisen auf die Befehle. Das Beispiel im Skill baut der Test so, wie es dasteht.-- **Am Testmodell:** Überhang der Konsole 3,64 cm² (90°), Lasche mit 1 mm unter 1,2 mm, Stift mit 0,2 mm Spalt kritisch, Störer mit 2 mm Überschneidung, der aufliegende Deckel nur als Berührung. Eine Auswertung dauert hier unter 2 s.-- **Grenzen:** Videos ohne Ton. Die Kollisionsprüfung sieht nur ihre Zeitpunkte. Keine Strömung (CFD), sie käme als weitere Auswertung auf demselben Weg wie die FEM (E65). Getestet unter Windows.--*Oberfläche aufgeräumt (E62, E63, Kritik und Freigabe des Nutzers; Prüfungen im Smoke-, Editor-, Skills- und Animationstest):*--- **Entwurf:** `design/ui-entwurf-2.html` mit acht Bildern (Konzept, Arbeitsbereich, Dateien und Code, Werkzeuge, Ergebnisse, Skills, Parameter, Bausteine), die Anmerkungen ordnen jede Änderung einem Kritikpunkt zu.-- **Seitenleiste und Code:** Die Leiste links wählt Bauteile, Dateien oder Skills, beim ersten Start die Bauteile, danach die zuletzt gezeigte. Der Bauteilbaum steht dort statt als Karte im Viewer, Zeilen 26 px, Auge und Transparenz erscheinen beim Überfahren oder wenn sie etwas anzeigen. Code ist eine eigene Spalte mit eigener Trennleiste, ein Klick auf eine Datei oder „Code“ in der Karte öffnet sie, die offene Datei ist im Dateibaum hervorgehoben. Nach einem Modellwechsel zeigt eine offene Code-Spalte `model.py` des neuen Modells.-- **Spalten-Schalter:** oben rechts für Seitenleiste, Code und Agent, dazu Strg 1, 2, 3. Der Einklappknopf im Agent-Bereich entfällt, die eingeklappte Leiste mit den Tabs bleibt.-- **Viewer:** Die Werkzeugleiste in der Mitte hat nur noch Messen, Schnitt, Explosion und Markieren (Beschriftung bis 720 px Breite, darunter Symbole, unter 560 px links untereinander). „Darstellung“ steht als Symbol unter Einpassen und Standardansicht beim Würfel und öffnet links daneben. Alle Karten stapeln sich unten links (die erste unten), Schnitt und Explosion stehen nicht mehr rechts.-- **Umschalter oben links:** zeigt, was zu sehen ist (Modell mit Anzahl der Bauteile, Name der Analyse oder Animation, violett ein alter Stand), mit Kreuz zurück zum Modell. Sein Menü listet Analysen (`soma analyze`, mit Status), Animationen (`animations/`, mit Dauer) und Videos im Projekt. Neue Ergebnisse bekommen einen Punkt „1 neu“ am Umschalter und „neu“ im Menü, gesehen sind sie, sobald das Menü offen war. Die Liste frischt nach Builds, Änderungen an Animationen und Dateien, beim Fokus und alle 10 s auf (Ergebnisse unter `.soma/results/` meldet sonst niemand).-- **Skills:** eine Zeile je Skill (Name, darunter die Kurzbeschreibung oder die angepassten Werte, etwa „PETG · 50° · angepasst“, oder ein Hinweis in Gelb), rechts die Stufe als kleiner Schalter mit Menü (drei Stufen mit Bedeutung). Ein Klick auf die Zeile öffnet daneben eine Karte mit Beschreibung, Stufe, Einstellungen („2 angepasst · Zurücksetzen“), Themen, Vorgabe für neue Modelle, „Datei ansehen“ und „An Agent geben“. Die Erklärung der Stufen steckt hinter dem i im Kopf.-- **Ü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).-- **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`):*--- **Anlass:** Ein Agent baute einen druckbaren Einzylindermotor, animierte und prüfte ihn. Die Analyse fand zwei echte Fehler, Mechanismen waren umständlich, `soma anim check` lief über 25 Minuten. Der Nutzer wollte keine Lösungen nur für dieses Beispiel und keine neuen Begriffe für den Agenten.-- **Analyse:** Werte innerhalb der Netzgenauigkeit am Grenzwert (Winkel ±0,5°, Längen ± Netztoleranz) zählen als genau am Grenzwert, nicht kritisch, die Zusammenfassung nennt ihre Fläche (vorher waren 3,7 von 4,1 cm² eines 45°-Dachs „kritisch“). Ein Bauteil geht vor einer gleichnamigen Gruppe, wie in `soma.anim`, `"Gruppe/"` meint die Gruppe, mit Hinweis. Je Teil bis zu drei Problemstellen mit Fläche, Ausdehnung und Lage, gleichartige (Zahnspitzen, symmetrische Stellen) in einer Zeile. Beim Überhang ein Hinweis, wenn eine andere Achse deutlich weniger hat („mit --up -y nur 0.40 cm²“). Ein Strahl, der durch eine Ecke des Netzes rutscht, wird zweimal leicht gekippt wiederholt (Fehlalarm „offene Fläche“). Die Unterteilung halbiert nur noch die längste Kante, die Ergebnisse am Motor schrumpften von 69 auf 33 MB.-- **Kollisionsprüfung:** Der genaue Abstand der B-Rep-Körper (BRepExtrema) brauchte bei Zahnrädern 2,4 s je Paar und Zeitpunkt. Jetzt vorzeichenbehaftete Abstände der Ecken der unterteilten Netze (VTK), vorgefiltert über einen k-d-Baum, nur fragliche Berührungen mit Schnittmenge der B-Rep-Körper. Am Motor 64 s statt über 25 Minuten. Berührung und Spiel aus der Lage im Modell gelten als gewollt, gemeldet wird nur, was in der Bewegung schlechter wird (tieferes Eindringen, engeres Spiel). Endlagen nur von Bewegungen ab 0,5 s zusätzlich, nicht jede Grenze vieler kurzer Schritte. `vtkCollisionDetectionFilter` zusammen mit `vtkImplicitPolyDataDistance` stürzte gelegentlich ab (Zugriffsverletzung, VTK 9.6) und ist deshalb nicht im Einsatz.-- **Animation:** Die Animationsdatei bekommt das eben ausgeführte Modell als Modul `model`, `from model import ...` baut es nicht noch einmal. `soma anim info` fasst lückenlose kurze Schritte desselben Gelenks zusammen („Kurbelwelle: 0 -> 720 Grad (60 Schritte)“, am Motor 60 statt 1750 Zeilen). Gekoppelte Bewegungen bleiben eine Schleife mit `play()`, der Skill sagt, dass das in Ordnung ist.-- **Fortschritt:** Lange Befehle (`soma anim check`, `soma analyze`) melden nach 5 s im Fehlerkanal den Stand mit geschätzter Restzeit, höchstens alle 15 s.-- **Normteile:** `rotate()`, `translate()` und `moved()` wie bei CadQuery-Formen liefern eine bewegte Kopie mit Bezeichnung und Bohrungen. Vorher legte der Agent jede Schraube für eine andere Stellung neu an.-- **Doku:** eine Regel für Maße: oben in `model.py`, mit `parts/` in `parts/params.py` (`AGENTS.md`, Skills „CadQuery“, „Toleranzen“, „3D-Druck“ sagten vorher nur `model.py`).-- **Speichern:** Snapshot und ZIP nehmen `.soma/anim/` und `.soma/results/` nicht mehr mit, der Verlauf auch `renders/` nicht. Ältere Projekte bekommen die Einträge beim Öffnen in `.git/info/exclude` (gilt auch für Commits des Agenten, die `.gitignore` bleibt unberührt), der nächste Snapshot nimmt schon committete Zwischenergebnisse aus dem Index. Bereits gepackte Dateien (Git-Objekte, Bilder, Videos) legt die ZIP nur ab. Am Motor: ZIP 95 statt 154 MB, Packen 0,7 statt 5,2 s, dazu entfiel das Einchecken von bis zu 214 MB je Snapshot. Der Knopf zeigt sofort „Speichert …“ (E62).--*Festigkeit mit FEM (E65, Wunsch des Nutzers; 34 Prüfungen in `app/test/fem.mjs`):*--- **Lastfall:** eine Python-Datei je Lastfall in `analyses/` mit `soma.fem.Study(Titel, material=, safety=, mesh=)`, darin `fix` (auch nur einzelne Achsen), `force` (Gesamtkraft gleichmäßig auf die Flächen), `pressure` (senkrecht, positiv ins Material) und `gravity`. Flächen per CadQuery-Selektor auf dem Teil in seiner Lage im Modell oder mit `near=(x, y, z)`. Werkstoffe wie im Skill „Festigkeit“ oder eigene Werte, `set_material` je Teil. Gedruckte Kunststoffe rechnen mit der Festigkeit quer zu den Schichten.-- **Rechnung:** gmsh vernetzt die BREP-Formen des Builds mit quadratischen Tetraedern auf der echten Geometrie, mehrere Teile werden verschmolzen (fest verbunden, wo sie sich berühren). Die Gesamtsteifigkeit rechnet `fem.py` selbst in numpy (scikit-fem war rund 20-mal langsamer), gelöst wird direkt (bis 12 000 Unbekannte) oder mit pyamg (CG mit algebraischem Mehrgitter, Starrkörperbewegungen als Nahraum). Ein Winkel mit 36 000 Unbekannten braucht rund 5 s Rechnung, dazu der Build. Der Kragbalken trifft die Formel auf 0,2 %.-- **Prüfungen:** Jeder Körper muss gegen alle sechs Starrkörperbewegungen gehalten sein, sonst nennt die Meldung, was frei ist. Lagerkräfte je Einspannung und Gleichgewicht mit den Lasten. Eine zweite Rechnung mit 1,6-fach gröberem Netz, ändert sich die Höchstspannung um mehr als 15 %, sagt ein Hinweis, dass der Wert dort nicht verlässlich ist (scharfe Innenkante), ebenso, wenn die Spitze am Rand einer Einspannung oder Last liegt. Verformung über 5 % der Modellgröße wird gemeldet. Gewählte und im Netz gefundene Fläche werden verglichen.-- **Ergebnis:** wie die anderen Auswertungen `.soma/results/<name>.glb`, Wert ist der Sicherheitsfaktor (Festigkeit durch Vergleichsspannung, kritisch unter dem geforderten, höchstens 99), dazu je Ecke Vergleichsspannung (`_STRESS`) und Verschiebung (`_DISP`), der Lastfall als eigene Netze. Das Netz je Teil ist seine geschlossene Hülle, auch dort, wo es ein anderes Teil berührt (sonst schraffierte der Schnitt alles hinter der Berührfläche), die Kennzahlen gelten für die Außenfläche. Die Spanne reicht bis zum Vierfachen der kleinsten Sicherheit (höchstens das Zehnfache der geforderten), damit ein sicheres Teil nicht ganz grau ist. Die Zusammenfassung nennt Lastfall mit Flächen, je Teil Werkstoff, höchste Spannung, kleinste Sicherheit, größte Verschiebung mit Lage, Problemstellen und die Prüfungen.-- **Im Viewer:** Die Karte „Analyse“ zeigt bei FEM die Verformung überhöht (unverformt, echte Größe oder so, dass die größte Verschiebung 5 % der Modellgröße ist, auf eine runde Zahl), den Lastfall in Blau (Einspannungen kräftig, Lastflächen schwach, Kräfte als Pfeile vor dem Modell, ein- und ausblendbar), Zeilen für Lastfall und Hinweise. Unter dem Zeiger stehen Sicherheit, Spannung und Verschiebung, die Stelle gilt im unverformten Modell. Der Schnitt füllt und umrandet die verformten Netze, die Kontur folgt einer geänderten Überhöhung. „An Agent geben“ nennt alle drei. `soma render --result` zeigt die Verformung wie der Viewer und nennt die Überhöhung in der Legende. Veraltet ist ein Ergebnis auch, wenn die Studie neuer ist, „Neu berechnen“ nimmt die Studie wieder.-- **Farbskala (Wunsch des Nutzers):** Bei FEM wählt man die gezeigte Größe, Sicherheit oder Vergleichsspannung nach von Mises (Grenze ist die zulässige Spannung, Festigkeit durch geforderte Sicherheit, bei mehreren Werkstoffen die des schwächsten, kritisch darüber). Bei jeder Auswertung lässt sich die Spanne der Färbung wählen: automatisch (wie bisher, am Grenzwert ausgerichtet), Min bis Max der Werte im Modell, oder selbst gewählt (zwei Zahlenfelder, gilt beim Tippen, ungültig rot umrandet). Bei Min bis Max und selbst gewählt läuft die Farbe gleichmäßig über die Spanne von Grau bis Rot, die Legende sagt das dazu. Eigene Grenzen bleiben für dasselbe Ergebnis und dieselbe Größe, auch nach „Neu berechnen“. `soma render --result` zeigt weiter die automatische Skala der Sicherheit.-- **Für den Agenten:** Skill „Festigkeit mit FEM“ (Prüfen und Zeigen, bei Bedarf, Einstellung Sicherheitsfaktor), `AGENTS.md` nennt `analyses/` und den Befehl, „Festigkeit“ und „Analyse“ verweisen darauf. Das Beispiel im Skill rechnet im Test so, wie es dasteht.-- **Pakete:** gmsh 4.15 (GPL 2 oder später) und pyamg 5.3 (MIT) in der Basisumgebung, gepinnt in `python/requirements-base.txt`. scikit-fem war kurz installiert und ist wieder entfernt. gmsh läuft nur im Python-Prozess von `soma`, nicht in der App. Seit E71 steht SOMA selbst unter GPL-3.0, gmsh passt damit in die Auslieferung.-- **Grenzen:** linear-elastisch, kein Kontakt, kein Gleiten, kein Knicken, keine Vorspannung von Schrauben, keine Ermüdung. Teile sind verschmolzen, nicht gefügt. Werkstoffe gleichmäßig (keine Schichtrichtung, kein Infill, kein Holzfaserverlauf). Werte nur an der Oberfläche. Getestet unter Windows.--*Wartezeiten (E66, Wunsch des Nutzers; Prüfungen in `app/test/versions.mjs` und `unit.mjs`):*--- **Anlass:** Beim Hotwire-Modell (294 Bauteile, davon 164 Normteile, rund 158 000 Dreiecke) dauerten Öffnen, Zurückspringen in der Zeitleiste und ein neues Modell zu lange. Gemessen: Python und cadquery starten 3 s, `model.py` 4,5 s, STEP 1,3 s, Netz, GLB und Geometrie zum Messen 4 s. Öffnen baute immer neu und ohne vorgewärmten Prozess (rund 13 s leerer Viewer), ein alter Stand las die STEP-Datei wieder ein und vernetzte neu (rund 10 s je Stand), ein neues Modell startete Python zweimal kalt (rund 8 s).-- **Öffnen ohne Neubau:** Gilt der letzte Build noch, zeigt die App ihn sofort. Er gilt, wenn `.soma/build.json` erfolgreich ist, die Fassung der Ausgaben trägt (`format`, `OUTPUT_FORMAT` in `build.py` und `build.ts`), GLB, Mapping und die Geometrie zum Messen da sind und keine Datei, deren Änderung bei offener App einen Build auslöst (`.py` überall, `inputs/`), neuer ist als der **Start** des Builds. Sonst wird gebaut wie bisher. Die Statusleiste nennt die Zeit des übernommenen Builds.-- **Ein vorgewärmter Python-Prozess für die ganze App** (`soma warm`, `build.ts`): schon beim Start der App, unabhängig vom Projekt, in einem leeren Startordner (`python-start` in den App-Daten, kein Projektordner, den Windows festhielte). Builds und alle `runSoma`-Aufrufe (Vorschau, Export, Animationen, Auswertungen, der Build beim Anlegen) nehmen ihn, danach wärmt der nächste vor. `soma build --wait` entfällt.-- **Vorschau-Cache für die Zeitleiste:** Ist der Arbeitsordner sauber (alles wie im letzten Commit) und gilt der Build, zeigt er genau diesen Commit. Dann legt die App ihn als dessen Vorschau ab (`previews.ts`), ausgelöst von neuen Commits (auch des Agenten) und fertigen Builds. Das Mapping verliert dabei die Code-Verweise (in der Vorschau zeigt der Editor den aktuellen Code), Rollen und Gruppen bleiben. Ändert sich etwas während des Kopierens oder ist die GLB unvollständig, wird verworfen. Stände ohne Cache entstehen wie bisher aus der STEP-Datei, dann im vorgewärmten Prozess.-- **Wiederherstellen:** Die Vorschau bleibt stehen, bis der Build danach fertig ist. Vorher sprang die Ansicht so lange auf den vorherigen Build zurück.-- **Neues Modell:** Der Build vor dem Startcommit läuft im vorgewärmten Prozess, beim Öffnen wird nicht noch einmal gebaut. Der Startcommit wird gleich zur Vorschau.-- **Gemessen mit Hotwire in der App:** Öffnen bzw. App-Start bis zum sichtbaren Modell 1,9 s (vorher rund 13 s), Sprung zu einem Stand im Cache 0,3 s (vorher rund 10 s), ein Stand ohne Cache 8,5 s, neues Modell 3,6 s (vorher rund 8 s, der Rest ist vor allem Git auf dem Netzlaufwerk). Der Build selbst ist unverändert (rund 10 s).-- **Testwerkzeug:** `taskkill /T` lässt den ganzen Baum stehen, wenn ein Kind sich nicht beenden lässt (Hilfsprozesse von node-pty beim Schließen eines Terminals), und unter Last braucht der Hauptprozess bis zu 40 s, bis er weg ist. Ein Neustart mit denselben App-Daten fand dann kein Fenster (Debug-Port noch belegt). `harness.mjs` beendet in dem Fall Kinder und Hauptprozess einzeln, wartet auf das Ende und vor dem Start auf einen freien Port.--*Projektumgebung (E25, E67, Wunsch des Nutzers; Prüfungen in `app/test/packages.mjs`):*--- **Anlass:** Bisher landete `pip install` im Terminal nicht in einer Projektumgebung. Auf dem Entwicklungsrechner hatte die Basisumgebung (`venv-full`, mit uv angelegt) gar kein pip, `pip` im Terminal war das globale Python des Rechners.-- **Umgebung je Modell:** `soma env` (`python/soma/env.py`, von der App beim Öffnen gestartet, rund 0,5 s, danach nur, wenn sich die Basis ändert) legt `.soma/env` als venv ohne eigenes pip an, rund 0,6 MB. Eine `.pth`-Datei hängt die site-packages der Basis an, so sieht das Python der Umgebung CadQuery, soma und alle Basispakete, ohne sie zu kopieren. `soma-env.json` hält fest, zu welcher Basis sie gehört (Python, Pfade, Änderungszeit der site-packages). Eine andere Python-Version leert die Umgebung, die App installiert die Liste danach neu.-- **pip:** Die Terminals haben vorn im PATH die Umgebung (`python`), dahinter die Basis (`pip`, `soma`), und `PIP_PYTHON` zeigt auf das Python der Umgebung. Jedes `pip install`, auch `python -m pip`, installiert damit dorthin. Basispakete gelten als vorhanden (pip sieht sie über die `.pth`) und sind in der `pip.ini` der Umgebung über `base-constraints.txt` auf ihre Version festgelegt (als `file:`-URL, weil pip Pfade mit Leerzeichen dort trennen würde). Die Basisumgebung bekommt dafür pip (`requirements-phase0.txt`).-- **soma sieht die Pakete:** `soma` läuft mit dem Python der Basis, auch im vorgewärmten Prozess. Jeder Befehl mit `--project` hängt die site-packages der Projektumgebung hinten an den Suchpfad (`env.activate`), was die Basis hat, gilt also zuerst.-- **requirements.txt:** Nach einem erfolgreichen Build trägt `soma build` die Pakete der Projektumgebung ein, deren Module das Modell geladen hat, mit Version (Kopfzeilen auf Englisch für den Agenten). Ohne Zusatzpakete entsteht keine Datei. Was in der Liste steht, aber nicht installiert ist, bleibt stehen. Die Datei ändert sich nur, wenn sich ihr Inhalt ändert. Der Agent committet sie mit, weil er nach `soma build` committet.-- **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.--*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).--*App auf Englisch (E73, Wunsch des Nutzers; Prüfungen in allen Suiten):*--- **Umfang:** Oberfläche (alle Karten, Menüs, Toasts, Hinweise, `lang="en"`), native Dialoge, Projekt-Check und Logzeilen, Ausgaben, `--help` und Fehlermeldungen von `soma`, Docstrings der öffentlichen API (`add_part`, `import_step`, `import_assembly`, Normteile, `soma.anim`, Studien-API von FEM), die Köpfe der Skills (Titel, Beschreibung, Kategorie, Themen, Einstellungen) und die Beschriftungen in den Bildern von `soma render`. Kategorien der Skills: Way of working, Manufacturing, Design knowledge, Check and present. CodeMirror zeigt seine eigenen englischen Texte, die deutsche Übersetzung im Editor ist entfallen. Code-Kommentare, interne Docstrings und Doku bleiben deutsch.-- **Notizen an den Agenten:** `[Markup: …]`, `[Selection: part "…", model.py line …]`, `[Build error: …]`, `[Measurement: …]`, `[Result: …]`, `[File: …]`, `[Quote: … p. …]`, Zeitpunkte mit `at`. `AGENTS.md` und die Skills beschreiben sie so.-- **Zahlen und Datum:** `en-US` mit Dezimalpunkt, Eingaben nehmen weiter auch ein Komma. Schnitt und Skill-Einstellungen schreiben Zahlen ohne Tausendertrennzeichen, damit ein Wert wie 2000 beim Wiedereinlesen nicht zu 2 wird (mit „2.000“ ging das schon vorher schief). Zeiten als `today 14:02` oder `24 Sept 14:02`.-- **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, darunter Name im Code und der Bereich des Agenten („30–200 mm“, „≥ 2 mm“, „3 options“, rot außerhalb, Wunsch des Nutzers), daneben das 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, der Skill „Parametric models“ (E77) erklärt, wie gute Parameter aussehen und wie der Agent ihre Bereiche prüft. Leerer Zustand mit „Ask the agent“.-- **Auswertungen:** `soma analyze` (auch FEM), Animationen und Export führen das Modell über `run_model` aus und rechnen so mit den Werten des Nutzers (Kragarm 4 mm: 31.7 MPa, 8 mm im Panel: 7.7 MPa). Nach einer Änderung gelten Ergebnisse und Animationen als veraltet, in der App (`newestSourceMtime`) wie in `soma` (`animrun.newest_source`, für `soma anim` und `soma render --result`). Neu gerechnet wird nicht von selbst.-- **Grenzen:** Jede Änderung baut das ganze Modell, auch eine reine Stellung wie ein Kurbelwinkel (bei großen Modellen Sekunden). Ein Ergebnis merkt sich nicht, mit welchen Werten es gerechnet wurde. 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.--*Skill „Parametric models“ (E77, Wunsch des Nutzers; Prüfungen in `app/test/skills.mjs` und `unit.mjs`):*--- **Anlass:** `param()` (E74) sagt, wie ein Wert ins Panel kommt, aber nicht, welche Werte gute Parameter sind. Agenten machen sonst Maße frei, die voneinander abhängen, wählen Bereiche, in denen das Modell bricht, oder Selektoren, die bei einer anderen Lochzahl die falsche Kante treffen.-- **Inhalt (`app/resources/skills/parametrik.md`):** Konstruktionsabsicht vor dem ersten `param()` (was die Größe bestimmt, was beim Ändern stehen bleibt, Innen- oder Außenmaß), höchstens `{{max_params}}` unabhängige Parameter, Kommazahl oder ganze Zahl bewusst, Auswahl mit Tabelle, Bereiche, die nicht voneinander abhängen, unmögliche Kombinationen mit eigener Meldung, nie still verkleinern, alles Übrige abgeleitet und nicht mit der Größe skaliert, Formelemente an berechneten Stellen statt über Indizes, Prüfungen je Teil als `assert`, Felder im Panel (Bezeichnung, Einheit, Schritt, Gruppe, Hilfe), stabile Namen, Bereichsprüfung, spätere Änderungen. Ein Codebeispiel (Lagerplatte mit Lochreihe und Lagerwahl) zeigt Tabelle, abgeleiteten Wert und Kombinationsprüfung.-- **Bereichsprüfung ohne neuen Befehl:** Projekt in einen Ordner außerhalb kopieren (ohne `.git`, `.soma`, `output`, `exports`, `renders`), dort je Fall `parameters.json` schreiben und `soma build --project <Kopie>`. Fälle: jede Zahl an `min` und `max`, jede Option, jeder Schalter umgelegt, alle Maße gemeinsam an `min` und an `max`. Jeder Parameter allein muss bauen, Kombinationen dürfen mit eigener Meldung abbrechen. Die `parameters.json` des Nutzers bleibt unberührt, die App sieht die Kopie nicht. Geprüft an der Vorlage und zwei Beispielmodellen, je Fall 3 bis 5 s.-- **Grenzen:** 113 Zeilen, länger als die übrigen Skills der Arbeitsweise. Kein Agent-Test bisher. Ein Befehl `soma params check` würde die Kopie und die Fälle übernehmen. Getestet unter Windows.--*Technische Zeichnungen (E76, Wunsch des Nutzers; Prüfungen in `app/test/drawing.mjs`):*--- **Grundidee:** Der Agent zeichnet selbst, soma liefert Werkzeuge statt automatischer Ansichten und Maße. Eine Zeichnung ist eine Python-Datei `drawings/*.py` mit `soma.drawing.Sheet`, mehrere Blätter je Datei möglich. Wie bei den Animationen bekommt sie das eben gebaute Modell als Modul `model`.-- **Bausteine (`python/soma/drawing.py`):** Blatt A4 bis A0 oder frei, Rahmen und Mittenmarken nach ISO 5457, Schriftfeld nach ISO 7200 (Felder englisch oder deutsch, Symbol der Projektionsmethode 1 oder 3), beides abschaltbar. `view()` projiziert ein Bauteil, eine Gruppe, mehrere, alle oder eine eigene CadQuery-Form in eine der sechs Ansichten, iso oder eine beliebige Richtung, mit eigenem Maßstab, `origin`, `up`, verdeckten Kanten, Tangentenkanten und Stil „phantom“. `section()` schneidet an einer Ebene oder mit einem beliebigen Körper (Halbschnitt, Ausbruch) und schraffiert die Schnittflächen je Teil im Wechsel 45/135°, Teile in `unhatched` bleiben ungeschnitten, mit `parent` entsteht der Schnittverlauf mit Pfeilen und Buchstaben. `section(path=[...])` schneidet entlang eines geknickten Schnittverlaufs (Stufen- oder Halbschnitt) und zeichnet ihn mit dicken Enden und Knicken. Wo ein Schnitt nur von der Seite zu sehen ist (Stufe, Mitte des Halbschnitts, Rand eines Ausbruchs), fällt die Kante weg (ISO 128-44). `breaks=[(p1, p2)]` kürzt `view()` und `section()` um den Teil zwischen zwei Modellpunkten, mit Bruchlinien (schmale Zickzacklinie, 6 mm Lücke), Maße darüber zeigen die volle Länge. `detail()` schneidet einen Kreis aus einer Ansicht und vergrößert ihn. Ansichtstitel, Schnitt- und Einzelheitsbuchstaben lassen sich mit `label_at`, `letters_at` und `letter_at` verschieben. Maße an Modellpunkten (`dim` waagerecht, senkrecht, schräg, `diameter`, `radius`, `angle`), Werte immer gemessen, `<>` für den Messwert im Text, Toleranzen. Dazu Mittellinien, Mittenkreuze, Hinweislinien, Texte, Tabellen und `sh.msp` für alles Weitere direkt mit ezdxf.-- **Technik:** verdeckte Kanten mit `HLRBRep_Algo` aus OCP (Kanten bekommen danach 3D-Kurven, sonst stürzen die Booleschen Operationen der Einzelheit ab), Kanten als LINE, ARC, CIRCLE, ELLIPSE oder Polylinie, echte DIMENSION-Objekte mit `dimlfac`, Layer und Linienarten nach ISO 128. PDF und PNG entstehen aus derselben DXF über das Zeichenmodul von ezdxf mit matplotlib, keine neuen Pakete. Schrift DejaVu Sans (liegt matplotlib bei). Zwei Fehler von ezdxf umgangen: Das Ø wurde in jeder Schrift zum Fleck (Löcher in Zeichen über Verschachtelung gesucht, für Text jetzt mit der Füllregel der Schrift), und Schraffurlinien bekamen einen Zufallsversatz (fester Startwert).-- **Bytegleich:** Gleiche Zeichnung, gleiche Dateien (DXF mit festen Zeitstempeln und sortierten Klassen, PDF ohne Erstellungsdatum). Ein Neubau ohne Änderung ändert nichts im Verlauf. Das Datum im Schriftfeld ist der Tag des Baus, wenn der Agent keines angibt.-- **Prüfung (meldet nur, E28):** Text außerhalb des Rahmens oder auf dem Schriftfeld, Ansichten übereinander, Texte und Maßzahlen übereinander, Texte auf Kanten, Maßpunkte auf keiner Kante (mit Hinweis auf gerundete Ecken) oder nur auf verdeckten, Durchmesser ohne passenden Kreis, getippte Zahlen, die vom Messwert abweichen, Text unter 2.5 mm, Maßstab nicht nach ISO 5455, leeres Blatt. Seit dem ersten Agent-Test auch Texte auf Maß-, Hinweis-, Mittel-, Bruch- und Schnittlinien, Ansichten, Texte und Hinweislinien auf einer Tabelle (Stückliste), Texte, die nicht in ihre Zelle oder ihr Feld im Schriftfeld passen. Texte zählen als gedrehte Rechtecke (schräge Maßzahlen meldeten vorher Kanten neben sich). Maße dürfen auf Mittenkreuzen und Mittellinien des Agenten enden (Positionen, die nicht im Modell sind). Meldungen zu Beschriftungen von soma nennen den Parameter zum Verschieben.-- **Befehle:** `soma drawing build [Datei]` schreibt `output/drawings/<Name>.pdf` und `.dxf` (im Verlauf und in der ZIP wie `output/model.step`) und ein Bild `.soma/drawings/<Name>.png` mit 200 dpi (längste Seite höchstens 7000 px, nicht in Verlauf und ZIP). Fehler mit Datei und Zeile, Hinweise mit Zeile. `soma drawing list` mit „veraltet“, `soma drawing info` beschreibt Ansichten mit Lage auf dem Blatt, Kreise und Bögen je Ansicht und alle Maße mit Wert. PDF und DXF entfernter Blätter bleiben liegen, die Ausgabe nennt sie. Alle Blätter zusammen stehen in `output/drawings.pdf` (nach Datei, dann Reihenfolge darin), Blätter, die nicht neu gebaut wurden, kommen dafür aus ihrer DXF. Hat eine Zeichnung Fehler, bleibt diese Datei unverändert (sonst fehlte still ein Blatt), die Ausgabe sagt es.-- **Erster Agent-Test (2026-10-09):** Rückmeldungen des Agenten, alle behoben: `num(130, 0)` ergab „13“, `diameter()` mit `text="Ø<> H7"` ergab „ØØ8“ (Ø und R vor `<>` werden jetzt nicht verdoppelt), der Text eines Durchmessers lag gegenüber von `angle` (jetzt wie beim Radius die Richtung von der Mitte zum Text), mehrzeiliger Text verlor Einrückungen und wurde fälschlich als 161 mm außerhalb gemeldet (ezdxf misst MTEXT mit Umbrüchen, die beim Zeichnen nicht entstehen, jetzt eine TEXT-Zeile je Zeile), ein zu langer Werkstoff im Schriftfeld, Positionsnummern auf der Stückliste und Beschriftungen auf Maßen wurden nicht gemeldet und Beschriftungen ließen sich nicht verschieben. Gewünscht und ergänzt: Bruchlinien, Schnittverlauf bei Stufenschnitten, eine Gesamt-PDF, Maße zu Positionen ohne Geometrie. Dabei gefunden: Wurde in einem Skript Text gemessen, bevor DejaVu Sans angemeldet war (etwa über `leader()`), blieb für den ganzen Lauf eine Ersatzschrift hängen, auch in der PDF. Die Schrift wird jetzt beim Anlegen des Blatts angemeldet.-- **Für den Agenten:** Skill „Technical drawings“ (`zeichnung.md`, Prüfen und Zeigen, bei Bedarf) mit Best Practices nach ISO 128, 129, 5455, 5456, 7200 und den Werkzeugen, Einstellungen Norm, Blattgröße, Allgemeintoleranz und Sprache. `AGENTS.md` nennt `drawings/` und den Befehl. Der Nutzer öffnet die PDF in der vorhandenen PDF-Ansicht und kann Seiten markieren.-- **Grenzen:** Ein Agent-Test (Claude Code, ein Blatt). Text steht in der PDF als Pfad, „Zitat an Agent“ geht dort nicht. Keine automatische Stückliste (Daten muss der Agent zusammenstellen), keine Gewindedarstellung nach ISO 6410 (Normteile haben kein Gewinde), keine Rasterfelder am Rahmen, kein Eintrag im Umschalter des Viewers. Gedrehte Schnitte (Schnittverlauf mit schrägem Abschnitt) werden nicht in die Ebene geklappt, ihre schrägen Flächen bleiben ohne Schraffur. Die Projektion großer Baugruppen ist ungetestet. Getestet unter Windows.--*Eigene Skills und Einstellungen (E78, Wunsch des Nutzers; Prüfungen in `app/test/skills.mjs` und `unit.mjs`):*--- **Einstellungen:** Der bisher ausgegraute Knopf unten in der Leiste heißt jetzt „Settings“ und öffnet ein Fenster über der App, auch von der Startseite aus (Knopf in ihrer Kopfzeile). Links die Bereiche, bisher nur „Skills“. Dahinter ist die App gesperrt (`inert`), Escape schließt, bei Ungespeichertem mit Rückfrage (Save, Discard, Cancel).-- **Bibliothek:** mitgelieferte Skills (`resources/skills/`) und eigene in den App-Daten (`<App-Daten>/skills/`, unter Windows `%LOCALAPPDATA%\soma\skills`). Eine eigene Datei mit der Kennung eines mitgelieferten ersetzt diesen („Edited“), die mitgelieferte bleibt unangetastet. Was bisher nur für mitgelieferte galt (Panel, Stufen, Einstellungen mit `{{name}}`, Stufe für neue Modelle über `default:`), gilt für alle Skills der Bibliothek (`librarySkills` in `skills.ts`, Verwaltung in `skilllibrary.ts`).-- **Bereich „Skills“:** Liste nach Kategorien mit den Abzeichen „Edited“ und „Yours“, rechts der Text im Markdown-Editor (CodeMirror wie im Code-Panel), Vorschau als Dokument und bei bearbeiteten die mitgelieferte Fassung zum Vergleich (nur lesbar). Speichern mit Knopf oder Strg+S, „Discard“ verwirft. Die Stufe für neue Modelle steht im Kopf. „New skill“ fragt in einem Popover nach dem Namen und zeigt den Dateinamen vorab (Kennung aus dem Namen, Umlaute umschrieben, bei Gleichheit `-2`), die Vorlage erklärt den Kopf in Kommentarzeilen mit `#`. „Duplicate“ legt eine Kopie unter neuem Namen an (Titel, Name und erste Überschrift angepasst). „Import …“ übernimmt Markdown-Dateien, bei gleicher Kennung mit Rückfrage (ersetzen, als Kopie, überspringen). Der Ordner-Knopf öffnet den Ordner der eigenen Skills.-- **Prüfung beim Tippen (meldet nur, E28):** Leer oder über 256 KB verhindert das Speichern. Sonst Hinweise: kein Kopf, Kopf ohne Ende, unbekannte Schlüssel (etwa `Title:`), Zeilen, die keine Einstellung sind, Standardwert außerhalb des Bereichs, Platzhalter ohne Einstellung, ungenutzte Einstellung, unbekannte Stufe, fehlende `summary`, `category` oder `when`, kein Titel, kein Inhalt. Alle mitgelieferten Skills bestehen ohne Hinweis. Dateien im eigenen Ordner, die die App nicht liest (Großbuchstaben oder Leerzeichen im Namen, zu groß), stehen mit Grund und Vorschlag unter der Liste.-- **Nichts still überschreiben:** Löschen eines eigenen und Zurücksetzen eines bearbeiteten Skills nach Rückfrage, die Datei kommt nach `workspace-backups/skills-library/`. Ebenso eine Fassung, die außerhalb der App geändert wurde, während der Skill im Editor offen war, und eine beim Import ersetzte. Gleicht der gespeicherte Text der mitgelieferten Fassung, fällt die eigene Datei weg (gesichert).-- **Neuere App:** `state.json` merkt sich je bearbeitetem Skill einen Fingerabdruck der mitgelieferten Fassung, auf der er beruht (`skill_bases`). Bringt eine neuere App eine andere mit, zeigen Liste (gelber Punkt) und Editor einen Hinweis. Erneutes Speichern übernimmt den neuen Fingerabdruck.-- **Modelle:** Die Kopien in `.soma/skills/` bleiben, wie sie sind. Hat das offene Modell den Skill eingeschaltet, sagt das die Meldung nach dem Speichern, das Panel zeigt „The copy differs from the current version“, Aus und wieder Ein übernimmt die neue Fassung (die alte Kopie kommt in die Sicherung). Ein gelöschter eigener Skill bleibt in Modellen, die ihn nutzen, das Panel meldet, dass es ihn nicht mehr gibt. Die Karte im Panel nennt die Herkunft und hat „Edit“, der Stift oben im Panel öffnet die Einstellungen.-- **Editor:** Der Kopf zwischen zwei `---` ist im Markdown-Editor ein eigener, gedämpfter Block (vorher las der Parser ihn als Überschrift und zeigte ihn fett), auch im Code-Panel.-- **Grenzen:** Eigene Skills liegen nur auf diesem Rechner, über ein Modell wandert nur die Kopie, nicht zurück in die Bibliothek. Die Kennung lässt sich nicht umbenennen, einen Export gibt es nicht (der Ordner-Knopf zeigt die Datei). Getestet unter Windows.--*Dateiformat .soma (E79, Wunsch des Nutzers; Prüfungen in `app/test/versions.mjs`):*--- **Speichern:** Der Dialog bietet nur `.soma` an. Ohne Endung oder mit `.zip` eingegeben wird daraus `x.soma`, eine so entstandene vorhandene Datei ersetzt die App erst nach Rückfrage (den Namen hat der Dialog nicht gesehen). „Speichern unter“ schlägt den Ordner der bisherigen Datei vor. Innen ist die Datei unverändert die ZIP von E21.-- **Ältere Modelle und geöffnete ZIPs:** Steckt ein Modell noch in einer `.zip`, fragt das nächste Speichern einmal nach dem Ort, vorgeschlagen ist dieselbe Datei mit `.soma` daneben. Die ZIP bleibt unverändert liegen, danach ist die `.soma` die Modelldatei. Abbrechen speichert nichts.-- **Öffnen:** `.soma` und `.zip` im selben Filter, gleicher Ablauf wie bisher (E21). Meldungen und Rückfragen sprechen von „file“ statt „ZIP“, der Knopf heißt „Load file“.-- **Export „Everything as ZIP“** im Export-Menü (Abschnitt „WHOLE MODEL“): dieselben Dateien wie die `.soma`, vorher wird wie beim Speichern der Build abgewartet und der Verlauf gepackt, aber **kein Snapshot**, und die Modelldatei und der Speicherstand bleiben, wie sie sind. Änderungen seit dem letzten Commit stecken nur als Dateien darin, der Marker sagt das (`dirty`), dann gilt die ZIP beim Öffnen nie als identisch mit dem Arbeitsordner. Die eigene Modelldatei lässt sich nicht als Ziel wählen. Noch nicht gespeicherte Eingaben im Editor fehlen, die Meldung nennt sie.-- **Grenzen:** Ohne Installer gibt es noch keine Verknüpfung der Endung mit der App (Doppelklick auf eine `.soma`). Interne Namen (`zipPath`, `openZip`, `.soma/zip-info.json`) bleiben, damit gespeicherte App-Daten passen. Getestet unter Windows.--*DXF-Ansicht (E80, Wunsch des Nutzers; 23 Prüfungen in `app/test/dxf.mjs`):*--- **Öffnen:** Klick auf eine `.dxf` im Dateibaum, „Open“ im Kontextmenü oder ein Link in einer Markdown-Datei öffnet sie als Reiter im Code-Panel wie eine PDF, nur zum Lesen. Vorher kam nur der Hinweis, dass die App keine Ansicht dafür hat.-- **Zeichnen (`python/soma/dxfview.py`, `app/src/main/dxf.ts`):** `soma dxfview <datei> --out <json>` (versteckt, nur für die App, über den vorgewärmten Python-Prozess) liest mit `ezdxf.recover` und zeichnet mit dem Zeichenmodul von ezdxf, demselben wie für PDF und Bild der technischen Zeichnungen (E76): Linientypen als Striche, Schraffuren, Maße, Texte in der Schrift der Zeichnungen, Blöcke, Splines, Ellipsen, Bilder als Rahmen. Heraus kommen Stapel je Art (Linie, Fläche, Text, Punkt), Layer, Farbe und Strichstärke mit Pfadbefehlen M, L, Q, C, Z. Bögen und Schrift bleiben Kurven und sind bei jedem Zoom glatt. Die Koordinaten sind relativ zur Mitte und auf rund sieben Stellen gerundet, so reichen 32 Bit auch weit vom Ursprung. Der Renderer baut daraus `Path2D` und zeichnet auf einer Canvas (`app/src/renderer/dxfview.ts`). Ein A3-Blatt mit 744 Objekten braucht rund 1 s, direkt nach einem anderen Auftrag der App bis zu 4 s (der nächste vorgewärmte Prozess lädt noch cadquery).-- **Bedienen:** Mausrad zoomt am Zeiger, Ziehen mit linker oder mittlerer Taste verschiebt, Doppelklick passt ein, dazu Knöpfe und die Tasten +, −, 0. Die Leiste zeigt die Größe mit Einheit (`$INSUNITS`) und die Koordinaten unter dem Zeiger auf einen Bildpunkt genau. Dunkler Grund wie im Modellbereich eines CAD-Programms, ezdxf macht Farbe 7 deshalb hell. Strichstärken in Bildschirmpunkten unabhängig vom Zoom (0,25 mm 1 px, höchstens 6 px), auf Papier skaliert würden sie beim Hineinzoomen die Details verdecken.-- **Layer:** Menü „Layers“ mit Farbe und Haken je Layer und „Show all“. In der Datei aus- oder eingefrorene Layer zeichnet soma trotzdem, die Ansicht blendet sie zunächst aus und kennzeichnet sie („off in file“). Solange etwas ausgeblendet ist, zeigt der Knopf „Layers 4/5“.-- **Für den Agenten:** „Mark up view“ legt die Ansicht in doppelter Auflösung auf die Zeichenfläche der Markierung. Ist nur ein Ausschnitt zu sehen, nennt die Notiz ihn in Koordinaten der Datei (`[Markup: …, drawn on cut/plate.dxf, area x 73.33 to 126.67, y 2.95 to 81.67 mm]`).-- **Von außen geändert:** Nach jeder Dateiänderung fragt die Ansicht mit dem Fingerabdruck (Größe, Änderungszeit) nach, gezeichnet wird nur bei einer neuen Fassung. Ausschnitt (in Koordinaten der Datei) und Layerwahl bleiben, eine eingepasste Ansicht passt neu ein. Ist die Datei weg, geht der Reiter zu. Laufende Aufträge werden nicht verdoppelt.-- **Melden statt reparieren (E28):** Beschädigte Dateien liest `ezdxf.recover` so weit wie möglich, die Ansicht nennt die Zahl der Probleme, die Datei bleibt unverändert. Was ezdxf nicht zeichnen kann (etwa 3D-Körper ohne Ersatzgrafik), nennt ein Hinweis („Not shown: 1 × 3DSOLID“), unsichtbare Objekte und zu kleiner Text nicht. Keine DXF: Meldung in der Ansicht. Ist der Modellbereich leer, zeigt sie den ersten Papierbereich mit Inhalt und sagt es. Dateien über 200 MB lehnt sie ab, über 6 Millionen Zahlen zeichnet sie nur einen Teil, beides mit Hinweis.-- **Grenzen:** Nur ansehen, kein Messen, Auswählen oder Bearbeiten, keine Wahl zwischen Papierbereichen, keine DWG. Große Dateien (Zehntausende Objekte) nicht gemessen. Getestet unter Windows.--*Einstellungen: Viewer, Speicher, Info (E81, Wunsch des Nutzers; 45 Prüfungen in `app/test/settings.mjs`, 6 in `app/test/unit.mjs`):*--- **Fenster:** Reiter Viewer, Skills, Storage, About links (`#st-nav`). Ohne Ziel öffnet der zuletzt gezeigte Reiter, beim ersten Mal Viewer, „Edit“ an einem Skill öffnet Skills. Strg+S gilt nur im Reiter Skills. Werte gelten sofort, ohne Speichern-Knopf, und stehen in `<App-Daten>/settings.json` (`app/src/main/settings.ts`, Prüfung in `app/src/shared/settings.ts`), getrennt vom Zustand der App in `state.json`.-- **Mausbelegung (`viewer.ts`):** SOMA wie bisher (links drehen, rechts verschieben, Mitte zoomen, Umschalt oder Strg tauschen Drehen und Verschieben), SolidWorks (Mitte drehen, Strg + Mitte verschieben, Umschalt + Mitte zoomen), Fusion 360 und Inventor (Mitte verschieben, Umschalt + Mitte drehen), Onshape (rechts drehen, Strg + rechts oder Mitte verschieben), Creo, NX und Blender (Mitte drehen, Umschalt + Mitte verschieben, Strg + Mitte zoomen), Rhino (rechts drehen, Umschalt + rechts verschieben, Strg + rechts zoomen). Das Mausrad zoomt immer. Beim Drücken einer Taste setzt der Viewer vor OrbitControls die Bewegung genau dieser Taste, mit gehaltener Taste das Gegenstück (OrbitControls tauscht Drehen und Verschieben von sich aus). Die Einstellungen zeigen die Belegung als Legende.-- **Auswählen nur noch links:** Ein Klick wählt nur mit der linken Taste aus (vorher auch rechts und in der Mitte), sonst würde jedes kurze Drehen mit der Mitte oder rechts etwas auswählen. Doppelklick setzt weiter den Drehpunkt.-- **Zoomrichtung:** „Invert zoom“ dreht Mausrad und Zoomen durch Ziehen um (negative `zoomSpeed` in OrbitControls).-- **Orthografisch:** Eine zweite Kamera. Beim Umschalten bleiben Blickrichtung, Drehpunkt und die Bildhöhe in der Ebene des Drehpunkts (Maßstab aus dem Abstand und 35°), das Bild springt nicht. Die Kamera rückt auf der Blickrichtung so weit zurück, dass das ganze Modell vor ihr liegt, sonst schnitte die vordere Ebene es an und Strahlen zum Auswählen begännen darin. Verdeckte Punkte und Kanten beim Messen prüft der Viewer dann mit parallelen Strahlen. Einpassen, Ansichtswürfel, Zoomen zur Mausposition, Schnitt, Explosion und Messen gehen wie perspektivisch. Eine Animation mit „Kamera“ setzt den Maßstab aus dem Abstand ihrer Kamera.-- **Beim Öffnen eines Modells:** Kanten, Drahtgitter und Transparent im Menü „Display“ stehen dann wie eingestellt, auch beim Modell, das beim Start offen ist. Eine Änderung in den Einstellungen wirkt erst beim nächsten Modell, das Menü ändert sie für das offene.-- **Nachkommastellen (0 bis 4, Vorgabe 2 wie bisher):** Werte in der Messkarte, an der Messlinie und die Maße des Bauteils dort. Eine offene Messung zeigt eine Änderung gleich. Der Text für den Agenten behält drei Stellen, Winkel eine.-- **Storage (`app/src/main/storage.ts`):** Größe der App-Daten insgesamt und je Bereich: Modelle (Arbeitsordner mit Zahl), Sicherungen, Vorschau-Cache, Bilder der Startseite, eigene Skills, Übriges (Caches von Chromium, `state.json`, `settings.json`). Verknüpfungen zählen nicht. Je Bereich ein Knopf, der den Ordner öffnet (der Renderer nennt nur die Kennung des Bereichs, nie einen Pfad). Leeren lässt sich nur der Vorschau-Cache, nach Rückfrage, die Vorschauen des offenen Modells bleiben (eine gezeigte oder vermessene Vorschau liest dort). Sicherungen löscht die App nicht, die Seite sagt das.-- **About (`app/src/main/about.ts`):** Versionen von SOMA, soma, Python, CadQuery, OCP, Electron, Chromium, Node.js, Git und System, die vier bekannten Agenten mit gefunden oder nicht, Ordner (App-Daten, eigene Skills mit Knopf zum Öffnen, Python, Programm), Komponenten mit Version und Lizenz. Die npm-Pakete schreibt `esbuild.config.mjs` beim Bauen aus ihren `package.json` nach `dist/main/components.json`, die Python-Pakete liest ein kurzer Python-Aufruf aus ihren Metadaten (einmal je Sitzung, ohne cadquery zu laden). Links zu Projektseite, Changelog, Lizenz und Model Exception auf GitHub. „Copy system info“ legt einen kurzen Text für Fehlermeldungen in die Zwischenablage (über den Hauptprozess, im Test in eine Variable statt in die echte Zwischenablage).-- **Kaputte settings.json:** Kein JSON oder unbekannte Werte (etwa eine Belegung, die diese App nicht kennt): Es gelten die Vorgaben für das, was nicht passt, der Reiter Viewer nennt das Problem. Die nächste Änderung schreibt eine neue Datei, die alte kommt vorher als `workspace-backups/settings-<Zeit>.json` in die Sicherung.-- **Grenzen:** Das Render-Fenster für `soma render` bleibt immer perspektivisch und mit den Vorgaben, Bilder des Agenten hängen nicht von den Einstellungen des Nutzers ab. Mausbelegungen ohne Touchpad-Gesten. Getestet unter Windows.--*Strukturbaum im Viewer, Reiter Analysis und Animation (E82, Wunsch des Nutzers, Entwurf in `design/strukturbaum-entwurf.html`; Prüfungen in `app/test/groups.mjs`, `smoke.mjs`, `fem.mjs`, `animation.mjs`, `fasteners.mjs`):*--- **Leiste (`index.html`):** Parameters und Files, Strich, Analysis und Animation, Strich, Skills. Der Reiter Parts und der Umschalter oben links im Viewer sind weg. Ein orangener Punkt am Reiter Analysis oder Animation heißt: Der Agent hat etwas Neues erzeugt (Ergebnis, Animation, Video), das noch in keinem geöffneten Reiter stand. Beim ersten Start ist die Seitenleiste zu, die Reiter Analysis und Animation werden nicht über einen Neustart gemerkt.-- **Strukturbaum (`app/src/renderer/tree.ts`, ersetzt `parts.ts`):** ganz oben links im Viewer, ohne Fläche, Schrift, Striche und Symbole mit dunklem Rand. Eingeklappt nur Symbol und Name des Modells, mit „· 3 hidden“, wenn etwas ausgeblendet ist. Aufgeklappt Gruppen und Teile mit Baumstrichen, je Zeile Pfeil (Gruppe), Auge, Halbkreis und Name, bei Gruppen die Zahl der Teile. Knöpfe gedämpft, hell nur, was wirkt (ausgeblendet, transparent in Orange, teilweise transparente Gruppe blasser). Klick auf den Namen wählt das Teil (orange), auf eine Gruppe klappt sie auf und zu, Rechtsklick öffnet das Menü wie bisher. Zeilen lassen sich nicht mehr ins Terminal ziehen (Wunsch des Nutzers, dafür gibt es „Send to agent“ in der Auswahlkarte). Referenzen stehen als Gruppe „References“ am Ende. Alle Gruppen beginnen zugeklappt, Aufklappen zeigt eine Ebene. Ein Klick ins Modell markiert das Teil im Baum, steckt es in einer zugeklappten Gruppe, die Gruppe, und holt die Zeile in den sichtbaren Bereich. Schlanke Scrollleiste ohne Pfeile, im Baum kaum zu sehen, solange die Maus nicht darüber ist. Im Fuß „3 hidden · Show all“. Lupe im Kopf sucht (Gruppen gehen dabei auf, „1 of 6“). Höchstens halb so hoch wie das Bild, dann scrollt er. F3 klappt auf und zu (nicht im Code, Terminal oder in Feldern). Neben dem aufgeklappten Baum zeigen die Werkzeuge oben nur Symbole, wenn der Platz fehlt (`fitDock` in `main.ts`).-- **Mehrfachauswahl, Tasten, Rechtsklick (Wunsch des Nutzers nach der zweiten Durchsicht):** Baum und Viewer teilen eine Auswahl. Strg+Klick nimmt ein Teil dazu oder heraus, Shift+Klick nimmt im Viewer dazu und wählt im Baum den Bereich vom letzten Klick bis hier. Alt + links ziehen im Viewer ist eine Rahmenauswahl (in jeder Mausbelegung frei): von links nach rechts nur Teile ganz im Rahmen, von rechts nach links auch angeschnittene (Ecken der Netze und ein Raster aus Strahlen), mit Shift oder Strg dazu. Mit gedrückter Maus über die Augen im Baum fahren schaltet alle überfahrenen Zeilen gleich (wie die Ebenen in Photoshop), ebenso die Halbkreise. Tasten: H ausblenden (die Auswahl wird dabei aufgehoben), Shift+H alles einblenden, I isolieren, T transparent, Esc Auswahl aufheben, nicht beim Schreiben in Code, Terminal oder Feldern. Rechtsklick ohne Ziehen geht jetzt auch im Bild: auf ein Teil das Menü wie im Baum (es wird dabei ausgewählt), auf die Auswahl ein Menü für alle („Isolate 6 parts“), daneben „Show all“ und „Clear selection“. Die Auswahlkarte zeigt bei mehreren Zahl und Namen, „Send to agent“ nennt alle. Neuer Reiter „Shortcuts“ in den Einstellungen mit allen Tasten und Mausgesten (`shortcuts.ts`), die Navigation nach der gewählten Mausbelegung.-- **Ein Zustand:** Aus- und eingeblendet und transparent liegen im Viewer und gelten in Modell, Analyse und Animation gleich. In der Analyse stehen im Baum nur die gerechneten Körper, gegliedert wie im Modell.-- **Reiter Analysis (`analysispanel.ts`):** Klick auf den Reiter zeigt die Liste, ist schon ein Ergebnis im Bild, dessen Bericht. Von selbst kommt nichts ins Bild, erst ein Klick in der Liste (E86). Liste mit Statuspunkt, Titel, Art und Zeit, „older than the code“, „new“ und dem Wert rechts. Der Bericht: Titel, Art, Rechenzeit, Netz, Zeit. Eine Zahl groß (kleinste Sicherheit, sonst kleinster oder größter Wert mit Einheit), darunter gefordert oder Grenzwert und ob es hält, die kritischen Teile mit Sprung zur Stelle („Show the spot“: Blick auf die ungünstigste Stelle mit Beschriftung), ein Hinweis, wenn die Spitze vom Netz abhängt. INPUTS je Zeile zum Aufklappen: Lager (Richtungen, Flächen, Lagerkraft, Gleichgewicht), Kraft oder Druck, Schwerkraft, Werkstoff (E-Modul, Festigkeit und zulässige Spannung, Querdehnzahl, Dichte), Netz (Größe, automatisch oder aus der Studie, Elemente, Knoten, Prüfung mit gröberem Netz). Ohne FEM Grenzwert und Teile. PARTS als Tabelle, CALCULATION und NOTES zum Aufklappen. Unten die gemerkte Stelle, „Recalculate“ und „Send to agent“. Veraltet: Zeile „Values belong to the model as it was at …“ mit Recalculate, beim Rechnen Fortschrittsstrich und blasse Zahlen. Kopf: „‹ Analyses“ zur Liste, Studie öffnen, Menü (Befehl kopieren, Modell zeigen).-- **Im Bild (`resulttool.ts`):** schmale Legende senkrecht unten rechts über der Leiste (zuerst unter dem Würfel, dort blockierte sie die Mitte des Bilds) (nach der ersten Durchsicht des Nutzers, vorher 150 px breit und im Weg): Kopf kurz („Safety“, „MPa“, „mm“), darunter der Knopf „Auto ▾“ mit der gewählten Spanne, Verlauf mit drei Zahlen und dem Grenzwert als Strich mit Zahl. Der Knopf öffnet links daneben das Menü der Farbskala mit der Größe ausgeschrieben, Auto, Min to max, Custom mit eigenen Grenzen und was die Farben heißen. Leiste unten: Safety factor, Stress, Displacement (neu, Betrag der Verschiebung, ohne Grenzwert), Verformung Off, 1×, vorgeschlagene Überhöhung, Load case, ×. Ohne FEM nur Name und ×. Beschriftungen im Bild: Kraft am Ende jedes Pfeils, „Min“ an der kleinsten Sicherheit, bei Spannung und Verschiebung „Max“ an ihrer größten Stelle, ausgeblendete Teile ohne Beschriftung.-- **Reiter Animation (`animpanel.ts`, `animtool.ts`):** Liste der Animationen mit Fehlern der Dateien und darunter die Videos aus `renders/`. Der Ablauf zeigt Name, Dauer, bewegte Teile, Bauen oder veraltet, die Schritte (aus den Untertiteln, ohne Untertitel die Bewegungen aus der Datei, Klick springt hin, der aktuelle ist hervorgehoben) und die Videos dieser Animation (Dateiname beginnt mit ihrer Kennung). Unten „Make video“ und „Send to agent“. Im Bild die Abspielleiste: Abspielen, Zeit, Zeitleiste mit Marken der Schritte, Dauer, Tempo, Camera, Loop, Texts, ×. Untertitel stehen über der Leiste.-- **Daten (`python/soma/fem.py`):** Die Ergebnisse der FEM nennen je Werkstoff jetzt auch Querdehnzahl und Dichte, und beim Netz, ob die Größe automatisch kam (`mesh.auto`). Ältere Ergebnisse zeigen den Bericht ohne diese Zeilen.-- **Grenzen:** Der Baum merkt sich Auf- und Zuklappen nur bis zum Neustart. Mehr als eine Spitze je Größe wird nicht beschriftet. Getestet unter Windows.--*Nutzeranleitung (E83, Wunsch des Nutzers; Prüfungen in `app/test/unit.mjs` und `skills.mjs`):*--- **Eine Quelle:** Die Anleitung ist der mitgelieferte Skill `app/resources/skills/soma-app.md` („Using the app“, Kategorie Way of working, ab Werk „Bei Bedarf“, Anlass: der Nutzer fragt nach der Bedienung). Je Bereich ein Abschnitt `##` mit Bild und nummerierter Liste, die Nummern im Bild entsprechen der Liste. Die Hilfe der App zeigt denselben Text ohne Kopf, ohne Hauptüberschrift und ohne die Teile zwischen `<!-- agent -->` und `<!-- /agent -->` (`app/src/shared/help.ts`). Dort steht nur eine kurze Anweisung an den Agenten: Bilder öffnen, Knöpfe beim Namen nennen, nichts erfinden.-- **Bilder (`app/resources/help/*.png`):** erzeugt aus der echten App mit `npm run help:shots` (`app/test/helpshots.mjs`, Fenster außerhalb des Bildschirms, Terminal mit kurzem Prompt ohne Benutzerpfad). Ausschnitt und Nummern je Bild stehen in `app/test/helpshots-spec.mjs`: Selektor, Stelle der Nummer, gestrichelter Rahmen für Bereiche. Gelbe Nummern mit dunklem Rand, damit sie sich von Orange (Auswahl) abheben. Elf Bilder, zusammen rund 2.3 MB. `npm run test:unit` prüft, dass jedes Bild benutzt wird und vorhanden ist und dass die fetten Bezeichnungen unter jedem Bild genau den Markierungen entsprechen.-- **Für den Agenten:** Der Skill kommt wie jeder andere nach `.soma/skills/`. Die Bilder kopiert die App nach `.soma/help/`, sobald der Skill an ist, beim Öffnen eines Modells und beim Umstellen der Stufe (`app/src/main/help.ts`, nur abweichende Dateien). Der Text verweist relativ auf `../help/<bild>.png`, das stimmt von der Kopie aus und in der Markdown-Ansicht der App. `.soma/help/` ist ein Zwischenergebnis wie `.soma/drawings/`: in der `.gitignore` der Vorlage, in `.git/info/exclude` älterer Projekte, nicht in der Modelldatei.-- **In der App (`app/src/renderer/help.ts`):** Fenster wie die Einstellungen, links die Abschnitte, rechts einer davon mit derselben Markdown-Ansicht wie Notizen. Knopf „Help“ in der Leiste (bisher ausgegraut) und auf der Startseite, F1 öffnet und schließt, Escape schließt, Pfeiltasten wechseln den Abschnitt. Ein Klick auf ein Bild zeigt es in voller Größe. Die Hilfe liest immer die mitgelieferte Fassung, nicht eine in den Einstellungen bearbeitete.-- **Grenzen:** Analyse und Animation haben kein Bild (sie brauchen Ergebnisse des Agenten). Nach Änderungen an der Oberfläche müssen Bilder und Text von Hand nachgezogen werden, der Test fängt nur fehlende Elemente und abweichende Bezeichnungen. Getestet unter Windows.--*Verbesserungen aus der Kritik eines Agenten (E85, Wunsch des Nutzers; Prüfungen in `app/test/animation.mjs` und `drawing.mjs`):*--- **PDFs:** pdfplumber 0.11 (MIT, mit pdfminer.six und pypdfium2) in der Basisumgebung (`python/requirements-base.txt`). `AGENTS.md` nennt es in der Zeile zu `inputs/`, mit `page.to_image()` für ein Bild. Die Projektumgebung übernimmt die Versionen wie die übrigen Basispakete.-- **Achse:** Regel 6 in `AGENTS.md`: „Z is up, the front faces −Y (the front view looks from −Y), X points right.“ So wie Viewer, `soma render` und Zeichnungen „front“ verstehen.-- **soma render:** `--view` nimmt auch eine Richtung `x,y,z` vom Modell zur Kamera (mit führendem Minus als `--view=-1,0,0`, argparse hält es sonst für eine Option). `--hide` und `--only` (mehrfach) blenden Teile oder Gruppen aus, zusätzlich zu dem, was eine Animation ausblendet. `--fit` passt auf Teile ein, `--zoom` (0.05 bis 50) rückt näher. Mit einer Animation ersetzen Richtung, `--fit` und `--zoom` ihre Kamera wie bisher `--view`. Die Namen löst das Render-Fenster auf (Teil, Gruppe mit allem darunter, „Gruppe/Teil“), Unbekanntes ist ein Fehler mit der Liste der Teile und Gruppen. Im Viewer neu `viewFrom(dir, ids, zoom)`, `setView` nutzt es.-- **Animation:** `"Gruppe/Teil"` spricht ein Teil mit seiner Gruppe an. Der Skill sagt in einem Satz, dass große Bewegungen die Teile klein machen und `fit` oder `zoom` helfen.-- **Zeichnungen:** `sh.text_width(text, height)` misst mit der Schrift der Zeichnung (probeweise angelegter TEXT, wieder entfernt). `leader(..., side="left"/"right")`, ohne `side` wie bisher vom Punkt weg, jetzt im Docstring beschrieben. `sh.table(rows, at)` ohne `widths` oder mit `None` je Spalte: längster Text plus 4 mm, mindestens 8 mm. Der Docstring von `Sheet` und der Skill nennen das Bild richtig als `.soma/drawings/<id>.png`.-- **Grenzen:** Getestet unter Windows. pdfplumber liest Vektor-PDFs, eingescannte Pläne bleiben Bilder.--*CalculiX und Kontakt in der FEM (E84, Wunsch des Nutzers nach Vergleichsrechnung und Brainstorming; Prüfungen in `app/test/fem.mjs`):*--- **Rechenwerk:** `python/soma/ccx.py` schreibt Netz, Werkstoffe, Lager und die Knotenlasten von `fem.py` als Eingabedatei für CalculiX (C3D10, Knotenfolge von gmsh umgestellt), rechnet in einem Temp-Ordner und liest Verschiebungen und Kontaktgrößen aus der frd. Die Lagerkräfte rechnet `fem.py` aus den Verschiebungen (K u − f, nur Elemente an Lagern): Die Knotenkräfte (RF) aus der frd lagen beim Winkel aus dem Skill 5 % neben dem Gleichgewicht. Die Spannungen rechnet `fem.py` weiter selbst aus den Verschiebungen (je Teil, CalculiX mittelt über Werkstoffgrenzen: im Winkel aus Stahl und Aluminium 45 statt 61 MPa). Ohne Steifigkeitsmatrix prüft `_check_jacobians` die Elemente. Vergleich auf demselben Netz: Verschiebungen gleich bis auf 1e-6, bei 10 000 bis 250 000 Unbekannten 2- bis 3-mal schneller als pyamg, bei 440 000 etwa gleich (CalculiX 3 GB Speicher). Der eigene Solver bleibt als Rückfallweg (ccx fehlt oder scheitert, nur ohne Kontakt, mit Hinweis) und lässt sich mit `SOMA_FEM_SOLVER=builtin` wählen. `SOMA_CCX_KEEP=1` lässt die Dateien von CalculiX zur Fehlersuche liegen.-- **Auslieferung:** `python/scripts/fetch_ccx.py` holt mit micromamba calculix 2.23 und OpenBLAS von conda-forge (ohne Vorgabe nimmt conda unter Windows MKL, 680 MB) und kopiert nur das Nötige nach `<sys.prefix>/ccx`: unter Windows `ccx.exe` und die DLLs aus den Importtabellen (11 Dateien, 53 MB, gezippt 16 MB), unter Linux und macOS `bin/` und `lib/`. Dazu `PACKAGES.txt` und die Lizenztexte. `setup_env.ps1` ruft es auf. Gefunden wird ccx über `SOMA_CCX`, neben der Umgebung oder im PATH. ccx läuft mit der Hälfte der logischen Kerne (höchstens 8) und unter Windows mit einem PATH nur aus dem eigenen Ordner und System32.-- **Berührende Teile:** gmsh vernetzt die Teile weiter gemeinsam, gemeinsame Elementflächen verschiedener Teile sind die Berührflächen (`_interfaces`). Das Ergebnis nennt jedes Paar mit Fläche (`touching: Fuss – Wand (200.0 mm²), bonded`), verklebt bleibt der Standard.-- **Kontakt:** `study.contact(a, b, friction=0)`. Die Knoten der Berührfläche werden für das weichere Teil (bei gleichem E das zweite) verdoppelt (`_split`), Lasten und Lager dieses Teils ziehen mit. CalculiX rechnet Fläche auf Fläche, Steifigkeit gleich dem kleineren E-Modul (das Zehnfache brauchte bei einer Platte mit Arm 18 statt 11 Iterationen, bei einer fast ganz abhebenden Platte pendelte es ohne Ende; Verschiebungen 0,4 % anders), Haftsteigung gleich dem E-Modul, die ganze Last im ersten Schritt (mit Vierteln 18 statt 5 Iterationen). Vor der Rechnung prüft `_check_held` auch Kontakte: mit Reibung halten sie wie verklebt, ohne Reibung nur senkrecht zur Fläche (Block auf Block ohne Reibung: „held only by a contact without friction“).-- **Überwachung:** CalculiX bricht bei einem Teil, das wegrutscht, nicht von selbst ab (Verschiebungen bis 1e11 mm, minutenlang). `ccx.py` liest die Ausgabe mit und bricht ab, wenn eine Verschiebung das Zehnfache der Modellgröße erreicht (Meldung: rutscht oder hebt ab) oder eine Laststufe mehr als 30 Iterationen braucht (insgesamt 60). Bis 0.5.0 waren es 12: Das Freigeben der Berührfläche Iteration für Iteration galt dann schon als Pendeln (Bericht eines Testagenten, Halter an der Wand). Pendelt der Kontakt (eine Platte, die fast ganz abhebt: 88 Iterationen), rechnet `fem.py` mit einem weichen exponentiellen Kontaktgesetz neu (Spalt c0 = 1e-4 der Modellgröße, 2 µm bis 0,05 mm, Druck bei Spalt 0 ein Zwanzigstel der mittleren Pressung, wenn die ganze Last über die Fläche ginge, dort 4 Iterationen) und meldet das. Der frühere Druck E/70000 (3 MPa bei Stahl) drückte leicht belastete Teile auseinander. Mortar-Kontakt konvergierte dort nicht. Mortar-Kontakt konvergierte dort nicht.-- **Kennzahlen:** Pressung und Schub von CalculiX. Spalt und Gleitweg rechnet `fem.py` aus den Verschiebungen gegenüberliegender Knoten (CalculiX gibt die Öffnung nur nahe der Fläche aus). Die getragene Kraft kommt aus dem Gleichgewicht an den Knoten der Slave-Seite (innere Kräfte ihrer Elemente minus Lasten und Lagerkräfte dort), wenn die Fläche eben ist, sonst aus dem Integral der Knotenpressungen. Das Integral lag an Kanten weit daneben (1058 statt 1000 N, an einer klaffenden Fuge 13 858 statt 8000 N), das Gleichgewicht des ganzen Teils (bis 0.5.0) gilt nicht, sobald das Teil an einer Schraube hängt. Mit Kontakt kommen die Lagerkräfte von CalculiX (RF aus der .dat, minus die Lasten auf gehaltenen Knoten, die CalculiX nicht mitzählt): Drückt ein Kontakt auf eine Kante der gehaltenen Fläche, fehlt seine Kraft in den Elementkräften (Durchsteckschraube: 56 % aus dem Gleichgewicht). Offen heißt mehr als 2 c0 Spalt, gleitend heißt Schub ab 95 % der Haftgrenze. Hinweise ab 50 % offen oder gleitend.-- **In der App:** Größe „Contact pressure“ (Knopf „Contact“, ausgeschrieben passte die Leiste mit dem × nicht mehr ins Bild; Attribut `_PRESS`, beide Seiten der Fläche, kein Grenzwert, Verlauf bis zur größten). Die Flächen liegen zwischen den Teilen: Beim Wählen sagt ein Hinweis, dass man ein Teil ausblenden oder schneiden muss, der Baum bleibt unverändert, „Max“ an der höchsten Pressung, Pressung im Schild unter dem Zeiger und in „Send to agent“. Im Bericht je Kontakt eine Zeile (Reibung, Kraft, Pressung, offen, gleitet, Gleitweg) und eine Zeile „Touching · Bonded“ für die verklebten Paare, beim Netz das Rechenwerk.-- **Für den Agenten:** Skill „Strength with FEM“ mit Abschnitt „Parts that touch“ (Tabelle verklebt, `contact()`, mit Reibung, Reibwerte), die Grenzen nennen kleine Gleitwege statt „kein Kontakt“.-- **Zeiten (8 Threads):** Block auf Block mit Reibung, 51 000 Unbekannte: rund 70 s (unsymmetrisches Gleichungssystem, rund 10 s je Iteration). Zwei Platten, die abheben: 38 s mit dem Rückfall. Ohne Kontakt wie vorher oder schneller.-- **Schrauben:** `study.bolt(screw, preload=None, grade="8.8")` für eine `Screw` aus `soma.fasteners` (die Registry hält das Normteil im Speicher, `fastener`). `soma` nimmt alles dazu, was die Schraube berührt, weiter über Mutter und Scheibe (`_bolt_groups`), gibt diesen Normteilen Stahl der Festigkeitsklasse und schneidet die Schraube aus Teilen, in die sie hineinragt (Kernloch kleiner als der Schaft, sonst ein dünner Ring verzerrter Elemente). Das Gewinde beginnt, wo 0,51 d neben der Achse Material liegt (Durchgangslöcher nach ISO 273 sind mindestens 1,05 d), in der Mitte der freien Länge darüber wird der Schaft geteilt (zwei Körper, eben vernetzt). `_cut_shank` verdoppelt dort die Knoten der Spitzenseite, `ccx.py` koppelt beide Seiten mit `*EQUATION`: gleiche Verschiebung bis auf einen Versatz entlang der Achse, der die Verschiebung eines eigenen Knotens ist. Schritt 1 zieht ihn mit der Vorspannkraft, Schritt 2 hält ihn fest (`*BOUNDARY, FIXED`) und bringt die Lasten auf, seine Lagerkraft ist die Schraubenkraft. `*PRE-TENSION SECTION` von CalculiX tut dasselbe, verdoppelt die Knoten aber intern: Die Spannungen, die `soma` aus den Verschiebungen rechnet, wären am Schnitt falsch. Querkraft aus den inneren Kräften der Spitzenseite am Schnitt, Auslastung aus Zug und Schub im Spannungsquerschnitt gegen Rp0,2 (Meldung ab 90 %). Vorspannung ohne Angabe 70 % von Rp0,2 im Spannungsquerschnitt, höchstens Festigkeit mal Auflagefläche des ersten verschraubten Teils unter dem Kopf (M3 in PLA: 325 N). Kopf und Gewinde verklebt, die Fuge dazwischen ein Kontakt des Nutzers. Zeiten: Lasche M5 mit Kontakt 83 s (Netz 4 mm), verklebt 12 s, Platte M6 mit Querlast 3,6 min, Durchsteckschraube M8 mit Mutter und Scheibe 6 min.-- **Netz:** Klappen beim Krümmen der quadratischen Elemente einzelne um (Scheibe M8 auf der Mutter, 0,2 mm Ring), glättet gmsh sie elastisch (`HighOrderElastic`, wenige Sekunden). Nur dann, damit Netze ohne Fehler gleich bleiben.-- **Grenzen:** Kontakt nur, wo Flächen im Modell aufeinanderliegen (kein Anfangsspalt), kleine Gleitwege. Schrauben ohne Gewindegeometrie (am ersten Gang eine Spannungsspitze), Kopf verklebt (kann nicht abheben oder rutschen), ohne Torsion vom Anziehen und ohne Setzen. Teilen sich drei Teile eine Kante der Kontaktfläche, hängt das dritte dort am anderen Teil. Linux und macOS: `fetch_ccx.py` ungetestet. 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, weitere Bereiche der Einstellungen, maßhaltiger Sketcher (nur bei Bedarf).--## 11. Offene Punkte--**Noch nicht ausdrücklich bestätigt (Vorschläge von mir)**--- `AGENTS.md` und die Kommentare der Vorlage sind **auf Englisch** (Agenten befolgen englische Anweisungen zuverlässiger). Seit E73 ist auch die Oberfläche englisch-- App auf Englisch (E73): nur Englisch, keine Umschaltung der Sprache. IDs und Dateinamen der Skills bleiben deutsch (`3d-druck.md`), sonst müssten bestehende Projekte umziehen. Begriffe: „Mark up“/„Markup“ für Markieren, „Explode“ und „Exploded view“, „Section“, „Send to agent“, „issues“ für die Hinweise zum Projekt, Skill-Stufen Off, On demand, Always. „Show in Explorer“ und „Recycle Bin“ passen nur zu Windows-- App-Daten liegen unter Windows in `%LOCALAPPDATA%\soma`, nicht im Roaming-Profil (Arbeitsordner und Caches gehören nicht ins Netz)-- Vor der Veröffentlichung (2026-10-10): Der Prototyp aus Phase 0 und die Icon-Entwürfe sind aus dem Repo (im Git-Verlauf bis `v0.5.0`). Die Entwicklungsumgebung heißt `%LOCALAPPDATA%\soma-dev\venv` statt `cadide-phase0\venv-full`, gebaut von `python/scripts/setup_env.ps1` aus `python/requirements-base.txt`. Eine schon eingerichtete alte Umgebung lässt sich per Junction unter dem neuen Pfad einhängen-- 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 Modelldatei-- 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/`), 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)-- `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-- `AGENTS.md` der Vorlage (E67) nennt `pip install`, verbietet eigene Umgebungen, `--user`, `uv` und ein anderes Python und sagt, was bei einem Versionskonflikt mit der Basis zu tun ist. Bestehende Projekte behalten ihre `AGENTS.md`, bis es die Erneuerung nach E36 gibt-- Ältere Projekte (vor E58) bekommen die Zwischenergebnisse beim Öffnen in `.git/info/exclude`, der nächste Snapshot der App nimmt schon committete aus dem Index (die Dateien bleiben). Das ändert den Verlauf vorwärts, ohne Rückfrage (wie bisher bei `.soma/geometry/`)-- Ohne `.git` gibt es **keinen** Knopf „Verlauf neu anlegen“, nur die Meldung (sonst widerspricht es E28). Offene Frage: Für Nicht-Programmierer wäre ein ausdrücklicher Knopf freundlicher-- Änderung während eines Builds: laufenden Build fertig laufen lassen, danach genau ein weiterer (statt abbrechen und neu starten)-- Öffnen ohne Neubau (E66): Ob der letzte Build noch gilt, entscheiden die Zeitstempel der Dateien gegen den Start des Builds, nicht ihr Inhalt. Eine Änderung der soma-Bibliothek selbst fällt nur über `OUTPUT_FORMAT` auf, das von Hand erhöht wird, wenn sich die Ausgaben ändern. Ein fehlgeschlagener letzter Build wird beim Öffnen wiederholt (damit der Fehler frisch dasteht)-- Vorschau-Cache (E66): Vorschauen aus einem Build zeigen echte Rollen (Referenz halbtransparent, Zukaufteile), solche aus der STEP-Datei den Basismodus. Code-Verweise fehlen in beiden. Der Cache in den App-Daten (`previews/`) wird nicht von selbst aufgeräumt, seit E81 lässt er sich in den Einstellungen leeren-- Nach „Wiederherstellen“ bleibt die Vorschau bis zum Ende des folgenden Builds stehen, auch wenn er fehlschlägt (dann mit Fehlerkarte über dem wiederhergestellten Stand)-- Vorgewärmter Python-Prozess (E66): einer für die ganze App läuft ständig mit geladenem cadquery (Speicher gegen rund 3 s je Auftrag), schon ab dem Start. Er wird bei jeder Entnahme für den nächsten angelegt und beendet sich, wenn die App ihn verwirft oder abstürzt (stdin geschlossen). Nach dem Ergebnis beendet sich `soma build` sofort (`os._exit`), das Aufräumen von OCP und vtk kostete knapp 1 s-- Angezeigt wird nur die Gesamtdauer eines Builds vom Start bis zum Ergebnis, nicht mehr die Summe der Teilzeiten (die zeigte 0,1 s, obwohl man 4 s wartete). `soma build` im Terminal meldet ebenfalls die Gesamtzeit-- Oberfläche (E38): Funktionen, die noch fehlen (inzwischen nur noch Pakete), 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 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, 3-- Karten stapeln sich unten links (die erste unten), statt dass Schnitt und Explosion rechts stehen. Die Skill-Karte bleibt offen, bis man sie schließt (Kreuz, Escape, Zeile noch einmal), auch beim Umstellen. Neue Ergebnisse gelten als gesehen, sobald das Menü des Umschalters offen war, was beim Öffnen eines Modells schon da ist, gilt als gesehen-- Explosion: zwei Abspielknöpfe statt einem, damit die Richtung immer sichtbar ist. Ein Klick auf den anderen kehrt ohne Sprung um, Anhalten lässt den laufenden Schritt fertig laufen. „Weiter“ ist am Ende gesperrt, „Zurück“ am Anfang, bei 0 % setzen Schritt und Abspielen den Abstand auf 50 %. Über 0 % ohne Schrittmodus steht „Schritt N von N · Alle Schritte zugleich“-- Animation: Der Schalter „Texte“ gilt für die Sitzung, ein Video enthält die Texte immer. Ist er aus, sagt die Notiz zur Markierung „ohne Titel, Untertitel und Beschriftungen“. „Kamera folgen“ heißt in der Karte nur noch „Kamera“ (Platz)-- Analyse: Über einer Karte zeigt die Zeile in der Karte wieder die gewählte Stelle statt des Werts unter dem Zeiger. Mit Schnitt bekommen die Ergebnisnetze einen neutral grauen, schraffierten Deckel (die Farben gehören den Werten), auf der Schnittfläche gibt es keinen Wert. Die Schalter Transparent, Kanten und Drahtgitter wirken auch auf das Ergebnis-- Export (E63): Beim Einzelexport gilt der Name aus dem Dialog, Dateien, die soma zusätzlich schreibt (etwa eine `.bin` zu glTF), landen daneben. Vorgabe für den Dialog ist der zuletzt gewählte Ordner des Modells, sonst „Dokumente“-- Markierung (E16): Das Bild zeigt die Ansicht **ohne Auswahl-Hervorhebung** (die ist Orange wie der Stift und verschluckte die Zeichnung) und ohne schwebende Karten. Auflösung wie der Viewer in Gerätepixeln, keine Verkleinerung. Eine Strichstärke-- Markierung, Farben: Statt der drei Farbpunkte aus dem Entwurf steht ein Farbknopf mit Menü in der Leiste (10 Farben und eigene Farbe), sonst würde die Leiste zu breit. Eine Farbe gilt für alles Folgende und färbt eine ausgewählte Form gleich mit-- Markierung, Bearbeiten: eigenes Werkzeug „Auswählen“ statt Auswahl mit jedem Werkzeug (sonst verschöbe ein neuer Strich die Form darunter). Rechteck und Ellipse sind hohl und nur an der Linie greifbar, damit Formen darunter erreichbar bleiben. Text skaliert immer im Seitenverhältnis, das Textfeld steht beim Bearbeiten ungedreht-- Markierung: Eingefügt wird `[Markup: .soma/feedback/markup-JJJJMMTT-HHMM.png] ` (bis E73 `[Markierung: …markierung-…]`) (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). Bei den Kopien in `.soma/skills/` verweist der Grund auf das Panel „Skills“, das sie mit `project.json` und `AGENTS.md` zusammen umstellt. `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 zum Markieren (E52), das Bildprogramm des Systems über Rechtsklick „Mit Standardprogramm öffnen“. „Pfad an Agent geben“ fügt `[Datei: <Pfad>] ` ein-- Dateibaum, Symbole: nur die Form unterscheidet die Typen, nicht die Farbe (Farben haben feste Bedeutungen)-- Dateibaum, Skills (Wunsch des Nutzers, sie dort zu sehen): Gruppe „Skills“ unter den Markierungen, anfangs eingeklappt (ein neues Modell hat 17 Kopien). Die Zeilen zeigen die Dateinamen (`3d-druck.md`), nicht die englischen Titel aus dem Panel. Eigene Skills lassen sich dort nicht anlegen (dafür die Einstellungen, E78)-- 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 „+“-- Bilder markieren (E50): Ränder um das eingepasste Bild in der Farbe der leeren Fläche. Stand und Schnitt des Viewers stehen dann nicht im eingefügten Text-- Markdown (E51): Ansicht und Editor zum Umschalten statt WYSIWYG-Bearbeitung (der Quelltext bleibt so, wie der Agent ihn schreibt). Gerendert mit `marked` (MIT) direkt in DOM-Knoten, ohne `innerHTML`. HTML in der Datei wird nicht ausgeführt: Blöcke erscheinen als Quelltext, Tags im Text fallen weg (außer `<br>`). Bilder nur aus dem Projekt, Web-Bilder werden nicht geladen. Links öffnen nur `http`, `https` und `mailto` im Browser. Auch nur lesbare Dateien (`AGENTS.md`, Skills) erscheinen als Dokument, ihre Kästchen sind gesperrt. Ein Kopf zwischen zwei `---` ganz am Anfang (Front Matter der Skills) steht gedämpft als Quelltext vorn, nicht als Tabelle-- 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-- Editor-Konflikt: zwei Wahlmöglichkeiten mit Sicherung, **kein automatisches Zusammenführen** (E28). Sicherungen liegen in den App-Daten, nicht im Projekt, und werden nicht aufgeräumt-- Editor: Welche Dateien nur lesbar sind (siehe Schritt 5). Dateien in `inputs/` darf der Nutzer bearbeiten, der Agent laut `AGENTS.md` nicht-- Messen: eigener Modus über den Knopf „Messen“ (Klicks wählen dann Punkte, Kanten und Flächen statt Bauteile). Die wichtigste Angabe eines Paars ist der Abstand paralleler Ebenen, dann der paralleler Achsen, dann vom Punkt aus der zur Ebene, Achse oder Geraden (jeweils unbegrenzt gedacht), zwischen zwei Punkten ihr Abstand, sonst der kürzeste Abstand. Punkt zu Punkt nutzt die Klickpunkte, exakt auf die Elemente gelegt. Punkte haben Vorrang vor Kanten, Kanten vor Flächen. Mittelpunkte von Kreisen sind keine eigenen Punkte, sie stecken im Abstand der Mittelpunkte-- Messen: Messlinien kommen nicht mit ins Bild der Markierung (ohne ihre Beschriftung wären sie dort unverständlich). Einen Messbefehl für den Agenten (`soma measure`) gibt es noch nicht, der Agent bekommt Messungen über „An Agent geben“-- Messen: Die Geometrie liegt als BREP neben dem GLB (Größe etwa wie die STEP-Datei) und wird bei jedem Build ersetzt-- Ansichtswürfel: Ein Klick dreht nur, Drehpunkt und Abstand bleiben (kein Einpassen, damit man nah an einer Stelle bleiben kann). Einpassen und Standardansicht setzen den Drehpunkt zurück in die Mitte. Die Achsen haben die in CAD üblichen Farben (X rot, Y grün, Z blau), außerhalb der festen Farbbedeutungen der Oberfläche-- Drehpunkt per Doppelklick (auch im Messmodus), Zoomen zur Mausposition immer an-- Gruppen (E42): Import mit Struktur über eine eigene Funktion `import_assembly()`, `import_step()` fasst die Datei weiter zu einem Körper zusammen. Die oberste Baugruppe der Datei heißt wie im `add_part`-Aufruf. Alle Teile einer Baugruppe verweisen auf die Zeile dieses Aufrufs-- Transparenz einzelner Teile bleibt über neue Builds erhalten, geht aber wie das Ausblenden beim Öffnen verloren (nicht gespeichert)-- Schnitt: eine Ebene (kein Mehrfachschnitt, kein Schnitt nur durch ausgewählte Teile), Karte unten rechts. Anfangs mitten durchs Modell, weggeschnitten die Seite der Standardansicht. Bei „Fläche“ nur ebene Flächen, anfangs mitten durch deren Bauteil. Die Schnittfläche selbst ist nicht messbar, Messen geht über die Kontur. Der Schnitt wird nicht gespeichert-- Schnitt, Darstellung: Füllung in der abgedunkelten Bauteilfarbe mit Schraffur im Bildraum (Abstand und Breite fest in Pixeln), keine Füllung bei transparenten Teilen und Referenzen-- Skills (E17): Ablage in `.soma/skills/` wie in Abschnitt 4 (E17 nennt `skills/`). Inhalt und Oberfläche englisch (E73), IDs und Dateinamen deutsch wie bisher. Die mitgelieferten Skills sind Entwürfe, ihre Werte (Wandstärken, Bohrungen, Senkungen, Einschmelzmuttern, Einschraubtiefen, Dehnungen, Werkstoffwerte) sind übliche Richtwerte, keine Normauszüge. Die Maße der Normteile folgen den genannten Normen (Nennmaße)-- Skill-Inhalte (E45): Namen und Kennungen der neuen Skills, die Namen der Kategorien (E46), Skills ohne Einstellungen (Sauber modellieren, Normteile). Querverweise nur allgemein („der Skill für das Verfahren“), weil jede Kombination möglich ist-- Skills, Laser und Blech: `soma export --format dxf` schneidet das Teil in halber Höhe parallel zu XY. Stehende Platten und Abwicklungen bekommen deshalb einen Schalter `FLAT` in `model.py`, der sie flach auf XY registriert. Ein Export, der die Platte selbst flach legt, wäre bequemer (offen)-- Skills, Toleranzen: Die Einstellung „Spiel für Laserteile“ ist entfallen (jetzt „Schnittbreite“ im Laser-Skill). In `project.json` gespeicherte alte Werte werden still übergangen, wie jede unbekannte Einstellung-- Skills für neue Modelle (E46, E55): ab Werk „Immer“ sind die beiden Skills der Arbeitsweise und die Normteile (E48), alle übrigen „Bei Bedarf“. Die Vorgabe gilt für die ganze App (nicht je Nutzerprofil oder Projektvorlage), nur für „Neu“ und den ersten Start, nicht für geöffnete ZIPs. Einstellungswerte gehören nicht dazu, neue Modelle starten mit den Standardwerten. Die Auswahl steht im aufgeklappten Skill, eine Übersicht aller Vorgaben gibt es nicht-- Skill-Stufen (E55): `project.json` führt beide Listen ausdrücklich (`skills` für Immer, `skills_on_demand` für Bei Bedarf), was fehlt, ist aus. Ein Skill, den erst eine neuere App mitbringt, steht in bestehenden Modellen deshalb auf „Aus“, bis der Nutzer ihn umstellt (nichts ändert ein Modell still beim Öffnen). Alte Modelle bekommen keine Umstellung-- Skill-Stufen: Der Anlass für `AGENTS.md` steht als englischer Nebensatz im neuen Kopffeld `when`. Die Liste „Bei Bedarf“ steht in Panel-Reihenfolge, „Immer“ in der Reihenfolge des Umstellens. Einstellungen lassen sich auch bei „Bei Bedarf“ ändern, der Hinweis in der Kopie nennt sie dann als vom Nutzer gesetzt. Die Sätze „The user set these values in the app“ in den Skills heißen jetzt neutral „Settings from the app“, weil die Werte bei Bedarf meist Standard sind-- Skill-Stufen, Oberfläche: Umschalter mit drei Feldern unter der Kurzbeschreibung (orange die gewählte Stufe), Karte bei „Immer“ orange getönt, bei „Aus“ blasser Text. Die Vorgabe für neue Modelle als Auswahlliste-- Skills, 3D-Druck: Die Überhangsuche im Skill prüft nur ebene Flächen. Gekrümmte Flächen (waagerechte Bohrungen, Rundungen unten) prüft der Agent im Viewer-- Skills: Die Kopie im Projekt bleibt beim Update der App, wie sie ist (gilt für das Modell, wandert mit). Aus- und Einschalten übernimmt die neue Fassung, die alte kommt in die Sicherung. Einen eigenen Knopf „Aktualisieren“ gibt es nicht-- Skills: Nach dem Umstellen fügt die App nichts von selbst in die Eingabe des Agenten ein, nur auf „An Agent geben“-- Skill-Einstellungen: nur Zahlen mit Bereich und Auswahllisten, kein freier Text. Einstellbar nur Skills der Bibliothek, mitgelieferte und eigene (E78), nicht solche, die nur im Projekt liegen (nur die Bibliothek hat den Text mit Platzhaltern). Die Werte gelten je Modell, es gibt keine App-weiten Vorgaben (etwa „mein Drucker“). Welche Werte es gibt und ihre Bereiche sind Entwürfe-- Eigene Skills (E78): gelten für die ganze App und liegen in den App-Daten, nicht je Modell und nicht zwischen Rechnern abgeglichen. Einen mitgelieferten zu ändern legt eine eigene Fassung mit derselben Kennung an, die ihn überall ersetzt, auch in neuen Modellen. Der Knopf heißt „Settings“ (Wort des Nutzers) statt „Options“ aus dem Entwurf. Fenster über der App statt einer eigenen Seite, links Bereiche (seit E81 Viewer, Skills, Storage, About). Kennung aus dem Namen beim Anlegen, danach fest. Die Vorlage steht in der Kategorie „My skills“ auf „Bei Bedarf“. Speichern ändert keine Modelle (wie ein Update der App), Aus und wieder Ein übernimmt die neue Fassung, einen Knopf „Aktualisieren“ gibt es weiter nicht. Nur leer und zu groß verhindern das Speichern. Kommentarzeilen mit `#` im Kopf übergeht die App. Ein gelöschter eigener Skill bleibt als Eintrag in `skill_defaults`, wenn dort eine Stufe stand (ohne Wirkung)-- Normteile (E48): Schnittstelle auf Englisch (`Screw`, `Nut`, `Washer`, `HeatSetInsert`) wie der Rest von `soma`, Fehlermeldungen seit E73 ebenfalls englisch. Lage über Auflagepunkt und Richtung ins Material. Senkung = Kopf plus Spiel des gewählten Durchgangslochs, Tiefe genau die Kopfhöhe (nicht DIN 974, der Skill „Toleranzen“ nennt für Zylinderköpfe etwas größere Senkungen, mit `recess=` einstellbar). Kernloch aus der Spalte „Soft“ (Regelwerte). Einsätze: Standard ruthex, Bohrung 1 mm tiefer als der Einsatz. Farben Stahlgrau und Messing-- Normteile: Alte DIN-Namen (DIN 912, DIN 933 …) sind ein Fehler mit Hinweis auf die ISO-Norm, weil manche Maße abweichen. Nur Regelgewinde. Muttern haben eine Bohrung im Nenndurchmesser (sie berühren den Schaft, überschneiden ihn nicht). Ein Einsatz ist dicker als seine Bohrung, Kollisionsprüfungen mit seinem Teil lässt der Agent aus (steht im Skill „Normteile“)-- Rolle `hardware` (E48): Zukaufteile haben keinen eigenen Abschnitt im Bauteilbaum, sie unterscheiden sich durch Farbe und den Zusatz „(Zukaufteil)“ in der Auswahl. `soma export --all` nennt die Zahl der übersprungenen Teile-- Animation, Ablage (E58): beliebig viele Animationen je Datei in `animations/`, Namen im Projekt eindeutig, Kennung aus dem Namen (ASCII). Gebaute Animationen in `.soma/anim/`, Ergebnisse in `.soma/results/`, Bilder und Videos in `renders/`, alle drei nicht in Git (sie entstehen neu), aber in der ZIP. `soma render` ersetzt Dateien gleichen Namens in `renders/`-- Animation, Format: glTF mit abgetasteten Lagen (30 je Sekunde) statt Schlüsselbildern, damit Drehungen um eine Achse genau bleiben. Die Kamera ist ein glTF-Knoten mit eigenem Zielpunkt, Bildwinkel fest 35° wie im Viewer-- Animation, Schnittstelle: Winkel in Grad mit Rechte-Hand-Regel um `p2 - p1`, Übergang „smooth“ (kubisch) als Standard. `title()` nimmt sich Zeit, `caption()` gilt bis zum nächsten Untertitel. Ohne Kamera gilt die Standardansicht, über die ganze Bewegung eingepasst-- Hervorhebung in Animationen: Die Flächenfarbe wird nach Orange gezogen (Auswahl), reines Leuchten färbte blaue Teile violett (Vorschau). Im Viewer stehen Untertitel über der Karte der Animation, im Video unten-- Render: unsichtbares Fenster, eine Minute nach dem letzten Auftrag geschlossen. Standbild 1280 x 800, Übersicht 3 x 3 Bilder zu 480 x 300, Video 1280 x 720 mit 30 Bildern je Sekunde (`--size`, `--fps`). Ohne H.264 auf dem Rechner wird es VP9 im MP4, mit Hinweis. Die Verbindung nimmt nur Aufträge für das offene Modell an-- Analyse: drei Auswertungen mit den Grenzwerten 45°, 1,2 mm und 0,5 mm (wie in den Skills), ohne `--parts` nur eigene Teile, beim Abstand zählen alle anderen als Gegenstück. Farben aus den Statusfarben. „Veraltet“ heißt: irgendein Quelltext ist neuer, nicht unbedingt das ausgewertete Teil-- FEM (E65): Sicherheitsfaktor als Farbwert (nicht die Spannung, wahlweise umschaltbar), Standard-Netzgröße 1/30 der Modelldiagonale, zweite Rechnung mit 1,6-fach gröberem Netz, Hinweis ab 15 % Änderung und ab 5 % Verformung, Überhöhung auf 5 % der Modellgröße, Lastfall in Blau (Markierungsfarbe, keine Statusfarbe), automatische Skala der Spannung von 0 bis zum Doppelten der zulässigen (bei höheren Spitzen bis zur größten, höchstens zum Vierfachen), bei gewählter Spanne Farbverlauf Grau-Grün-Gelb-Rot über die Spanne statt am Grenzwert (Rot heißt dort nur oberes Ende), Wahl der Skala auch für die übrigen Auswertungen, gedruckte Kunststoffe standardmäßig quer zu den Schichten, mehrere Teile einer Studie verschmolzen, `analyses/` als Ordner der Studien-- Analyse (E64): genau am Grenzwert heißt ±0,5° bzw. ± Netztoleranz. Bis zu drei Problemstellen je Teil, gleichartig bei 15 % gleicher Fläche und Ausdehnung. Hinweis auf eine andere Druckrichtung, wenn sie höchstens halb so viel und mindestens 10 mm² weniger Überhang hat-- Kollisionsprüfung (E64): genau auf die doppelte Netztoleranz, gemessen an den Ecken der auf 1 % der Modelldiagonale unterteilten Netze. Eine Kollision ganz ohne eingedrungene Ecke (dünne Platte quer durch eine Welle, schmaler als die Unterteilung) bleibt unentdeckt. Gleiche Relativlagen werden nur einmal gerechnet-- `soma anim info` (E64): ab drei lückenlosen Schritten unter 0,5 s desselben Gelenks eine Zeile, Untertitel, Pausen und lange Bewegungen trennen-- Fortschritt (E64) erst nach 5 s, höchstens alle 15 s, im Fehlerkanal-- Vorschau eines alten Stands beendet Animation und Analyse (beide gehören zum aktuellen Code)-- Abhängigkeit mediabunny (MPL-2.0, Dateien unverändert, E30) für MP4-- 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-- Terminal, Schrift: fett ist IBM Plex Mono Bold (700), nicht SemiBold (600). Normal- und Fettschnitt werden vor dem ersten Terminal geladen. Ohne echten Schnitt rechnete Chromium das Fett nach, im DOM-Renderer (Rückfallweg ohne WebGL) saßen runde Zeichen dann einen Pixel tiefer, in WebGL bei 100 % Skalierung der ganze fette Text-- 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 ein Befehl für die Prüfung der Bereichsgrenzen (`soma params check`) fehlen noch. Bis dahin beschreibt der Skill „Parametric models“ (E77) die Prüfung über eine Kopie des Projekts-- Skill „Parametric models“ (E77): Kennung `parametrik`, Kategorie Arbeitsweise mit `order` 3, ab Werk „Immer“ (jedes Modell hat Parameter), Einstellungen Höchstzahl der Parameter (15, wie „meist 3 bis 15“ in `AGENTS.md`) und Bereichsprüfung (`full`, `main`, `off`). Die Konstruktionsabsicht steht als Kommentar über den Parametern, nicht in `NOTES.md`. Bereichsprüfung über eine Kopie des Projekts statt über einen neuen Befehl-- Technische Zeichnungen (E76): PDF und DXF nach `output/drawings/` (Lieferdateien, deshalb im Verlauf und in der ZIP), das Bild für den Agenten nach `.soma/drawings/` (wie die Animationen nicht in Verlauf und ZIP). Ein Bild mit 200 dpi, längste Seite höchstens 7000 px. Schrift DejaVu Sans statt einer ISO-Schrift, weil sie überall mit matplotlib vorhanden ist. Schriftfeld mit festem Aufbau 180 mm breit, Felder Firma, Benennung, Gezeichnet, Datum (Standard heute), Zeichnungsnummer, Index, Werkstoff, Allgemeintoleranzen, Maßstab, Format, Projektion, Blatt. A4 hoch, A3 bis A0 quer. Verdeckte Kanten standardmäßig in den sechs Hauptansichten, nicht in iso und Schnitten. Schraffur 2.5 mm, Nachbarteile 45/135°, ab dem dritten Teil weiter. Skill-Kennung `zeichnung`, Kategorie „Check and present“ mit `order` 33, ab Werk „Bei Bedarf“, Einstellungen Norm (ISO/ASME), Blattgröße (A3), Allgemeintoleranz (ISO 2768-m) und Sprache (en). PDF und DXF entfernter Blätter bleiben liegen und werden nur genannt.-- Zeichnungen nach dem ersten Agent-Test (E76): Die Gesamt-PDF heißt `output/drawings.pdf`, liegt neben dem Ordner der Blätter (kein Namenskonflikt mit einem Blatt), wird bei jedem Bau ohne Fehler geschrieben, auch bei nur einem Blatt, und hat keinen eigenen Befehl. `angle` bei `diameter()` meint jetzt die Richtung zum Text (vorher die von ezdxf, Text gegenüber). Ein Ø oder R vor `<>` wird bei `diameter()` und `radius()` still weggelassen statt gemeldet. Mehrzeiliger Text: erste Zeile bei `at`, die übrigen darunter (vorher wuchs der Block nach oben), Zeilenabstand 1.6 Schrifthöhen. Ein zu langer Eintrag im Schriftfeld wird nur gemeldet, nicht schmaler gesetzt. `label_at`, `letter_at` und `letters_at` meinen die Mitte des Texts, `letters_at` ordnet jeden Punkt dem näheren Ende zu. Lücke der Unterbrechung fest 6 mm, Bruchlinie als Zickzacklinie über die Kanten an der Bruchstelle plus 2 mm. Kanten von Schnittflächen, die nur von der Seite zu sehen sind, entfallen bei `path` und `region` immer-- Dateiformat .soma (E79): Die Endung allein, kein eigenes Format (eine ZIP lässt sich weiter umbenennen und entpacken). Ein Modell in einer älteren `.zip` wird beim nächsten Speichern mit Rückfrage als `.soma` daneben gespeichert, nicht still in die ZIP und nicht still daneben. Der Export als ZIP legt keinen Snapshot an und ändert den Speicherstand nicht, speichert auch keine Eingaben aus dem Editor. Er steht im Export-Menü unter allen Formaten, unabhängig von „All parts“ und „Selection only“-- DXF-Ansicht (E80): Reiter im Code-Panel wie die PDF, nicht im Viewer (der bleibt beim Modell). Gezeichnet von ezdxf in Python statt mit einer JavaScript-Bibliothek wie `dxf-viewer` (die kennt keine Linientypen und Strichstärken und bräuchte eigene Schriftdateien), dafür wartet die Ansicht auf Python. Dunkler Grund statt Papier, Strichstärken in Bildschirmpunkten. In der Datei ausgeschaltete Layer zunächst aus, aber einschaltbar. Nur der Modellbereich, ein Papierbereich nur, wenn der Modellbereich leer ist. „Mark up view“ statt eines Zitats wie bei der PDF, der Ausschnitt steht in der Notiz. Grenzen 200 MB und 6 Millionen Zahlen-- Einstellungen (E81): Werte gelten sofort ohne Speichern-Knopf, in `settings.json` statt `state.json`. Die sechs Mausbelegungen und ihre Tasten sind meine Auswahl aus den Standardbelegungen der Programme (CATIA fehlt, seine Belegung mit gedrückter Mitte und Klick passt nicht in das Schema). In den CAD-Belegungen tut Ziehen mit der linken Taste nichts. Ausgewählt wird nur noch mit der linken Taste. Die Projektion gilt sofort für die offene Ansicht, die Darstellung (Kanten, Drahtgitter, Transparent) erst beim nächsten Modell. Nachkommastellen nur in der Oberfläche, Winkel und die Auswahlkarte bleiben. Speicher: nur der Vorschau-Cache lässt sich leeren, die des offenen Modells bleiben. Info: Python-Pakete aus einer festen Liste dessen, was soma importiert (soma nennt keine Abhängigkeiten), Version von soma aus dem Paket statt aus den Metadaten (eine Entwicklungsinstallation behält dort die alte Nummer). Reiter ohne Ziel: der zuletzt gezeigte, zuerst Viewer-- Strukturbaum und Reiter (E82, umgesetzt): Zurück zum Modell über ein × rechts in der Leiste unten im Bild (Darstellung bei der Analyse, Abspielen bei der Animation), weil der Umschalter entfällt. Ein Klick auf Analysis oder Animation zeigt die Liste (E86, vorher das zuletzt gezeigte Ergebnis). Seitenleiste zu oder ein anderer Reiter lassen es im Bild. Die Reiter haben eine Liste und einen Bericht mit „‹ Analyses“ zurück zur Liste, Videos stehen im Reiter Animation, Neues melden ein Punkt am Reiter und „new“ in der Liste. Baum: Schrift und Striche mit dunklem Rand statt Fläche, nur die Zeile unter der Maus hellt auf. Kein Farbfeld vor dem Namen. Referenzen als zugeklappte Gruppe „References“ am Ende statt eigener Überschrift. In der Analyse nur die gerechneten Körper. Ausgeblendetes bleibt beim Wechsel zwischen Modell, Analyse und Animation ausgeblendet, „Show all“ im Fuß, eingeklappt „· 1 hidden“ neben dem Namen. Höchstens halb so hoch wie das Bild, dann scrollt er, die Lupe sucht. Rechtsklick öffnet das Menü von heute. Die Werkzeuge oben in der Mitte zeigen nur Symbole, wenn es neben dem aufgeklappten Baum eng wird. F3 zum Auf- und Zuklappen wie in CATIA war im Entwurf nur ein Vorschlag und ist umgesetzt-- Bei der Umsetzung von E82 ohne Rückfrage entschieden: Die Seitenleiste startet zu (vorher mit den Bauteilen), eine gemerkte Ansicht „Bauteile“ älterer Versionen öffnet nichts, Analysis und Animation werden nicht über einen Neustart gemerkt (ein Ergebnis zeigt sich nur auf Wunsch). Bericht und Ablauf machen die Seitenleiste mindestens 352 px breit wie im Entwurf. Gruppen beginnen zugeklappt, Aufklappen zeigt eine Ebene (Wunsch des Nutzers nach der ersten Durchsicht). Der Punkt am Reiter verschwindet beim Öffnen des Reiters, „new“ in der Liste erst beim Öffnen des Eintrags. „Show the spot“ verschiebt die Ansicht zur Stelle, ohne zu zoomen, ein ausgeblendetes Teil bleibt ausgeblendet (Meldung statt Einblenden). In der Leiste kommt Displacement als dritte Größe dazu (im Entwurf gezeigt, vorher nicht vorhanden), ohne Grenzwert, Farbe über die Spanne. Die Beschriftung im Bild folgt der Größe („Min“ Sicherheit, „Max“ Spannung oder Verschiebung). Schritte der Animation aus den Untertiteln, ohne Untertitel aus dem Ablauf der Datei. Zu einer Animation gehören die Videos in `renders/`, deren Name mit ihrer Kennung beginnt. Das Menü „…“ im Bericht enthält „Copy command“ und „Show the model“. Die angeklickte Stelle steht unten im Bericht über den Knöpfen-- `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)-- Markup-Ansicht: Die Zeichenfläche behält Größe und Seitenverhältnis von der Aufnahme (das Bild für den Agenten ändert sich nicht), wird aber in den Viewer eingepasst und wächst mit ihm. Mausrad zoomt um den Zeiger von eingepasst bis 8-fach, rechte oder mittlere Maustaste verschiebt (die linke bleibt dem Zeichnen), Ctrl+0 passt wieder ein. Die Fangradien der Griffe gelten in Bildschirmpixeln, Strichstärke und Schrift in Pixeln der Zeichenfläche (sie wachsen beim Zoomen also mit)-- `bolt()` (E84): Kopf und Gewinde verklebt statt Kontakt mit Reibung unter dem Kopf (ein Kontakt weniger, die Fuge startet mit Anpressdruck und konvergiert), Vorspannschnitt mit eigenen Gleichungen statt `*PRE-TENSION SECTION`, Vorspannung ohne Angabe 70 % von Rp0,2 und höchstens Festigkeit mal Auflagefläche unter dem Kopf, Meldung ab 90 % Auslastung, Normteile einer Verschraubung bekommen Stahl der Festigkeitsklasse, Teile, die die Schraube berührt, rechnen von selbst mit, Fehlermeldung statt Rechnung bei Schraube ohne Gewinde oder ohne Durchgangsloch, Schraube aus Gewindeteilen ausgeschnitten.-- FEM mit CalculiX (E84): Kontaktgesetz linear mit dem kleineren E-Modul (CalculiX empfiehlt das 5- bis 50-Fache, das pendelte), Haftsteigung gleich dem E-Modul, Rückfall auf das exponentielle Gesetz bei mehr als 30 Iterationen je Laststufe oder 60 insgesamt (gemeldet), das weichere Teil als Slave-Seite, Spalt und Gleitweg aus den Verschiebungen, Kraft aus dem Gleichgewicht, Hälfte der logischen Kerne für CalculiX, Ablage neben der Python-Umgebung (`<sys.prefix>/ccx`), Hinweis zur Netzabhängigkeit erst ab 2 % der Festigkeit, Kontaktpressung im Bild als eigene Größe statt in der Sicherheit, `SOMA_FEM_SOLVER=builtin` und `SOMA_CCX_KEEP=1` als Schalter-- Nutzeranleitung (E83): Quelle in Markdown statt HTML (Gegenvorschlag, mit „Ja klingt gut“ freigegeben). Die Quelle ist der Skill selbst statt einer eigenen Datei, aus der der Skill erst erzeugt würde: So gibt es nichts zu erzeugen und nichts zu vergessen. Skill ab Werk „Bei Bedarf“ in „Way of working“, nicht „Immer“ (Bedienfragen sind selten, der Text wäre sonst bei jeder Änderung im Kontext). Anleitung auf Englisch wie die App (E73). Hilfe als Fenster über der App wie die Einstellungen statt als Reiter im Code-Panel, F1 als Taste. Bilder per Skript aus der echten App, eingecheckt in `app/resources/help/` (rund 2.3 MB), statt beim Bauen oder Start erzeugt. Im Projekt unter `.soma/help/`, nicht im Verlauf, damit jedes Modell nicht um die Bilder wächst. Die Bilder bleiben im Projekt, wenn der Skill ausgeschaltet wird (stören nicht, Zwischenergebnis)--- Rolle `reference` und ihre Standardwerte (E34)-- Hinweis beim ersten Start, dass der Agent mit den Rechten des Nutzers läuft (E29)-- Die fünf Robustheitsregeln in Abschnitt 9-- `project.json` bei Verlust automatisch aus der App-Kopie wiederherstellen und anzeigen, oder nur melden (E27, E28)-- Auto-Start des Agenten ohne Resume so verstanden, dass der Start bleibt (E19)-- App-Icon auf einer Graphit-Fläche mit runden Ecken, kleine Größen mit dickerem Strich und größerem Zeichen (E44)--**Zu klären**--- **Namen:** Notizdatei `NOTES.md`, Ordner `exports/` (Ort, getrackt oder nicht)-- **Lizenzen der Komponenten:** Hinweise und Texte aller mitgelieferten Teile (Git, Python-Pakete, gmsh, CalculiX mit OpenBLAS, arpack und GCC-Laufzeit (Lizenztexte legt `fetch_ccx.py` bei), 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 (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)-- **Echte Fremddateien:** Herstellerplatinen und große Baugruppen mit Stückliste in Phase 1 testen-- **Netzlaufwerke (Windows):** Liegt das Programm auf einem Netzlaufwerk, starten die sandboxed Prozesse von Electron nicht. Die installierte App muss lokal liegen, Fehlermeldung ist vorhanden. Klären, wie der Installer damit umgeht und ob Firmenrechner mit umgeleiteten Profilen Probleme machen-- **Updates:** Regeln für alte und neuere `api_version`, Auto-Update der App, Signierung (E36)-- **Format** von `model.map.json` (Entwurf `version 0` aus Phase 0 steht) und der Ausgabe von `soma check`-- **Vorschau-Cache (E66):** wächst unbegrenzt (Hotwire rund 13 MB je Stand), es gibt kein automatisches Aufräumen, seit E81 nur das Leeren von Hand in den Einstellungen. Vorschlag: älteste Stände je Projekt über einer Grenze löschen, sie entstehen bei Bedarf neu-- **Weitere Beschleunigung (gemessen, nicht umgesetzt, E66):** Der Mesher liest jede Form einzeln aus, auch gleiche: Die 164 Normteile im Hotwire sind nur 17 verschiedene Formen (rund 1,5 s zu sparen). Das Auslesen in Python dauert rund 3 s gegen 0,6 s Vernetzung in OCC, über VTK aus CadQuery wären es rund 1,2 s für alles (größerer Umbau, Flächen- und Kanten-IDs fürs Messen). GLB erst schreiben und melden, STEP und Geometrie danach (1,9 s früher im Viewer). Hinweise im Skill „CadQuery“: Bohrungen in einem `cut` abziehen (20 Bohrungen 0,15 statt 0,75 s), gleiche Teile mit `.moved()` platzieren statt neu bauen (auch Netz und STEP profitieren). Weniger Git-Aufrufe beim Anlegen und Wiederherstellen (je rund 0,15 s auf dem Netzlaufwerk). Den Messdienst aus dem vorgewärmten Prozess starten-- **Toleranz des Meshers:** Feste 0,05 mm passt für kleine Teile, große brauchen eine an der Größe orientierte Toleranz (siehe Leistungsmessung)-- **Auswahlen des Agenten:** Flächen-IDs gelten nur pro Build, Verweise brauchen Bauteilname plus Geometrieangabe-- **Inhalte** von `AGENTS.md` und den Skills, mit einem echten Agenten zu testen. Vor allem (E55): Liest ein Agent einen Skill „Bei Bedarf“ von selbst, wenn das Gespräch das Thema wechselt (etwa „jetzt für den 3D-Druck“), und hält er das in `NOTES.md` fest? Mit Claude Code und einem kleineren Modell prüfen-- **Projekt-Check:** Umfang und Spezifikation, Abdeckung aller Störfälle-- **Animation und Analyse (E58):** Montage Schritt für Schritt aus der Demontage-Analyse der Explosion (E59) als Animation erzeugen? CFD als weitere Auswertung. FEM (E65): gmsh (GPL) passt seit E71 zur Lizenz von SOMA, Netgen (LGPL) bleibt eine Alternative als Vernetzer. Nach E84 (CalculiX, Kontakt, `bolt()`): `Modes` (Eigenfrequenzen) und `Buckling` als eigene Studien, große Verformung und Plastizität über Hinweise, Kontakt mit Anfangsspalt, schnellerer Löser für Reibung (PaStiX oder PARDISO fehlen im Paket von conda-forge), `fetch_ccx.py` unter Linux und macOS im Installer, Lasten aus einem Klick im Viewer, Lastfall im Viewer bearbeiten. Längere Videos (heute ganz im Speicher), Ton. Agent-Test: Liest ein Agent die Skills und öffnet er die Bilder von `soma render` von selbst? Zurückgestellt (E64): gekoppelte Gelenke (ein Wert treibt mehrere Gelenke, wie `ValueTracker` in manim) sowie Zahnräder, Lager und Federn als Bausteine, bis Mechanik öfter vorkommt. Analyseergebnisse sind noch rund 30 MB je Auswertung (drei eigene Ecken mit Normale je Dreieck), kleiner, wenn der Viewer flache Normalen selbst rechnet--## 12. Größte Risiken--| Risiko | Warum | Gegenmaßnahme |-|---|---|---|-| STEP-Namen mit CadQuery | **Erledigt in Phase 0:** Namen, Farben, Alpha bleiben erhalten. Nicht-ASCII-Namen werden zerstört | ASCII-Namen in der STEP, Anzeigename in `model.map.json` |-| Codequalität der Agenten mit CadQuery | Verkettete API mit verstecktem Zustand, halluzinierte Aufrufe | Strikte Idiome in `AGENTS.md`, Beispiele, Feedback-Loop (bauen, messen, rendern) |-| Agenten ignorieren die Konventionen | Nicht jeder Agent folgt `AGENTS.md` oder Verweisen | Robustheit (Abschnitt 9), Agent-Test in Phase 1 |-| Klick auf Fläche und Code | Kein Framework liefert Flächen-IDs oder Zeilenbezug | **In Phase 0 bestätigt** mit eigenem Mesher und Hilfsbibliothek. Verknüpft wird der `add_part`-Aufruf (E10), nicht die Entstehungszeile der Fläche |-| Installationsgröße und Einbettung | **Gemessen:** OCP hängt hart an VTK, installiert 0,76 bis 1,04 GB | Vorerst hingenommen (E37). Später: Casadi und VTK-Teilmenge prüfen, Komprimierung |-| Nur Windows getestet | Bundling und Bibliotheken auf macOS und Linux ungeprüft, E2 verlangt alle drei | Früh in Phase 1 auf macOS und Linux nachziehen |-| Modellgröße und Buildzeit | Große Teile brauchen 8 bis 10 s (Meshen in OCC), feine Toleranz bis 30 s | Auto-Build abschaltbar (E20), Toleranz nach Bauteilgröße |-| Chats bei ZIP-Weitergabe | Agenten speichern Historie außerhalb des Projekts | Bewusst akzeptiert (E5) |-| Git für Nicht-Programmierer | Agent und App teilen sich ein Repo | Nur Vorschau und Wiederherstellen als neuer Commit (E35), App-Schreibvorgänge serialisiert, Sicherung vor Wiederherstellung. **Umgesetzt und getestet**, Claude Code committet laut erstem Test selbst. Lange Sitzungen und andere Agenten sind ungeprüft |diff --git a/README.md b/README.mdindex 8d18e15..3e07240 100644--- a/README.md+++ b/README.md@@ -123,7 +123,6 @@ More in [app/README.md](app/README.md).| `app/` | Electron app (TypeScript): terminal, viewer, project format, tests || `python/soma/` | Helper library and command line tool used by the agent || `design/` | UI drafts |-| `PLAN.md`, `DECISIONS.md` | Plan and decision log (German) |## Licensediff --git a/app/README.md b/app/README.mdindex 84b6a29..f15b763 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). Version **0.5.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`.+Electron-App (TypeScript) für 3D-Modelle mit einem Coding-Agenten im Terminal. Version **0.5.0** (Major.minor.bugfix, E68, steht in `package.json` und `../python/soma/__init__.py`). Oberfläche nach den Entwürfen in [../design/](../design/), Änderungen in [../CHANGELOG.md](../CHANGELOG.md). Die Kennungen `E12` in Code und Doku verweisen auf das Entscheidungslog der Entwicklung, das nicht im Repo liegt.## Voraussetzungen@@ -53,12 +53,12 @@ npm run help:shots # Bilder der Anleitung neu aufnehmen (resources/help/),| `src/renderer/` (E58) | `animdata.ts` (Animation aus der glTF-Datei auswerten), `animtool.ts` (Abspielleiste unten im Bild), `animpanel.ts` (Reiter Animation: Liste mit Videos, Schritte, E82), `overlay.ts` (Untertitel, Beschriftungen, Legende auf einer 2D-Fläche, im Viewer wie im Video), `resultview.ts` und `resulttool.ts` (Ergebnisse farbig, Legende, Leiste und Beschriftungen im Bild), `analysispanel.ts` (Reiter Analysis: Liste und Bericht, E82), `videoview.ts` (Video-Player mit Standbild markieren), `render.html` und `render.ts` (unsichtbares Render-Fenster: Bild, Übersicht, MP4 mit WebCodecs und mediabunny) || `src/shared/` | `help.ts` Anleitung in Abschnitte zerlegen (E83), `types.ts` Typen des IPC-Vertrags, `editable.ts` welche Dateien der Editor nur zeigt (gilt in Renderer und Hauptprozess), `skillname.ts` Kennung eines eigenen Skills aus seinem Namen || `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/skills/` | Mitgelieferte Skills (E17), je eine Markdown-Datei: Kopf mit `title`, `summary`, `topics`, `category` (Überschrift im Panel), `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/help/` | Bilder der Anleitung (E83) mit nummerierten Markierungen, erzeugt mit `npm run help:shots` (`test/helpshots.mjs`, Ausschnitte und Nummern in `test/helpshots-spec.mjs`). Der Text ist der Skill `resources/skills/soma-app.md`, die Liste unter jedem Bild nennt dieselben Bezeichnungen wie die Markierungen (`npm run test:unit` prüft das) || `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, Kontakt, Schrauben mit Vorspannung, eigener Solver mit pyamg als Rückfall), `ccx.py` CalculiX als Rechenwerk (E84), `render.py` Auftrag an die App für `soma render`, `drawing.py` und `drawrun.py` technische Zeichnungen mit `soma drawing` (E76: HLR aus OCP, DXF mit ezdxf, PDF und PNG über matplotlib, Prüfung), `dxfview.py` DXF für die Ansicht der App mit `soma dxfview` (E80, Zeichenmodul von ezdxf), `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`, `params.mjs`, `fasteners.mjs`, `drawing.mjs`, `dxf.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)+## Noch nicht enthaltenPanel „Pakete“, weitere Bereiche der Einstellungen, Varianten und abgeleitete Werte im Parameter-Panel, Auto-Start des Agenten, `soma check`, Bündelung von Python und Installer, macOS und Linux (nur Windows getestet).diff --git a/app/test/versions.mjs b/app/test/versions.mjsindex 0a3032b..71d1270 100644--- a/app/test/versions.mjs+++ b/app/test/versions.mjs@@ -1,5 +1,5 @@// Test für Git-Verlauf, Speichern als .soma (innen eine ZIP), Öffnen von .soma und .zip, Export als ZIP (E79), Vorschau und-// Wiederherstellen, dazu die Störfälle aus PLAN.md Abschnitt 9.+// Wiederherstellen, dazu Störfälle im Arbeitsordner (Robustheit).// Aufruf: npm run test:versions (baut vorher).import { exec } from 'dugite';import fs from 'node:fs';diff --git a/docs/phase0-ergebnisse.md b/docs/phase0-ergebnisse.mdindex dc0fa31..e86277d 100644--- a/docs/phase0-ergebnisse.md+++ b/docs/phase0-ergebnisse.md@@ -1,6 +1,6 @@# Phase 0: Ergebnisse des technischen Prototyps-> Stand: 2026-09-29 · Plan: [PLAN.md](../PLAN.md), Abschnitt 10 · Alles gemessen auf **Windows 11**, Python 3.12.0, CadQuery 2.8.0, OCP 7.9.3.1.1, three.js 0.180, Edge (headless).+> Stand: 2026-09-29 · Alles gemessen auf **Windows 11**, Python 3.12.0, CadQuery 2.8.0, OCP 7.9.3.1.1, three.js 0.180, Edge (headless).> Der Code des Prototyps (die unten genannten Skripte und Tests) ist nicht mehr im Repo. Er liegt im Git-Verlauf, zuletzt im Tag `v0.5.0` unter `prototype/phase0/`.## Kurzfassung