@xrmforge/typegen 0.8.3 → 0.8.5

package/docs/architektur/10-eslint-plugin.md

@@ -1,82 +1,82 @@
-# 10. ESLint Plugin
-
-## 10.1 Installation
-
-```javascript
-// eslint.config.js (Flat Config, ESLint v9)
-import xrmforge from '@xrmforge/eslint-plugin';
-
-export default [
-  xrmforge.configs.recommended,
-  // oder einzelne Regeln auswählen
-];
-```
-
-## 10.2 Regeln
-
-### no-xrm-page (error)
-
-Verbietet die veraltete `Xrm.Page`-API (entfernt in D365 v9.0+).
-
-```typescript
-// Falsch
-Xrm.Page.getAttribute("name");
-
-// Richtig
-const form = executionContext.getFormContext();
-form.getAttribute("name");
-```
-
-### no-magic-optionset (warn)
-
-Verbietet rohe Zahlen (>= 2) in Vergleichen mit `.getValue()`.
-
-```typescript
-// Falsch
-if (attr.getValue() === 595300000) { }
-
-// Richtig
-import { StatusCode } from '../generated/optionsets/account';
-if (attr.getValue() === StatusCode.Active) { }
-```
-
-### no-sync-webapi (error)
-
-Verbietet synchrone XMLHttpRequest (`new XMLHttpRequest()` und `.open()` mit `async=false`).
-
-```typescript
-// Falsch
-xhr.open("GET", url, false);
-
-// Richtig
-const data = await Xrm.WebApi.retrieveRecord("account", id);
-```
-
-### require-error-handling (warn)
-
-Verlangt try/catch in exportierten async-Funktionen, die mit "on" beginnen (Event-Handler).
-
-```typescript
-// Falsch
-export async function onLoad(ctx) {
-  await fetch("/api");  // keine Fehlerbehandlung
-}
-
-// Richtig
-export async function onLoad(ctx) {
-  try { await fetch("/api"); }
-  catch (error) { console.error(error); }
-}
-```
-
-### require-namespace (warn)
-
-Verbietet direkte `window.X = ...` oder `globalThis.X = ...` Zuweisungen. Stattdessen sollen Modul-Exports mit esbuild globalName verwendet werden.
-
-```typescript
-// Falsch
-window.Contoso = { onLoad: function() {} };
-
-// Richtig
-export function onLoad(ctx: Xrm.Events.EventContext) {}
-```
+# 10. ESLint Plugin
+
+## 10.1 Installation
+
+```javascript
+// eslint.config.js (Flat Config, ESLint v9)
+import xrmforge from '@xrmforge/eslint-plugin';
+
+export default [
+  xrmforge.configs.recommended,
+  // oder einzelne Regeln auswählen
+];
+```
+
+## 10.2 Regeln
+
+### no-xrm-page (error)
+
+Verbietet die veraltete `Xrm.Page`-API (entfernt in D365 v9.0+).
+
+```typescript
+// Falsch
+Xrm.Page.getAttribute("name");
+
+// Richtig
+const form = executionContext.getFormContext();
+form.getAttribute("name");
+```
+
+### no-magic-optionset (warn)
+
+Verbietet rohe Zahlen (>= 2) in Vergleichen mit `.getValue()`.
+
+```typescript
+// Falsch
+if (attr.getValue() === 595300000) { }
+
+// Richtig
+import { StatusCode } from '../generated/optionsets/account';
+if (attr.getValue() === StatusCode.Active) { }
+```
+
+### no-sync-webapi (error)
+
+Verbietet synchrone XMLHttpRequest (`new XMLHttpRequest()` und `.open()` mit `async=false`).
+
+```typescript
+// Falsch
+xhr.open("GET", url, false);
+
+// Richtig
+const data = await Xrm.WebApi.retrieveRecord("account", id);
+```
+
+### require-error-handling (warn)
+
+Verlangt try/catch in exportierten async-Funktionen, die mit "on" beginnen (Event-Handler).
+
+```typescript
+// Falsch
+export async function onLoad(ctx) {
+  await fetch("/api");  // keine Fehlerbehandlung
+}
+
+// Richtig
+export async function onLoad(ctx) {
+  try { await fetch("/api"); }
+  catch (error) { console.error(error); }
+}
+```
+
+### require-namespace (warn)
+
+Verbietet direkte `window.X = ...` oder `globalThis.X = ...` Zuweisungen. Stattdessen sollen Modul-Exports mit esbuild globalName verwendet werden.
+
+```typescript
+// Falsch
+window.Contoso = { onLoad: function() {} };
+
+// Richtig
+export function onLoad(ctx: Xrm.Events.EventContext) {}
+```

package/docs/architektur/11-agent-md.md

@@ -1,38 +1,38 @@
-# 11. AGENT.md System
-
-## 11.1 Zweck
-
-Die AGENT.md ist eine generierte Datei, die KI-Coding-Assistenten (Claude, ChatGPT, Copilot, Cursor) beibringt, wie sie optimale D365-Formularskripte mit XrmForge schreiben. Sie wird von `xrmforge init` erzeugt und im Projektstamm abgelegt.
-
-## 11.2 Inhaltsstruktur
-
-1. **Package-Übersicht** - Was jedes @xrmforge-Package tut
-2. **10 Regeln: Immer** - Fields Enum, OptionSet Enum, FormContext-Cast, EntityNames, parseLookup, select, createFormMock, Modul-Exports, Tabs/Sections Enums, Fehlerbehandlung
-3. **Regeln: Niemals** - Rohe Strings, Magic Numbers, Xrm.Page, synchrone XHR, eval, window-Zuweisungen
-4. **Vorher/Nachher-Beispiele** - Feldzugriff, OptionSet-Vergleich, Testen
-5. **Pattern-Erkennungstabelle** - Zuordnung von Legacy-Pattern zu XrmForge-Ersetzung
-6. **OptionSet-Enum-Erstellungsanleitung** - Wie man Enums aus Magic Numbers in Legacy-Code erstellt
-7. **Testen mit setupXrmMock** - Globales Xrm-Mock-Pattern
-8. **Build-Befehle** - xrmforge build, Watch-Modus
-9. **@types/xrm-Fallstricke** - Bekannte Probleme und Workarounds
-10. **Dateistruktur** - Erwartetes Projektlayout
-
-## 11.3 Template-System
-
-Die AGENT.md ist als `src/scaffold/templates/AGENT.md` im devkit-Package gespeichert und wird zur Scaffolding-Zeit über `template-loader.ts` geladen. Es ist keine Variablenersetzung nötig (die Datei ist statisch).
-
-## 11.4 Ergebnisse des KI-Vergleichstests
-
-Fünf KI-Modelle wurden beim Konvertieren von Legacy-D365-JavaScript (account.js + lm_helper.js, 1.288 Zeilen) zu TypeScript mit XrmForge getestet:
-
-| Rang | Modell | Punkte | Werkzeug | Stärke |
-|------|--------|--------|----------|--------|
-| 1 | Claude Opus 4.6 | 42/50 | Claude Code | Meiste Tests (62), beste Codestruktur |
-| 2 | Claude Sonnet 4.6 | 41/50 | Claude Code | Meiste Bugs gefunden (5), bester DI-Ansatz |
-| 3 | Cursor Composer 2 | 35/50 | Cursor IDE | Hat select() Node-API-Problem erkannt |
-| 4 | ChatGPT GPT-4o | 30/50 | ChatGPT Web | Funktional, aber weniger XrmForge-spezifisch |
-| 5 | MS Copilot | 12/50 | Browser-Chat | Kein Workspace-Zugriff, hat AGENT.md nie gesehen |
-
-**Kriterien (11, maximal 5 Punkte je = 55 max):** Fields-Enum-Nutzung, OptionSet-Enums, FormContext-Typisierung, XrmForge-Helpers, Modul-Exports, Tests vorhanden, Testqualität, Fehlerbehandlung, Codequalität, gefundene Bugs, Dokumentation.
-
-**Zentrale Erkenntnis:** Keine KI hat konsistent `@xrmforge/helpers`-Imports (select, parseLookup) verwendet. Dies bleibt die grösste Adoptionslücke.
+# 11. AGENT.md System
+
+## 11.1 Zweck
+
+Die AGENT.md ist eine generierte Datei, die KI-Coding-Assistenten (Claude, ChatGPT, Copilot, Cursor) beibringt, wie sie optimale D365-Formularskripte mit XrmForge schreiben. Sie wird von `xrmforge init` erzeugt und im Projektstamm abgelegt.
+
+## 11.2 Inhaltsstruktur
+
+1. **Package-Übersicht** - Was jedes @xrmforge-Package tut
+2. **10 Regeln: Immer** - Fields Enum, OptionSet Enum, FormContext-Cast, EntityNames, parseLookup, select, createFormMock, Modul-Exports, Tabs/Sections Enums, Fehlerbehandlung
+3. **Regeln: Niemals** - Rohe Strings, Magic Numbers, Xrm.Page, synchrone XHR, eval, window-Zuweisungen
+4. **Vorher/Nachher-Beispiele** - Feldzugriff, OptionSet-Vergleich, Testen
+5. **Pattern-Erkennungstabelle** - Zuordnung von Legacy-Pattern zu XrmForge-Ersetzung
+6. **OptionSet-Enum-Erstellungsanleitung** - Wie man Enums aus Magic Numbers in Legacy-Code erstellt
+7. **Testen mit setupXrmMock** - Globales Xrm-Mock-Pattern
+8. **Build-Befehle** - xrmforge build, Watch-Modus
+9. **@types/xrm-Fallstricke** - Bekannte Probleme und Workarounds
+10. **Dateistruktur** - Erwartetes Projektlayout
+
+## 11.3 Template-System
+
+Die AGENT.md ist als `src/scaffold/templates/AGENT.md` im devkit-Package gespeichert und wird zur Scaffolding-Zeit über `template-loader.ts` geladen. Es ist keine Variablenersetzung nötig (die Datei ist statisch).
+
+## 11.4 Ergebnisse des KI-Vergleichstests
+
+Fünf KI-Modelle wurden beim Konvertieren von Legacy-D365-JavaScript (account.js + lm_helper.js, 1.288 Zeilen) zu TypeScript mit XrmForge getestet:
+
+| Rang | Modell | Punkte | Werkzeug | Stärke |
+|------|--------|--------|----------|--------|
+| 1 | Claude Opus 4.6 | 42/50 | Claude Code | Meiste Tests (62), beste Codestruktur |
+| 2 | Claude Sonnet 4.6 | 41/50 | Claude Code | Meiste Bugs gefunden (5), bester DI-Ansatz |
+| 3 | Cursor Composer 2 | 35/50 | Cursor IDE | Hat select() Node-API-Problem erkannt |
+| 4 | ChatGPT GPT-4o | 30/50 | ChatGPT Web | Funktional, aber weniger XrmForge-spezifisch |
+| 5 | MS Copilot | 12/50 | Browser-Chat | Kein Workspace-Zugriff, hat AGENT.md nie gesehen |
+
+**Kriterien (11, maximal 5 Punkte je = 55 max):** Fields-Enum-Nutzung, OptionSet-Enums, FormContext-Typisierung, XrmForge-Helpers, Modul-Exports, Tests vorhanden, Testqualität, Fehlerbehandlung, Codequalität, gefundene Bugs, Dokumentation.
+
+**Zentrale Erkenntnis:** Keine KI hat konsistent `@xrmforge/helpers`-Imports (select, parseLookup) verwendet. Dies bleibt die grösste Adoptionslücke.

package/docs/architektur/12-xrm-fallstricke.md

@@ -1,14 +1,14 @@
-# 12. @types/xrm-Fallstricke
-
-Bekannte Probleme bei der Arbeit mit `@types/xrm`:
-
-| Problem | Falsch | Richtig |
-|---------|--------|---------|
-| Form-Interface | `interface extends Xrm.FormContext` | `extends Omit<Xrm.FormContext, 'getAttribute' \| 'getControl'>` |
-| AlertDialogResponse | `Xrm.Navigation.AlertDialogResponse` | `Xrm.Async.PromiseLike<void>` (Typ existiert nicht) |
-| ConfirmDialogResponse | `Xrm.Navigation.ConfirmDialogResponse` | `Xrm.Navigation.ConfirmResult` (Typ existiert nicht) |
-| setNotification | `setNotification(message)` | `setNotification(message, uniqueId)` (erfordert 2 Argumente) |
-| openFile | `openFile({ fileName, ... })` | Muss `fileSize`-Eigenschaft in FileDetails enthalten |
-| SubmitMode | `Xrm.Attributes.SubmitMode` | `Xrm.SubmitMode` |
-| const enum in .d.ts | `const enum` in `.d.ts`-Dateien | `const enum` in `.ts`-ES-Modulen verwenden (typegen 0.8.0+ generiert `.ts`-Dateien, wodurch dieses Problem gelöst ist) |
-| Grid.refresh() | `grid.refresh()` | `(grid as any).refresh()` (nicht typisiert in @types/xrm) |
+# 12. @types/xrm-Fallstricke
+
+Bekannte Probleme bei der Arbeit mit `@types/xrm`:
+
+| Problem | Falsch | Richtig |
+|---------|--------|---------|
+| Form-Interface | `interface extends Xrm.FormContext` | `extends Omit<Xrm.FormContext, 'getAttribute' \| 'getControl'>` |
+| AlertDialogResponse | `Xrm.Navigation.AlertDialogResponse` | `Xrm.Async.PromiseLike<void>` (Typ existiert nicht) |
+| ConfirmDialogResponse | `Xrm.Navigation.ConfirmDialogResponse` | `Xrm.Navigation.ConfirmResult` (Typ existiert nicht) |
+| setNotification | `setNotification(message)` | `setNotification(message, uniqueId)` (erfordert 2 Argumente) |
+| openFile | `openFile({ fileName, ... })` | Muss `fileSize`-Eigenschaft in FileDetails enthalten |
+| SubmitMode | `Xrm.Attributes.SubmitMode` | `Xrm.SubmitMode` |
+| const enum in .d.ts | `const enum` in `.d.ts`-Dateien | `const enum` in `.ts`-ES-Modulen verwenden (typegen 0.8.0+ generiert `.ts`-Dateien, wodurch dieses Problem gelöst ist) |
+| Grid.refresh() | `grid.refresh()` | `(grid as any).refresh()` (nicht typisiert in @types/xrm) |

package/docs/architektur/13-helpers.md

@@ -1,50 +1,50 @@
-# 13. @xrmforge/helpers Package
-
-## 13.1 Problem
-
-Der bisherige Ansatz nutzte einen `/helpers`-Subpath-Export auf `@xrmforge/typegen`. Das war verwirrend, weil typegen ein Node.js-Codegenerierungstool ist, während die Helpers browsersichere Laufzeitfunktionen sind. Der Subpath `@xrmforge/typegen/helpers` war nicht intuitiv und KI-Coding-Assistenten haben ihn durchgängig nicht gefunden.
-
-## 13.2 Lösung
-
-Ein eigenständiges `@xrmforge/helpers`-Package bündelt allen browsersicheren Laufzeitcode. Keine Node.js-Abhängigkeiten. Klarer, auffindbarer Import-Pfad:
-
-```typescript
-// Import vom dedizierten helpers-Package
-import { select, parseLookup, typedForm } from '@xrmforge/helpers';
-```
-
-## 13.3 Exports
-
-**Web-API-Helpers:**
-- `select(...fields: string[]): string` - Erstellt `?$select=field1,field2`
-- `selectExpand(fields: string[], expand: string): string` - Erstellt `?$select=...&$expand=...`
-- `parseLookup(response: Record<string, unknown>, fieldName: string): LookupValue | null` - Parst `_fieldname_value` mit OData-Annotationen
-- `parseLookups(response: Record<string, unknown>, fieldName: string): LookupValue[]` - Multi-Value-Lookup-Parsing
-- `parseFormattedValue(response: Record<string, unknown>, fieldName: string): string | null` - Extrahiert `@OData.Community.Display.V1.FormattedValue`
-
-**Xrm-Konstanten (8 const enums):**
-- DisplayState, FormNotificationLevel, RequiredLevel, SubmitMode, SaveMode, ClientType, ClientState, OperationType
-
-**typedForm()-Proxy:**
-- `typedForm<TForm>(formContext)` - Gibt einen Proxy zurück, bei dem `form.name` an `getAttribute('name')` delegiert
-- GET-Trap: Property-Zugriff delegiert an getAttribute(); `$context` gibt den rohen FormContext zurück; `$control(name)` gibt getControl() zurück
-- SET-Trap: Wirft TypeError und erzwingt die Verwendung von `.setValue()`
-- HAS-Trap: Prüft, ob ein Attribut auf dem Formular existiert
-
-**Action/Function-Laufzeit:**
-- `createBoundAction(entityName, actionName)` - Erstellt einen gebundenen Action-Executor
-- `executeRequest(request)` - Führt einen Organization Request über Xrm.WebApi.online.execute aus
-- `withProgress(message, fn)` - Umhüllt eine asynchrone Operation mit Xrm.Utility.showProgressIndicator
-
-## 13.4 Migration
-
-Der alte Import-Pfad `@xrmforge/typegen/helpers` wurde entfernt. Alle Imports aktualisieren:
-
-```typescript
-// Alt (entfernt)
-import { select } from '@xrmforge/typegen/helpers';
-import { typedForm } from '@xrmforge/formhelpers';
-
-// Neu
-import { select, typedForm } from '@xrmforge/helpers';
-```
+# 13. @xrmforge/helpers Package
+
+## 13.1 Problem
+
+Der bisherige Ansatz nutzte einen `/helpers`-Subpath-Export auf `@xrmforge/typegen`. Das war verwirrend, weil typegen ein Node.js-Codegenerierungstool ist, während die Helpers browsersichere Laufzeitfunktionen sind. Der Subpath `@xrmforge/typegen/helpers` war nicht intuitiv und KI-Coding-Assistenten haben ihn durchgängig nicht gefunden.
+
+## 13.2 Lösung
+
+Ein eigenständiges `@xrmforge/helpers`-Package bündelt allen browsersicheren Laufzeitcode. Keine Node.js-Abhängigkeiten. Klarer, auffindbarer Import-Pfad:
+
+```typescript
+// Import vom dedizierten helpers-Package
+import { select, parseLookup, typedForm } from '@xrmforge/helpers';
+```
+
+## 13.3 Exports
+
+**Web-API-Helpers:**
+- `select(...fields: string[]): string` - Erstellt `?$select=field1,field2`
+- `selectExpand(fields: string[], expand: string): string` - Erstellt `?$select=...&$expand=...`
+- `parseLookup(response: Record<string, unknown>, fieldName: string): LookupValue | null` - Parst `_fieldname_value` mit OData-Annotationen
+- `parseLookups(response: Record<string, unknown>, fieldName: string): LookupValue[]` - Multi-Value-Lookup-Parsing
+- `parseFormattedValue(response: Record<string, unknown>, fieldName: string): string | null` - Extrahiert `@OData.Community.Display.V1.FormattedValue`
+
+**Xrm-Konstanten (8 const enums):**
+- DisplayState, FormNotificationLevel, RequiredLevel, SubmitMode, SaveMode, ClientType, ClientState, OperationType
+
+**typedForm()-Proxy:**
+- `typedForm<TForm>(formContext)` - Gibt einen Proxy zurück, bei dem `form.name` an `getAttribute('name')` delegiert
+- GET-Trap: Property-Zugriff delegiert an getAttribute(); `$context` gibt den rohen FormContext zurück; `$control(name)` gibt getControl() zurück
+- SET-Trap: Wirft TypeError und erzwingt die Verwendung von `.setValue()`
+- HAS-Trap: Prüft, ob ein Attribut auf dem Formular existiert
+
+**Action/Function-Laufzeit:**
+- `createBoundAction(entityName, actionName)` - Erstellt einen gebundenen Action-Executor
+- `executeRequest(request)` - Führt einen Organization Request über Xrm.WebApi.online.execute aus
+- `withProgress(message, fn)` - Umhüllt eine asynchrone Operation mit Xrm.Utility.showProgressIndicator
+
+## 13.4 Migration
+
+Der alte Import-Pfad `@xrmforge/typegen/helpers` wurde entfernt. Alle Imports aktualisieren:
+
+```typescript
+// Alt (entfernt)
+import { select } from '@xrmforge/typegen/helpers';
+import { typedForm } from '@xrmforge/formhelpers';
+
+// Neu
+import { select, typedForm } from '@xrmforge/helpers';
+```

package/docs/architektur/14-showcases.md

@@ -1,21 +1,21 @@
-# 14. Showcases
-
-## 14.1 Markant WebResources (Produktions-Showcase)
-
-Befindet sich im XrmForge-Workspace-Repository unter `docs/07_showcase/markant-webresources/`.
-
-- **30 WebResources** in `src/forms/` (Account, Contact, Opportunity, Lead, Quote, Email, Task usw.)
-- **1 gemeinsame Bibliothek** (DSGVO-Aufbewahrungsfristen-UI)
-- **9 Testdateien** mit 59 Tests
-- **79 generierte Typings:** 25 Form-Interfaces, 28 Entity-Interfaces, 22 OptionSet-Dateien, 4 Action-Executors
-- **esbuild-Build** über xrmforge.config.json (32 Einträge)
-- **Deploy-Skript** (deploy.mjs) mit @azure/identity-Authentifizierung, inkrementellem Deployment, Hash-basierter Änderungserkennung
-- **27 Entitäten, 236 OptionSet-Enums, 95 Form-Interfaces, 7 Custom-API-Executors**
-
-## 14.2 LMApp WebResources (KI-Vergleichs-Showcase)
-
-Erstellt während der KI-Vergleichstests (Session 9). 18 Legacy-JavaScript-Formularskripte (~8.400 Zeilen) zu TypeScript mit XrmForge-Patterns konvertiert.
-
-- **19 WebResources** mit Fields Enums, EntityNames, OptionSet Enums
-- **84 Tests** in 8 Testdateien
-- **XrmForge-optimiert:** Alle 10 AGENT.md-Regeln angewendet (FormContext-Cast, Fields Enum, EntityNames, OptionSet Enums, gemeinsames getLookupObject, Tab Enums)
+# 14. Showcases
+
+## 14.1 Markant WebResources (Produktions-Showcase)
+
+Befindet sich im XrmForge-Workspace-Repository unter `docs/07_showcase/markant-webresources/`.
+
+- **30 WebResources** in `src/forms/` (Account, Contact, Opportunity, Lead, Quote, Email, Task usw.)
+- **1 gemeinsame Bibliothek** (DSGVO-Aufbewahrungsfristen-UI)
+- **9 Testdateien** mit 59 Tests
+- **79 generierte Typings:** 25 Form-Interfaces, 28 Entity-Interfaces, 22 OptionSet-Dateien, 4 Action-Executors
+- **esbuild-Build** über xrmforge.config.json (32 Einträge)
+- **Deploy-Skript** (deploy.mjs) mit @azure/identity-Authentifizierung, inkrementellem Deployment, Hash-basierter Änderungserkennung
+- **27 Entitäten, 236 OptionSet-Enums, 95 Form-Interfaces, 7 Custom-API-Executors**
+
+## 14.2 LMApp WebResources (KI-Vergleichs-Showcase)
+
+Erstellt während der KI-Vergleichstests (Session 9). 18 Legacy-JavaScript-Formularskripte (~8.400 Zeilen) zu TypeScript mit XrmForge-Patterns konvertiert.
+
+- **19 WebResources** mit Fields Enums, EntityNames, OptionSet Enums
+- **84 Tests** in 8 Testdateien
+- **XrmForge-optimiert:** Alle 10 AGENT.md-Regeln angewendet (FormContext-Cast, Fields Enum, EntityNames, OptionSet Enums, gemeinsames getLookupObject, Tab Enums)

package/docs/architektur/15-ci-cd.md

@@ -1,49 +1,49 @@
-# 15. CI/CD
-
-## 15.1 GitHub Actions CI (`.github/workflows/ci.yml`)
-
-**Auslöser:** Push auf main, Pull Requests gegen main.
-
-**Matrix:** Node 20, Node 22 auf ubuntu-latest.
-
-**Schritte:**
-1. Checkout
-2. pnpm einrichten (aus packageManager-Feld)
-3. Node.js einrichten (Matrix-Version)
-4. `pnpm install --frozen-lockfile`
-5. `pnpm lint`
-6. `pnpm -r exec tsc --noEmit` (Typecheck aller Packages)
-7. `pnpm build`
-8. `pnpm test`
-9. Coverage (nur Node 22): `npx vitest run --coverage` in typegen
-
-## 15.2 Release-Workflow (`.github/workflows/release.yml`)
-
-**Auslöser:** Nach erfolgreicher CI bei Push auf main.
-
-**Schritte:**
-1. Checkout, pnpm einrichten, Node 22 einrichten
-2. `pnpm install --frozen-lockfile`
-3. `pnpm build`
-4. Changesets-Action: erstellt Release-PR oder veröffentlicht auf npm
-
-**Publish-Befehl:** `pnpm release` = `turbo run build && changeset publish`
-
-## 15.3 Turbo-Pipeline
-
-```
-build:      dependsOn: [^build], outputs: [dist/**]
-test:       dependsOn: [build]
-typecheck:  dependsOn: [^build]
-lint:       (keine Abhängigkeiten)
-dev:        cache: false, persistent: true
-clean:      cache: false
-```
-
-## 15.4 Changesets
-
-Konfiguriert für öffentlichen npm-Zugriff, automatische Aktualisierung interner Abhängigkeiten auf Patch-Ebene. Veröffentlichung erfordert NPM_TOKEN Secret.
-
-## 15.5 Veröffentlichungsreihenfolge
-
-Aufgrund interner Abhängigkeiten: zuerst typegen, dann devkit, dann cli. Es muss `pnpm publish` verwendet werden (nicht `npm publish`), um `workspace:*`-Referenzen in echte Versionen aufzulösen.
+# 15. CI/CD
+
+## 15.1 GitHub Actions CI (`.github/workflows/ci.yml`)
+
+**Auslöser:** Push auf main, Pull Requests gegen main.
+
+**Matrix:** Node 20, Node 22 auf ubuntu-latest.
+
+**Schritte:**
+1. Checkout
+2. pnpm einrichten (aus packageManager-Feld)
+3. Node.js einrichten (Matrix-Version)
+4. `pnpm install --frozen-lockfile`
+5. `pnpm lint`
+6. `pnpm -r exec tsc --noEmit` (Typecheck aller Packages)
+7. `pnpm build`
+8. `pnpm test`
+9. Coverage (nur Node 22): `npx vitest run --coverage` in typegen
+
+## 15.2 Release-Workflow (`.github/workflows/release.yml`)
+
+**Auslöser:** Nach erfolgreicher CI bei Push auf main.
+
+**Schritte:**
+1. Checkout, pnpm einrichten, Node 22 einrichten
+2. `pnpm install --frozen-lockfile`
+3. `pnpm build`
+4. Changesets-Action: erstellt Release-PR oder veröffentlicht auf npm
+
+**Publish-Befehl:** `pnpm release` = `turbo run build && changeset publish`
+
+## 15.3 Turbo-Pipeline
+
+```
+build:      dependsOn: [^build], outputs: [dist/**]
+test:       dependsOn: [build]
+typecheck:  dependsOn: [^build]
+lint:       (keine Abhängigkeiten)
+dev:        cache: false, persistent: true
+clean:      cache: false
+```
+
+## 15.4 Changesets
+
+Konfiguriert für öffentlichen npm-Zugriff, automatische Aktualisierung interner Abhängigkeiten auf Patch-Ebene. Veröffentlichung erfordert NPM_TOKEN Secret.
+
+## 15.5 Veröffentlichungsreihenfolge
+
+Aufgrund interner Abhängigkeiten: zuerst typegen, dann devkit, dann cli. Es muss `pnpm publish` verwendet werden (nicht `npm publish`), um `workspace:*`-Referenzen in echte Versionen aufzulösen.

package/docs/architektur/16-technische-schulden.md

@@ -1,17 +1,17 @@
-# 16. Technische Schulden
-
-## 16.1 Bekannte Probleme
-
-| Problem | Status | Priorität |
-|---------|--------|-----------|
-| parseLookup/select wird von KI-Assistenten nicht übernommen | Offen | Hoch |
-| release.yml doppelte Ausführungen (CI löst Release aus, Release löst CI erneut aus) | Offen | Niedrig |
-| Keine Integrationstests gegen Live-Dataverse | Offen (OE-4) | Mittel |
-| @xrmforge/webapi hat keine Action/Function-Unterstützung | Akzeptiert | Niedrig |
-| devDependency-Versionen im generierten package.json sind auf alte Versionen fixiert | Offen | Niedrig |
-
-## 16.2 Akzeptierte Einschränkungen
-
-- **const-enum-Einschränkung:** Gelöst in typegen 0.8.0. Generierter Output sind jetzt `.ts`-ES-Module, sodass `const enum` direkt mit vitest und anderen Test-Frameworks funktioniert.
-- **Grid.refresh() erfordert `as any`:** Nicht typisiert in @types/xrm.
-- **Eine Solution pro Entität:** Wenn eine Entität in mehreren Solutions vorkommt, wird sie nur einmal generiert.
+# 16. Technische Schulden
+
+## 16.1 Bekannte Probleme
+
+| Problem | Status | Priorität |
+|---------|--------|-----------|
+| parseLookup/select wird von KI-Assistenten nicht übernommen | Offen | Hoch |
+| release.yml doppelte Ausführungen (CI löst Release aus, Release löst CI erneut aus) | Offen | Niedrig |
+| Keine Integrationstests gegen Live-Dataverse | Offen (OE-4) | Mittel |
+| @xrmforge/webapi hat keine Action/Function-Unterstützung | Akzeptiert | Niedrig |
+| devDependency-Versionen im generierten package.json sind auf alte Versionen fixiert | Offen | Niedrig |
+
+## 16.2 Akzeptierte Einschränkungen
+
+- **const-enum-Einschränkung:** Gelöst in typegen 0.8.0. Generierter Output sind jetzt `.ts`-ES-Module, sodass `const enum` direkt mit vitest und anderen Test-Frameworks funktioniert.
+- **Grid.refresh() erfordert `as any`:** Nicht typisiert in @types/xrm.
+- **Eine Solution pro Entität:** Wenn eine Entität in mehreren Solutions vorkommt, wird sie nur einmal generiert.

package/docs/architektur/17-roadmap.md

@@ -1,25 +1,25 @@
-# 17. Roadmap
-
-## 17.1 Nächste Schritte (Prioritätsreihenfolge)
-
-1. **parseLookup/select-Adoption** - AGENT.md-Beispiele verbessern, damit KI-Assistenten konsistent `/helpers`-Imports verwenden
-2. **LMApp-Showcase-Neugenerierung** - Mit aktuellen Releases (testing@0.2.0, devkit@0.4.0 mit verbesserter AGENT.md)
-3. **KI-Battle Runde 3** - Sonnet vs. Opus erneut testen nach Verbesserungen, um Fortschritt zu messen
-4. **Dokumentationswebsite** - xrmforge.dev oder xrmforge.io (OE-3)
-
-## 17.2 Offene Entscheidungen
-
-| ID | Entscheidung | Status |
-|----|--------------|--------|
-| OE-1 | npm-Scope-Verfügbarkeit (@xrmforge) | Offen |
-| OE-2 | GitHub-Org vs. persönliches Repo | Entschieden: persönlich (juergenbeck/XrmForge) |
-| OE-3 | Dokumentationsdomain (xrmforge.dev oder .io) | Offen |
-| OE-4 | Dataverse-Testumgebung für Integrationstests | Offen |
-| OE-5 | Publisher-Prefix und Solution-Name für PCF/WebResource-Tests | Offen |
-
-## 17.3 Zukünftige Möglichkeiten
-
-- Relationship-Names const enum (OE-7, niedrige Priorität)
-- @xrmforge/webapi mit Action/Function-Unterstützung (DataverseHttpClient wiederverwenden)
-- Plugin-System für benutzerdefinierte Generatoren und Typ-Zuordnungen
-- Serverseitige Generierung (Custom API in Dataverse)
+# 17. Roadmap
+
+## 17.1 Nächste Schritte (Prioritätsreihenfolge)
+
+1. **parseLookup/select-Adoption** - AGENT.md-Beispiele verbessern, damit KI-Assistenten konsistent `/helpers`-Imports verwenden
+2. **LMApp-Showcase-Neugenerierung** - Mit aktuellen Releases (testing@0.2.0, devkit@0.4.0 mit verbesserter AGENT.md)
+3. **KI-Battle Runde 3** - Sonnet vs. Opus erneut testen nach Verbesserungen, um Fortschritt zu messen
+4. **Dokumentationswebsite** - xrmforge.dev oder xrmforge.io (OE-3)
+
+## 17.2 Offene Entscheidungen
+
+| ID | Entscheidung | Status |
+|----|--------------|--------|
+| OE-1 | npm-Scope-Verfügbarkeit (@xrmforge) | Offen |
+| OE-2 | GitHub-Org vs. persönliches Repo | Entschieden: persönlich (juergenbeck/XrmForge) |
+| OE-3 | Dokumentationsdomain (xrmforge.dev oder .io) | Offen |
+| OE-4 | Dataverse-Testumgebung für Integrationstests | Offen |
+| OE-5 | Publisher-Prefix und Solution-Name für PCF/WebResource-Tests | Offen |
+
+## 17.3 Zukünftige Möglichkeiten
+
+- Relationship-Names const enum (OE-7, niedrige Priorität)
+- @xrmforge/webapi mit Action/Function-Unterstützung (DataverseHttpClient wiederverwenden)
+- Plugin-System für benutzerdefinierte Generatoren und Typ-Zuordnungen
+- Serverseitige Generierung (Custom API in Dataverse)