Desktop app for designing parametric 3D models in CadQuery together with the coding agent of your choice
TypeScript 3d-modeling3d-printing3d-printing-toolsagentagentic-aiai-cadcadcadqueryclaude-codecodexelectronfemllmmacdmakeropencodeparametric-designpythonsteptext-to-cad
Entscheidung E79, Plan, Changelog und READMEs: Dateiformat .soma
Kai-Jungsthoefel82d82468feda
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 43e767d..5e1a922 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -14,6 +14,7 @@ eigenen Abschnitt mit Datum und Git-Tag.### Geändert+- Modelle werden als `.soma`-Datei gespeichert statt als `.zip`. ZIP-Dateien öffnet die App weiter. Ein Modell aus einer ZIP wird beim nächsten Speichern als `.soma` daneben abgelegt, die ZIP bleibt. Wer das ganze Modell als ZIP braucht, findet „Everything as ZIP“ im Export-Menü (E79).- Der Dateibaum zeigt die Kopien der Skills aus `.soma/skills/` als eigene Gruppe „Skills“, eingeklappt und nur zum Lesen. Ein- und ausgeschaltet werden sie weiter im Panel „Skills“.- Jede Zeile im Panel „Parameters“ zeigt den Bereich, den der Agent gesetzt hat, ohne Aufklappen („30–200 mm“, „3 options“), rot, wenn der Wert außerhalb liegt (E74).- Kleinere ZIP beim Speichern: Bilder und Videos aus `renders/` kommen nicht mehr mit, und die Versionsgeschichte wird vorher gepackt, sodass ähnliche Fassungen des Modells kaum zusätzlichen Platz brauchen. Am Modellmotor schrumpft der Verlauf von 81 auf 35 MB (E75).diff --git a/CLAUDE.md b/CLAUDE.mdindex b45a905..91b77b8 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -4,7 +4,7 @@ Anweisungen für Claude Code bei der Entwicklung von SOMA (*Solid Object Modelin## Worum es geht-Eine 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 (ZIP mit Git) und die Hilfsbibliothek `soma`.+Eine 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` 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.diff --git a/DECISIONS.md b/DECISIONS.mdindex 58da9f2..8b2e5a8 100644--- a/DECISIONS.md+++ b/DECISIONS.md@@ -81,3 +81,4 @@| 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 |diff --git a/PLAN.md b/PLAN.mdindex cd45215..558f726 100644--- a/PLAN.md+++ b/PLAN.md@@ -44,7 +44,7 @@ Eine Desktop-App, in der ein Nutzer zusammen mit einem KI-Coding-Agenten seiner## 4. Projektformat-**Ein Projekt ist eine ZIP-Datei.** Die App arbeitet in einem Arbeitsordner (E21):+**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.@@ -490,6 +490,14 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- **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.+*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).@@ -502,7 +510,7 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- 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)- Beim Öffnen eines Projekts wird sofort gebaut, damit der Viewer nicht leer ist, außer der letzte Build gilt noch (E66), dann wird er gezeigt. Beim Anlegen läuft vor dem Startcommit ein Build (im vorgewärmten Prozess unter 1 s)-- Der Modellname folgt dem Dateinamen der ZIP+- 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@@ -600,6 +608,7 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- 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“- `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)- Rolle `reference` und ihre Standardwerte (E34)diff --git a/README.md b/README.mdindex e4c6d61..10b7bbc 100644--- a/README.md+++ b/README.md@@ -53,7 +53,7 @@ Any CLI agent that can read files and run commands works: Claude Code, OpenCode,- Skills: optional rule sets per model (3D printing, CNC, sheet metal, tolerances, joints, FEM …), switched on always or on demand. Edit them or add your own in the settings**Project**-- A model is a single ZIP file with code, result and history+- A model is a single `.soma` file (a ZIP archive) with code, result and history. ZIP files open too, and the export menu writes the whole model as a ZIP- Every commit of the agent shows up on a timeline below the view, old states can be previewed and restored- Export to STEP, STL, 3MF, glTF, DXF, SVG and more- Technical drawings as PDF and DXF: the agent writes them in Python with views, sections, details and dimensions measured from the model, and checks the result as an imagediff --git a/app/README.md b/app/README.mdindex aea3cf5..b07b23e 100644--- a/app/README.md+++ b/app/README.md@@ -17,7 +17,7 @@ npm start # baut und startetnpm run typechecknpm run test:unit # Bausteine ohne Electron: Dateien und Ordner nach inputs/, Anlegen, Umbenennen und Papierkorb im Dateibaum, Markierung nach .soma/feedback/, Pfadschutz, Schreiben aus dem Editor mit Konfliktprüfung, App-Icon, Einstellungen, Kategorien, Stufen und Standard der Skills, Abschnitt in AGENTS.md, Animationsdateien bauen nicht das Modell, Zwischenergebnisse nicht in Verlauf und ZIP auch in älteren Projekten, gilt der letzte Build noch, Build als Vorschau eines Commits (80 Prüfungen)npm run test:smoke # echte App, unsichtbar: Projekt, Viewer, Auswahl, Panels, Terminal, Übergabe an den Agenten, Markierung (Zeichnen, Linie, Raster, Auswählen, Verschieben, Drehen, Skalieren, Farben, Bild aus dem Dateibaum), Dateibaum (Markierungen, Menü, Anlegen, Umbenennen, Papierkorb), Auto-Build, Fehlerfall, Export, Ansichtswürfel und Drehpunkt (88 Prüfungen)-npm run test:versions # Git-Verlauf, Speichern, Öffnen, Vorschau (auch markiert), Wiederherstellen, Störfälle, Öffnen ohne Neubau, Vorschau aus dem Build, Start auf der Startseite, unveränderte Modelle verschwinden, Entfernen (70 Prüfungen)+npm run test:versions # Git-Verlauf, Speichern als .soma, Öffnen von .soma und .zip, Export als ZIP, Vorschau (auch markiert), Wiederherstellen, Störfälle, Öffnen ohne Neubau, Vorschau aus dem Build, Start auf der Startseite, unveränderte Modelle verschwinden, Entfernen (75 Prüfungen)npm run test:editor # Editor: Höhe und Scrollen, Speichern nur auf Wunsch mit genau einem Build (nur bei Python und inputs/), Änderungen des Agenten, Konflikte mit Sicherung, Nur lesen, CRLF, Rückfragen bei Modellwechsel und Reiter schließen, Markdown als Dokument (37 Prüfungen)npm run test:measure # Messen: Fläche, Kante, Punkt, Abstand paralleler Ebenen, zweier Bohrungen, zweier Punkte, Punkt zur Ebene, Verdecktes, neuer Build, Vorschau (21 Prüfungen)npm run test:groups # Gruppen: eigene und importierte (STEP-Baugruppe), Baum, Aus-/Einblenden und Transparenz je Gruppe, Klick durch transparente Teile, Ausgabe-STEP (17 Prüfungen)@@ -44,7 +44,7 @@ node test/run-all.mjs smoke editor # nur diese, nach npm run build| Pfad | Inhalt ||---|---|-| `src/main/` | Hauptprozess: `projects.ts` (offenes Projekt, Speichern, Öffnen, Verlauf, Wiederherstellen), `git.ts` (mitgeliefertes Git über dugite), `zip.ts` (ZIP schreiben und sicher entpacken), `workspace.ts` (UUID-Arbeitsordner, Projektzustand doppelt, Projekt-Check nur melden), `build.ts` (Build als Einmal-Prozess mit Entprellung, Warteschlange, Zeitlimit, ein vorgewärmter Python-Prozess für alle Aufträge der App, gilt der letzte Build noch), `previews.ts` (Build als Vorschau eines Commits ablegen), `measure.ts` (langlebiger Python-Messdienst, `soma serve`), `skills.ts` (Bibliothek aus mitgelieferten und eigenen Skills, Stufen der Skills: Kopie nach `.soma/skills/`, bei Bedarf mit Hinweis, zwei Listen in `AGENTS.md`, Sicherung abweichender Kopien, Prüfung eines Skill-Texts), `skilllibrary.ts` (eigene Skills in den App-Daten für die Einstellungen: anlegen, speichern, zurücksetzen, löschen, importieren, mit Sicherung, E78), `params.ts` (Werte des Nutzers in `parameters.json` lesen, prüfen und schreiben, E74), `dialogs.ts` (native Dialoge, im Test beantwortbar), `watcher.ts`, `terminals.ts` (node-pty, Projektumgebung, `soma` und `git` im PATH, `PIP_PYTHON`), `packages.ts` (Projektumgebung `.soma/env` anlegen lassen, fehlende Pakete aus `requirements.txt` installieren, E67), `files.ts` (Pfadschutz, Dateien nach `inputs/`, Markierungen nach `.soma/feedback/`, Schreiben aus dem Editor mit Konfliktprüfung und Sicherung), `agents.ts`, dazu für E58 `bridge.ts` (Verbindung für `soma render`: HTTP auf 127.0.0.1 mit Schlüssel), `render.ts` (unsichtbares Render-Fenster, Aufträge nacheinander), `animations.ts` (Liste der Animationen und Ergebnisse, Bauen im Hintergrund) |+| `src/main/` | Hauptprozess: `projects.ts` (offenes Projekt, Speichern, Öffnen, Verlauf, Wiederherstellen), `git.ts` (mitgeliefertes Git über dugite), `zip.ts` (Modelldatei .soma oder ZIP schreiben und sicher entpacken), `workspace.ts` (UUID-Arbeitsordner, Projektzustand doppelt, Projekt-Check nur melden), `build.ts` (Build als Einmal-Prozess mit Entprellung, Warteschlange, Zeitlimit, ein vorgewärmter Python-Prozess für alle Aufträge der App, gilt der letzte Build noch), `previews.ts` (Build als Vorschau eines Commits ablegen), `measure.ts` (langlebiger Python-Messdienst, `soma serve`), `skills.ts` (Bibliothek aus mitgelieferten und eigenen Skills, Stufen der Skills: Kopie nach `.soma/skills/`, bei Bedarf mit Hinweis, zwei Listen in `AGENTS.md`, Sicherung abweichender Kopien, Prüfung eines Skill-Texts), `skilllibrary.ts` (eigene Skills in den App-Daten für die Einstellungen: anlegen, speichern, zurücksetzen, löschen, importieren, mit Sicherung, E78), `params.ts` (Werte des Nutzers in `parameters.json` lesen, prüfen und schreiben, E74), `dialogs.ts` (native Dialoge, im Test beantwortbar), `watcher.ts`, `terminals.ts` (node-pty, Projektumgebung, `soma` und `git` im PATH, `PIP_PYTHON`), `packages.ts` (Projektumgebung `.soma/env` anlegen lassen, fehlende Pakete aus `requirements.txt` installieren, E67), `files.ts` (Pfadschutz, Dateien nach `inputs/`, Markierungen nach `.soma/feedback/`, Schreiben aus dem Editor mit Konfliktprüfung und Sicherung), `agents.ts`, dazu für E58 `bridge.ts` (Verbindung für `soma render`: HTTP auf 127.0.0.1 mit Schlüssel), `render.ts` (unsichtbares Render-Fenster, Aufträge nacheinander), `animations.ts` (Liste der Animationen und Ergebnisse, Bauen im Hintergrund) || `src/preload/` | Schmale, feste Schnittstelle zum Renderer (kein Node-Zugriff dort), `render-preload.ts` für das Render-Fenster || `src/renderer/` | Oberfläche: `main.ts` (Verdrahtung: Kopfzeile mit Spalten-Schaltern, Seitenleiste und Code-Spalte, Umschalter oben links im Viewer, Menüs, Auswahl, Export, Übergabe an den Agenten auch per Ziehen ins Terminal, Startseite), `viewer.ts` (three.js, Klick auf Code, Ansichten, Drehpunkt, Schnittebene mit gefüllter Schnittfläche und Kontur, verschobene Bauteile der Explosion mit Wegen, Strahltest der Demontage-Analyse mit BVH aus `three-mesh-bvh`, Vorschaubild, Bild für die Markierung), `viewcube.ts` (Ansichtswürfel in 3D), `sectiontool.ts` (Schnitt: Karte, Ebene, Text für den Agenten), `explodetool.ts` (Explosion: Demontage-Analyse mit Baugruppen und schrägen Richtungen, Elternteile, Lage, Abspielen Schritt für Schritt, Karte, Texte für den Agenten), `busy.ts` (Ladeanzeige über dem Viewer mit Fortschritt und Abbrechen, für die Analyse der Explosion), `skills.ts` (Skills in der Seitenleiste: Zeilen mit Stufen-Schalter, Karte daneben mit Einstellungen), `settings.ts` (Einstellungen über der App, Bereich „Skills“ mit Liste, Markdown-Editor, Vorschau und Prüfung beim Tippen, E78), `params.ts` (Parameter in der Seitenleiste: Felder nach Art, Gruppen, Zurücksetzen auf den Wert aus dem Code, E74), `markup.ts` (Zeichenfläche der Markierung, Formen als bearbeitbare Objekte), `measuretool.ts` (Messen: Ablauf, Karte, Text für den Agenten), `parts.ts` (Bauteilbaum in der Seitenleiste mit Gruppen, Auge und Transparenz, Zeilen lassen sich ins Terminal ziehen), `code.ts` (Code-Spalte mit Editor: CodeMirror 6, Speichern auf Wunsch, Abgleich mit Änderungen des Agenten, Konflikte, Umschalter für Markdown), `markdown.ts` (Markdown als Dokument: Tokens von `marked` direkt als DOM, ohne `innerHTML`), `filetree.ts` (Dateibaum in der Seitenleiste, offene Datei hervorgehoben), `versions.ts` (Verlaufsleiste), `terminals.ts` (xterm.js, Tabs, Einklappen, Einfügen), `ui.ts` (Menüs, Meldungen, Helfer), `icons.ts` (Symbole), `style.css` (Farben mit fester Bedeutung, siehe Kopf der Datei) || `src/renderer/` (E58) | `animdata.ts` (Animation aus der glTF-Datei auswerten), `animtool.ts` (Karte „Animation“, gewählt im Umschalter oben links), `overlay.ts` (Untertitel, Beschriftungen, Legende auf einer 2D-Fläche, im Viewer wie im Video), `resultview.ts` und `resulttool.ts` (Ergebnisse farbig, Karte „Analyse“), `videoview.ts` (Video-Player mit Standbild markieren), `render.html` und `render.ts` (unsichtbares Render-Fenster: Bild, Übersicht, MP4 mit WebCodecs und mediabunny) |