@ccslabs/xtend 0.1.0-rc.1 → 0.1.2

package/docs/README.md

@@ -1,340 +1,264 @@
-# XTend Dokumentation – Inhaltsverzeichnis
+# XTend Dokumentation
 
-Willkommen zur offiziellen Dokumentation des XTend Web Frameworks. Dieses Inhaltsverzeichnis bietet einen schnellen Überblick und direkte Links zu allen relevanten Themen und Komponenten.
+Willkommen im XTend Developer Center. Diese Dokumentation ist fuer Entwickler
+geschrieben, die XTend kennenlernen, lokal ausprobieren und eigene Apps bauen
+wollen. Der empfohlene Pfad ist heute RMT-first: Die App Shell, Routen,
+Surfaces, State, Actions, Events und UI-Lifecycle-Regeln werden in RMT vNext
+authoriert; XTend Components, XRouter, Fabric und Host-Adapter materialisieren
+diese Beschreibung im Browser.
 
----
+Historische Planungs- und Release-Notizen sind im
+[XTend Changelog](./changelog.md) gebuendelt. Die Artikel hier konzentrieren
+sich auf produktives Arbeiten.
+
+## Lernpfade
+
+| Ziel | Einstieg |
+| --- | --- |
+| Erste lokale App starten | [Quick Start Guide](./quick-start-guide.md) |
+| UI komplett in RMT schreiben | [RMT vNext Authoring Guide](./rmt-vnext-authoring.md) |
+| RMT-Primitives mit XTend UI verbinden | [RMT vNext Component Primitives und XTend UI](./rmt-vnext-component-primitives.md) |
+| RMT serverseitig vorhydrieren | [RMT Node SSR Adapter](./rmt-node-ssr-adapter.md) und [RMT PHP/Laravel SSR Adapter](./rmt-php-ssr-adapter.md) |
+| RMT Architektur verstehen | [XTendRMT Developer Overview](./xtendrmt-overview.md) |
+| Komponenten nutzen oder bauen | [Komponenten-Entwicklung](./components.md) und [Component Platform](./component-platform.md) |
+| Loader, Manifest und Runtime anbinden | [XTend Loader](./xtend-loader.md), [Manifest-Format](./manifest.md), [API-Integration](./api.md) |
+| Qualitaet, Security und Release-Signale verstehen | [Best Practices](./best-practices.md), [Trusted DOM und Sanitizing](./trusted-dom-sanitizing.md), [Supply-Chain Gates](./supply-chain-gates.md) |
+
+## Start
+
+Beginne mit einer lokalen Web-Component-App und erweitere sie dann zu einer
+RMT-vNext-App-Shell:
 
-## Einstieg & Grundlagen
 - [Quick Start Guide](./quick-start-guide.md)
 - [XTend Loader](./xtend-loader.md)
-- [XTend-Fabric Runtime](./xtend-fabric.md)
-- [XTend-Fabric RMT Lane Mapping](./xtend-fabric-rmt-lane-mapping.md)
-- [Performance fuer Komponentenautoren](./performance.md)
-- [Performance Measurements](./performance-measurements.md)
-- [Performance Regression](./performance-regression.md)
-- [Hydration Policies](./hydration-policies.md)
-- [A11y Keyboard Smokes](./a11y-keyboard-smokes.md)
-- [Screenreader Signals](./screenreader-signals.md)
-- [Motion und Contrast](./motion-contrast.md)
-- [Manifest Import Policy](./manifest-import-policy.md)
-- [Trusted DOM und Sanitizing](./trusted-dom-sanitizing.md)
-- [Trusted DOM Boundary Browser Proof](./trusted-dom-boundary-browser-proof.md)
-- [Supply-Chain Gates](./supply-chain-gates.md)
-- [Component Catalog Coverage](./component-catalog-coverage.md)
-- [Public Component Types](./public-component-types.md)
-- [Design Tokens](./design-tokens.md)
-- [Drittanbieter Design Authoring](./third-party-design-authoring.md)
-- [Enterprise Component Flex Release Handoff](./enterprise-component-flex-release-handoff.md)
-- [RMT DSL Authoring Polish](./rmt-dsl-authoring-polish.md)
-- [RMT Linter und AI-Agent Repair Report](./rmt-linter.md)
-- [RMT Language Server und Editor Setup](./rmt-language-server.md)
-- [RC0 Gate Matrix](./rc0-gate-matrix.md)
-- [RC0 Adoption Guide](./rc0-adoption-guide.md)
-- [Epic 12 RC0 Handoff](./epic12-rc0-handoff.md)
-- [RC1 Readiness](./rc1-readiness.md)
-- [Release Owner Acceptance](./release-owner-acceptance.md)
-- [Conditional Network Evidence](./conditional-network-evidence.md)
-- [Conditional Network Evidence CI](./conditional-network-evidence-ci.md)
-- [Package Export Lock](./package-export-lock.md)
-- [TypeExports](./type-exports.md)
-- [XTend Loader Types](./xtend-loader-types.md)
-- [XTend API Types](./xtend-api-types.md)
-- [XTend RMT Types](./xtend-rmt-types.md)
-- [XTend Policy Types](./xtend-policy-types.md)
-- [XTend Builder Types](./xtend-builder-types.md)
-- [XTend Catalog Types](./xtend-catalog-types.md)
-- [XTend Vendor and Utility Types](./xtend-vendor-types.md)
-- [Known Residual Triage](./known-residual-triage.md)
-- [Hydration Performance Closure](./hydration-performance-closure.md)
-- [PROD Browser CSP Smokes](./prod-browser-csp-smokes.md)
-- [Visual Owner Artifacts](./visual-owner-artifacts.md)
-- [RMT Production Readiness](./rmt-production-readiness.md)
-- [Docs RMT Production Hardening](./docs-rmt-production-hardening.md)
-- [RC1 Migration Notes](./rc1-migration-notes.md)
-- [RC1 Gate Matrix und CI-Handoff](./rc1-gate-matrix-ci-handoff.md)
-- [Release Report und Pack Dry Run Evidence](./release-report-pack-dry-run-evidence.md)
-- [RMT-first XTend Apps](./rmt-first-xtend-apps.md)
-- [SurfaceManager RMT Authoring](./surface-manager-rmt-authoring.md)
-- [SurfaceManager Controller](./surface-manager-controller.md)
-- [SurfaceManager Window Runtime](./surface-manager-window-runtime.md)
-- [SurfaceManager SidePanel Runtime](./surface-manager-side-panel-runtime.md)
-- [SurfaceManager Workbench Fixture](./surface-manager-workbench-fixture.md)
-- [SurfaceManager Overlay Bridge](./surface-manager-overlay-bridge.md)
-- [SurfaceManager Quality Gates](./surface-manager-quality-gates.md)
-- [SurfaceManager Native RMT Surfaces](./surface-manager-native-rmt-surfaces.md)
-- [SurfaceManager Authoring Guide](./surface-manager-authoring-guide.md)
-- [SurfaceManager Component Lab](./surface-manager-component-lab.md)
-- [SurfaceManager Migration Guide](./surface-manager-migration-guide.md)
-- [SurfaceManager Release Handoff](./surface-manager-release-handoff.md)
-- [Component UX Authoring](./component-ux-authoring.md)
-- [Component UX App Authoring](./component-ux-app-authoring.md)
-- [Component UX Gates](./component-ux-gates.md)
-- [Component Long-Tail Migration](./component-long-tail-migration.md)
-- [Epic 11 Enterprise UX Handoff](./epic11-enterprise-ux-handoff.md)
-- [Component Lab](./component-lab.md)
-- [RMT-first Demo-App](./rmt-first-demo-app.md)
-- [RMT Lifecycle Demo](./rmt-lifecycle-demo.md)
-- [Existing Component Metadata](./existing-component-metadata.md)
-- [Epic 10 Platform Gates](./epic10-platform-gates.md)
-- [Epic 10 Release Handoff](./epic10-release-handoff.md)
-- [Visual Browser Regression](./visual-browser-regression.md)
-- [Visual Snapshot Automation](./visual-snapshot-automation.md)
-- [Enterprise Adoption Guide](./enterprise-adoption.md)
 - [Manifest-Format](./manifest.md)
-- [API-Integration](./api.md)
-- [Komponenten-Entwicklung](./components.md)
-- [Best Practices](./best-practices.md)
+- [Core Migration Guide](./core-migration-guide.md)
+- [Enterprise Adoption Guide](./enterprise-adoption.md)
+
+XTend bleibt framework-neutral. Du kannst eine einfache HTML-Seite starten,
+spaeter RMT fuer Shell und Routing ergaenzen und Host-spezifische Details in
+Adapter verschieben.
 
----
+## App Shell in RMT schreiben
 
-## XTendRMT
+RMT vNext ist die primaere Syntax fuer neue XTend Apps. Eine App kann State,
+Selectors, DataSources, Actions, Events, Portals, Overlays, Resources,
+Surfaces und Fabric-Lanes in einer `.rmt` Quelle beschreiben.
+
+- [RMT vNext Authoring Guide](./rmt-vnext-authoring.md)
+- [RMT vNext Component Primitives und XTend UI](./rmt-vnext-component-primitives.md)
+- [RMT Node SSR Adapter](./rmt-node-ssr-adapter.md)
+- [RMT PHP/Laravel SSR Adapter](./rmt-php-ssr-adapter.md)
 - [XTendRMT Developer Overview](./xtendrmt-overview.md)
 - [Native RMT Authoring](./xtendrmt-native-authoring.md)
 - [XTendRMT App-DSL Reference](./xtendrmt-app-dsl.md)
 - [XTendRMT Runtime Bridge](./xtendrmt-runtime-bridge.md)
 - [Native RMT Migration Guide](./xtendrmt-migration-guide.md)
-- [XTendRMT Parsedown Scheduling Pilot](./xtendrmt-parsedown-scheduling.md)
-- [RMT Linter und AI-Agent Repair Report](./rmt-linter.md)
-- [RMT Language Server und Editor Setup](./rmt-language-server.md)
-- [RMT Tooling Release Gates](./rmt-tooling-release-gates.md)
-- [RMT vNext Authoring Guide](./rmt-vnext-authoring.md)
+- [RMT-first XTend Apps](./rmt-first-xtend-apps.md)
+- [RMT-first Demo-App](./rmt-first-demo-app.md)
+- [RMT Lifecycle Demo](./rmt-lifecycle-demo.md)
+- [RMT App Platform Migration Guide](./rmt-app-platform-migration-guide.md)
 - [RMT vNext Migration Notes](./rmt-vnext-migration-notes.md)
 - [RMT vNext Release Handoff](./rmt-vnext-release-handoff.md)
 - [RMT vNext Remote Surfaces](./rmt-vnext-remote-surfaces.md)
 - [RMT vNext Enterprise Surface Registry](./rmt-vnext-surface-registry-enterprise.md)
 - [RMT vNext Cross Surface Events](./rmt-vnext-cross-surface-events.md)
 - [RMT vNext Enterprise MFE Handoff](./rmt-vnext-enterprise-mfe-handoff.md)
-- [RMT Kernel Security Hardening Migration](./rmt-kernel-security-hardening-migration.md)
-- [RMT Kernel Trusted Output Authoring](./rmt-kernel-trusted-output-authoring.md)
-- [RMT Kernel Panic Recovery Incident Handoff](./rmt-kernel-panic-recovery-incident-handoff.md)
-
-XTendRMT ist nach Epic 05 als produktiver Scheduler-, Runtime- und Templating-Pfad dokumentiert. XTend UI bleibt das Web-Component-Produkt; RMT fuehrt native `adapters`, `components`, `routes`, `schedules` und `templates` als host-neutrale App-DSL. XRouter und XTend Components werden ueber produktive Adapter angebunden, waehrend React-, Vue-, Vanilla- und Custom-Hosts eigene Adapter verwenden koennen.
-
-Die Docs-App selbst nutzt weiterhin PHP/Parsedown fuer Markdown-Rendering und XTend/XRouter fuer die SPA-Oberflaeche. Seit dem Shell-first-Refactor rendert `docs/utils/pageloader.js` die App Shell aber aus `docs/xtendrmt-parsedown-docs.rmt`: `docs.app.shell` erzeugt die sichtbare Route-Shell, `docs.header.search` erzeugt die Header-Suche, und Parsedown fuellt nur noch den RMT-Content-Slot. Das Dokument [XTendRMT Parsedown Scheduling Pilot](./xtendrmt-parsedown-scheduling.md) beschreibt diesen Pfad mit `xtend.docs.parsedown-rmt-pilot.v1` und `npm run test:docs-rmt-pilot`.
-
-[RMT Linter und AI-Agent Repair Report](./rmt-linter.md) dokumentiert ab `WP-E14-14` den Contract `xtend.rmt.tooling-docs.v1`, die lokalen Befehle `xt rmt lint`, `xt rmt lint --json`, `xt rmt lint --agent` und den Gate `node scripts/run_xtend_tests.js rmt-tooling-docs --json`.
-
-[RMT Language Server und Editor Setup](./rmt-language-server.md) dokumentiert ab `WP-E14-14` den LSP-Start ueber `node tools/rmt-language-server/server.js`, die Snippets aus `tools/rmt-language/snippets/`, VS-Code-Bridge, JetBrains, Neovim und Helix Setup. Der Language Server bleibt die einzige fachliche Source of Truth fuer Editor-Integrationen.
-
-[RMT Tooling Release Gates](./rmt-tooling-release-gates.md) dokumentiert ab `WP-E14-15` den Contract `xtend.epic14.rmt-tooling.v1`, die optionalen PR-Befehle `npm run test:pr:rmt` und `npm run test:pr:rmt:report`, den Release-Bundle-Gate `npm run test:rmt-tooling` und den Self-Gate `node scripts/run_xtend_tests.js epic14-rmt-tooling --json`.
-
-Epic 14 ist ab `WP-E14-16` abgeschlossen. Der Handoff `xtend.epic14.lsp-handoff.v1` liegt in [Epic 14 Abschluss und LSP Handoff](../development/XTendRMT-Epic14-Abschluss-und-LSP-Handoff.md) und beschreibt die LSP Capability Matrix, Known Limitations und die Folgepfade fuer RMT DSL Syntax, Formatter und Project Index.
-
-[RMT vNext Authoring Guide](./rmt-vnext-authoring.md), [RMT vNext Migration Notes](./rmt-vnext-migration-notes.md) und [RMT vNext Release Handoff](./rmt-vnext-release-handoff.md) dokumentieren ab `WP-E15-18` den Abschluss `xtend.rmt.vnext-release-handoff.v1`. Die Reference Demo liegt in `xtendrmt/rmt-vnext-reference-demo.rmt`, der stabile Core-Output in `xtendrmt/rmt-vnext-reference-demo.core.json`, und der lokale Gate ist `node scripts/run_xtend_tests.js rmt-vnext-release --json`.
-
-[RMT vNext Remote Surfaces](./rmt-vnext-remote-surfaces.md), [RMT vNext Enterprise Surface Registry](./rmt-vnext-surface-registry-enterprise.md), [RMT vNext Cross Surface Events](./rmt-vnext-cross-surface-events.md) und [RMT vNext Enterprise MFE Handoff](./rmt-vnext-enterprise-mfe-handoff.md) dokumentieren ab `WP-E16-12` den Abschluss `xtend.rmt.vnext-enterprise-release-handoff.v1` mit Zielreife `rmt-vnext-enterprise-mfe-ready`. Die Enterprise Demo liegt in `xtendrmt/rmt-vnext-enterprise-mfe-demo.rmt`, der stabile Core-Output in `xtendrmt/rmt-vnext-enterprise-mfe-demo.core.json`, und der lokale Gate ist `node scripts/run_xtend_tests.js rmt-vnext-enterprise-release --json`.
-
-[RMT Kernel Security Hardening Migration](./rmt-kernel-security-hardening-migration.md), [RMT Kernel Trusted Output Authoring](./rmt-kernel-trusted-output-authoring.md) und [RMT Kernel Panic Recovery Incident Handoff](./rmt-kernel-panic-recovery-incident-handoff.md) dokumentieren ab `RKSH-WP-11` den Contract `xtend.rmt.kernel-migration-authoring-incident-handoff.v1`. Der Gate `node scripts/run_xtend_tests.js rmt-kernel-handoff-docs --json` prueft Migration, sichere Authoring-Muster, Panic-/Recovery-Handoff, Package-Metadaten und Docs-Menue.
-
-## Enterprise Runtime
-
-[XTend-Fabric Runtime](./xtend-fabric.md) dokumentiert den ab `ER-WP-08` produktiven Host-Kern fuer `createXtendFabric`, `runFiber`, `emitDiagnostic`, `wrapComponent`, opt-in Reporter, redigierte Diagnostics, die Runtime Diagnostics Bridge fuer `xstate`, API Compliance und XTendRMT Diagnostics, Component Mount/Hydration Fibers, Route Navigation/Render Fibers, Telemetry Snapshots, Backpressure-Signale und die spaetere Kopplung an XTendRMT Adapter-/Bridge-Signale.
-
-[XTend-Fabric RMT Lane Mapping](./xtend-fabric-rmt-lane-mapping.md) dokumentiert ab `ER-WP-13`, wie Fabric-Lanes auf host-neutrale RMT Schedule Records abgebildet werden. Wichtig: `a11y` bleibt Fabric-semantisch und wird im RMT Schedule als `user-blocking` mit `metadata.fabricLane = "a11y"` gefuehrt.
-
-[Performance fuer Komponentenautoren](./performance.md) dokumentiert ab `ER-WP-21`, wie DOM-Zugriffe, Events, Shadow DOM, Layout, Animation und Hydration aus derselben Scaffold Policy `xtend.scaffold.performance-policy.v1` abgeleitet werden.
-
-[Performance Measurements](./performance-measurements.md) dokumentiert ab `ER-WP-18`, wie Loader, Hydration, Render und Route Render als `xtend.performance.measurement.v1` gemessen und in Fabric Telemetry Snapshots zusammengefuehrt werden.
-
-[Performance Regression](./performance-regression.md) dokumentiert ab `ER-WP-19`, wie lokale deterministische Baselines gegen Budget-Matrix und Fabric Measurements als `xtend.performance.regression-report.v1` ausgewertet werden.
-
-[Hydration Policies](./hydration-policies.md) dokumentiert ab `ER-WP-20`, wie `visible`, `idle` und `lazy` Hydration ueber Fabric und RMT Schedule Delegation geplant werden.
-
-[A11y Keyboard Smokes](./a11y-keyboard-smokes.md) dokumentiert ab `ER-WP-24`, wie Routing, Overlay, Form/Input und Tabs browsernah fuer Fokus, `Tab`, `Enter`, `Space`, `Escape` und Pfeiltasten geprueft werden.
-
-[Screenreader Signals](./screenreader-signals.md) dokumentiert ab `ER-WP-25` den Contract `xtend.a11y.screenreader-signals.v1` fuer `aria-live`, Statusregionen, Errorregionen, Announcements und Fabric-Lane `a11y`.
-
-[Motion und Contrast](./motion-contrast.md) dokumentiert ab `ER-WP-26` den Contract `xtend.a11y.motion-contrast-policy.v1` fuer `prefers-reduced-motion`, `forced-colors`, Fokus, Theme Tokens und Nicht-Farbstatus.
-
-[Manifest Import Policy](./manifest-import-policy.md) dokumentiert ab `ER-WP-28`, wie `data-manifest`, Manifest Records und dynamische Modul-Imports gegen lokale URL-Policy, Allowlist und Security Refusals geprueft werden.
-
-[Trusted DOM und Sanitizing](./trusted-dom-sanitizing.md) dokumentiert ab `ER-WP-29`, wie RMT `html_fragment`, Parsedown HTML, strukturierte Templates und DOM-Sinks klassifiziert werden. `innerHTML`, `insertAdjacentHTML` und `template.innerHTML` bleiben eingeschraenkte Trusted-DOM-Sinks; `dom_descriptor` und Node-basierte Renderer sind bevorzugt.
-
-[Trusted DOM Boundary Browser Proof](./trusted-dom-boundary-browser-proof.md) dokumentiert ab `WP-E13-11` den Contract `xtend.epic13.trusted-dom-boundary.v1`, die Fixture `tests/browser/fixtures/epic13-trusted-dom-boundary-smoke.html`, den Sanitizer `xtend.security.trusted-dom-sanitizer.v1` und den Gate `node scripts/run_xtend_tests.js epic13-trusted-dom-boundary --json`.
-
-[RC1 Migration Notes](./rc1-migration-notes.md) dokumentiert ab `WP-E13-12` den Contract `xtend.epic13.rc1-migration-notes-semver.v1`, die vorgeschlagene Version `0.1.0-rc.1`, Migration Sections fuer Loader, RMT, Docs, Trusted DOM, Fabric, Typing, Visual Owner Artifacts und Supply Chain sowie den Gate `node scripts/run_xtend_tests.js epic13-rc1-migration-notes --json`.
-
-[RC1 Gate Matrix und CI-Handoff](./rc1-gate-matrix-ci-handoff.md) dokumentiert ab `WP-E13-13` den Contract `xtend.epic13.rc1-gate-matrix-ci-handoff.v1`, Source Gates, CI Lanes, Report-Artefakte, Referenzpfade und den Gate `node scripts/run_xtend_tests.js epic13-rc1-gate-matrix-ci-handoff --json`.
-
-[Release Report und Pack Dry Run Evidence](./release-report-pack-dry-run-evidence.md) dokumentiert ab `DPF-WP-02` den Contract `xtend.epic13.release-report-pack-dry-run-evidence.v1`, `npm run release:report`, `npm run pack:dry-run`, reproduzierbare Owner-Artefakte und den Gate `node scripts/run_xtend_tests.js epic13-release-report-pack-dry-run-evidence --json`.
-
-[Supply-Chain Gates](./supply-chain-gates.md) dokumentiert ab `ER-WP-30`, wie Dependency Inventory, License Policy, Vulnerability Policy, SBOM-/Audit-Stufen, Provenance und private Publish Boundary vorbereitet sind. Der lokale Gate bleibt offline; Registry-Audits gehoeren in CI-/Release-Stufen.
-
-[Component Catalog Coverage](./component-catalog-coverage.md) dokumentiert ab `ER-WP-31`, wie Manifest-Komponenten nach Source, Docs, Component-Suite, Fixture, Types, A11y und Performance bewertet werden. `ER-WP-32`, `ER-WP-33`, `ER-WP-34` und `ER-WP-35` sind abgeschlossen; die Matrix ist nun der Handoff fuer CI und Release Readiness.
-
-[Public Component Types](./public-component-types.md) dokumentiert ab `ER-WP-34` die lokalen `.d.ts` Artefakte, Public Event Contracts, Detail-Payloads und typed `addEventListener` Overloads. Nach `WP-E10-11` sind 27 priorisierte Komponenten typisiert; `x-select`, `x-checkbox`, `x-radio`, `x-textarea`, `x-status`, `x-progress`, `x-tooltip`, `x-popover` und `x-drawer` bilden die erste `enterprise-ready` Referenzlinie.
-
-[Design Tokens](./design-tokens.md) dokumentiert ab `WP-E12-12` den Contract `xtend.design-tokens.product-contract.v1`, Theme Packs, Density Packs, High-Contrast/Forced-Colors Tokens, CSS Custom Properties, CSS Parts und den lokalen Gate `node scripts/run_xtend_tests.js design-tokens --json`.
-
-[Drittanbieter Design Authoring](./third-party-design-authoring.md) dokumentiert ab `ECH-WP-11` den Contract `xtend.enterprise.third-party-authoring-guide.v1` fuer Corporate Themes, XTend.css Override Patterns, XTheme Token Bridge, CSS Parts, Icon Pack Registrierung, Layout Modes, A11y-Dos and Donts, P0 Token-/Part-Referenzen und Legacy-Token-Migration. Der lokale Gate `node scripts/run_xtend_tests.js enterprise-third-party-authoring-guide --json` prueft die Guide-Linie.
-
-[Enterprise Component Flex Release Handoff](./enterprise-component-flex-release-handoff.md) dokumentiert ab `ECH-WP-12` den Contract `xtend.enterprise.component-flex-release-handoff.v1` fuer SemVer-Bewertung, Deprecated Aliases, Migration Notes, Release Checklist, Adoption Risiken und den Publish Boundary `private-until-release-owner-acceptance`. Der lokale Gate `node scripts/run_xtend_tests.js enterprise-component-flex-release-handoff --json` prueft den finalen Handoff der Enterprise Component Flexibilitaetswelle.
 
-[RMT DSL Authoring Polish](./rmt-dsl-authoring-polish.md) dokumentiert ab `WP-E12-13` den Contract `xtend.rmt.dsl-authoring-polish.v1` fuer Component-, Shell-, Slot-, Style-, Token-, A11y-, Event-, Command-, Hydration-, Lane-, Route-, Link- und Outlet-Aliase. Der lokale Gate `node scripts/run_xtend_tests.js rmt-dsl-authoring-polish --json` prueft, dass XTendRMT upstream freundlicher authoren kann, ohne XTend-Typen in den RMT Kernel zu importieren.
+Die RMT-vNext-Referenzdemo liegt in `xtendrmt/rmt-vnext-reference-demo.rmt`;
+der stabile Compiler-Output liegt in
+`xtendrmt/rmt-vnext-reference-demo.core.json`.
 
-[RC0 Gate Matrix](./rc0-gate-matrix.md) dokumentiert ab `WP-E12-14` den Contract `xtend.epic12.rc0-gate-matrix.v1` fuer PR Fast, Full Release, Snapshot, RMT Authoring, Conditional Network Gates, Package Dry Run und Known Residual Policy. Der lokale Gate `node scripts/run_xtend_tests.js rc0-gate-matrix --json` prueft die Matrix, waehrend `private-until-release-owner-approval` aktiv bleibt.
+## Tooling und Editor-DX
 
-[RC0 Adoption Guide](./rc0-adoption-guide.md) dokumentiert ab `WP-E12-15` den Contract `xtend.epic12.docs-adoption.v1` fuer Long-Tail Runtime Closure, DOM-first Visual Snapshots, Design Token Productization, RMT DSL Authoring Polish, RC0 Readiness, Known Residual Policy und Migration Notes. Der lokale Gate `node scripts/run_xtend_tests.js epic12-docs-adoption --json` prueft Docs-App-Menue, Enterprise Adoption Guide, Package, Scaffold, Backlog, RC-Modell und Referenzpfade.
+Der RMT Language Server ist die Source of Truth fuer Diagnostics, Completion,
+Hover, Document Symbols, Definition und Code Actions. VS Code, JetBrains,
+Neovim und Helix koennen den Server ueber stdio anbinden.
 
-[Epic 12 RC0 Handoff](./epic12-rc0-handoff.md) dokumentiert ab `WP-E12-16` den Contract `xtend.epic12.rc0-handoff.v1` fuer KPI-Abnahme, Long-Tail-Status, Snapshot-Status, RC0 Gate Matrix, Owner Review Inputs, Known Residual Policy und Publish Boundary. Der lokale Gate `node scripts/run_xtend_tests.js epic12-rc0-handoff --json` prueft den finalen Epic-12-Abschluss.
-
-[RC1 Readiness](./rc1-readiness.md) dokumentiert ab `WP-E13-01` den Contract `xtend.epic13.rc1-production-readiness.v1` fuer den RC0-zu-RC1-Transfer, Release Owner Acceptance, Conditional Network Evidence, Package Dry Run Export Lock, Known Residuals, PROD-nahe Browser-/CSP-Smokes, RMT Production Readiness und Feature-Drift-Grenzen. Der lokale Gate `node scripts/run_xtend_tests.js epic13-rc1-readiness --json` prueft den Startschnitt fuer Epic 13.
-
-[Release Owner Acceptance](./release-owner-acceptance.md) dokumentiert ab `WP-E13-02` den Contract `xtend.epic13.release-owner-acceptance.v1` fuer Owner Inputs, `accepted`/`deferred`/`blocked` Entscheidungen, `automatic-publish-approval` als blockierte Entscheidung und den weiterhin geschlossenen Publish Boundary. Der lokale Gate `node scripts/run_xtend_tests.js epic13-release-owner-acceptance --json` prueft den Owner-Acceptance-Schnitt.
-
-[Conditional Network Evidence](./conditional-network-evidence.md) dokumentiert ab `WP-E13-03` den Contract `xtend.epic13.conditional-network-evidence.v1` fuer `npm audit --audit-level=moderate`, `npm sbom --sbom-format=cyclonedx --json`, `.xtend-test-results/` Evidence-Artefakte und strukturierte Offline-/Sandbox-Deferrals. Der lokale Gate `node scripts/run_xtend_tests.js epic13-conditional-network-evidence --json` bleibt netzwerkfrei.
-
-[Conditional Network Evidence CI](./conditional-network-evidence-ci.md) dokumentiert ab `DPF-WP-03` den Contract `xtend.epic13.conditional-network-evidence-ci.v1`, `npm run conditional-network:evidence`, den GitHub-Actions-Job `conditional-network-evidence` und den Gate `node scripts/run_xtend_tests.js epic13-conditional-network-evidence-ci --json`.
-
-[Package Export Lock](./package-export-lock.md) dokumentiert ab `WP-E13-04` den Contract `xtend.epic13.package-export-lock.v1` fuer `npm pack --dry-run --json`, `.xtend-test-results/xtend-pack-dry-run.json`, `.xtend-test-results/xtend-package-export-surface-lock.json`, Loader, Components, Fabric, XTendRMT, Builder, Docs und den lokalen Gate `node scripts/run_xtend_tests.js epic13-package-export-lock --json`.
-
-[TypeExports](./type-exports.md) dokumentiert ab `WP-TypeExports-09` den Contract `xtend.type-exports.plan.v1`, den Drift-Report `xtend.type-exports.drift-report.v1`, die Public Package Export Matrix, Package `types`-Conditions, `types-not-required` Boundaries, den lokalen Gate `node scripts/run_xtend_tests.js type-exports --json` und den Release-Handoff `npm run test:type-exports:release`.
-
-[XTend Loader Types](./xtend-loader-types.md) dokumentiert ab `WP-TypeExports-02` den Contract `xtend.type-exports.loader-declarations.v1` fuer `window.XTendLoader`, `window.XTendStyleRegistry`, `window.XTendSkeletonLoader`, Loader Events, Boot-Promise und den lokalen Drift-Gate `node scripts/run_xtend_tests.js type-exports-loader --json`.
-
-[XTend API Types](./xtend-api-types.md) dokumentiert ab `WP-TypeExports-03` den Contract `xtend.type-exports.api-declarations.v1` fuer `initXTendAPI`, `window.XTend.*`, globale Legacy-Aliase, `xtend-api-ready` und den lokalen Drift-Gate `node scripts/run_xtend_tests.js type-exports-api --json`.
-
-[XTend RMT Types](./xtend-rmt-types.md) dokumentiert ab `WP-TypeExports-04` den Contract `xtend.type-exports.rmt-declarations.v1` fuer `./rmt`, `./rmt/browser`, RMT-Language Tooling, LSP, Linter, Editor-Facades und den lokalen Drift-Gate `node scripts/run_xtend_tests.js type-exports-rmt --json`.
-
-[XTend Policy Types](./xtend-policy-types.md) dokumentiert ab `WP-TypeExports-05` den Contract `xtend.type-exports.policy-declarations.v1` fuer Fabric-, A11y- und Security-Policy-APIs, gemeinsame Diagnostic-/Report-Typen und den lokalen Drift-Gate `node scripts/run_xtend_tests.js type-exports-policy --json`.
-
-[XTend Builder Types](./xtend-builder-types.md) dokumentiert ab `WP-TypeExports-06` den Contract `xtend.type-exports.builder-declarations.v1` fuer Builder-, Scaffold-, Component-Lab-, Blueprint-, Preview-, Workflow- und Typing-Contract APIs sowie den lokalen Drift-Gate `node scripts/run_xtend_tests.js type-exports-builder --json`.
-
-[XTend Catalog Types](./xtend-catalog-types.md) dokumentiert ab `WP-TypeExports-07` den Contract `xtend.type-exports.catalog-declarations.v1` fuer Catalog-Plan-/Report-Facades, SurfaceManager-/Epic-/Release-Catalog-Klassifizierung und den lokalen Drift-Gate `node scripts/run_xtend_tests.js type-exports-catalog --json`.
-
-[XTend Vendor and Utility Types](./xtend-vendor-types.md) dokumentiert ab `WP-TypeExports-08` den Contract `xtend.type-exports.vendor-facades.v1` fuer Prism-, Turndown- und Design-Token-Facades sowie den lokalen Drift-Gate `node scripts/run_xtend_tests.js type-exports-vendor --json`.
-
-[RMT-first XTend Apps](./rmt-first-xtend-apps.md) dokumentiert ab `WP-E10-16`, wie vollstaendige XTend Apps ueber `xtend.rmt.first-class-app-authoring.v1` mit `xtend.component`, `xtend.xrouter`, `dom_descriptor` Templates, Schedules, Fabric-Lanes und Diagnostics beschrieben werden.
-
-[RMT Lifecycle Demo](./rmt-lifecycle-demo.md) zeigt den vollstaendigen lokalen Buildpfad: `xtendrmt/rmt-lifecycle-demo.rmt` wird als RMT vNext Template authored, der Scaffold-Befehl `node xtend-builder/scaffold.js rmt-lifecycle-demo --write --json` erzeugt Core JSON, XTend Custom Element, App-Modul, Host und Browser-Smoke, und `node scripts/run_xtend_tests.js rmt-lifecycle-demo --json` prueft die Artefakte gegen den Build.
-
-[SurfaceManager RMT Authoring](./surface-manager-rmt-authoring.md) dokumentiert ab `WP-SM-01` den Contract `xtend.rmt.surface-authoring.v1` fuer `x-surface-manager`, `x-surface-window`, `x-side-panel`, `metadata.surfaceManager`, `metadata.surface`, Surface-Schedules und die reservierte spaetere `xtend.surface` Adaptergrenze. Der lokale Gate `node scripts/run_xtend_tests.js rmt-surface-authoring --json` prueft Contract, Fixture, Package, Scaffold und RMT-Core-Normalisierung.
-
-[SurfaceManager Controller](./surface-manager-controller.md) dokumentiert ab `WP-SM-02` den Contract `xtend.surface.controller.v1`, die Runtime `components/xsurfacemanager-controller.js`, TypeScript Sources unter `src/components/x-surface-manager/`, xstate Mirror Keys, Fabric Diagnostics und den lokalen Gate `node scripts/run_xtend_tests.js surface-controller --json`.
-
-[SurfaceManager Window Runtime](./surface-manager-window-runtime.md) dokumentiert ab `WP-SM-03` den Contract `xtend.surface.window-runtime.v1`, `x-surface-manager`, `x-surface-window`, den Command-Bridge `surface-window-command`, Snapshot-Spiegelung und den lokalen Gate `node scripts/run_xtend_tests.js surface-manager --json`.
-
-[SurfaceManager SidePanel Runtime](./surface-manager-side-panel-runtime.md) dokumentiert ab `WP-SM-04` den Contract `xtend.surface.side-panel-runtime.v1`, `x-side-panel`, `surface-panel-command`, Docked/Pinned/Overlay/Collapsed Modes, responsive Fullscreen-Verhalten und den lokalen Gate `node scripts/run_xtend_tests.js surface-side-panel --json`.
-
-[SurfaceManager Workbench Fixture](./surface-manager-workbench-fixture.md) dokumentiert ab `WP-SM-05` den Contract `xtend.surface.workbench-fixture.v1`, `xtendrmt/surface-workbench.rmt`, den Host `xtendrmt-surface-workbench.html`, zwei Windows, ein SidePanel, route-bound Content, shared Surface Snapshot und den lokalen Gate `node scripts/run_xtend_tests.js surface-workbench-fixture --json`.
-
-[SurfaceManager Overlay Bridge](./surface-manager-overlay-bridge.md) dokumentiert ab `WP-SM-06` den Contract `xtend.surface.overlay-stack-bridge.v1`, `components/xsurfaceoverlay-bridge.js`, `surface-overlay-command`, die optionale Stack-Anbindung fuer `x-modal`, `x-dialog` und `x-drawer` sowie den lokalen Gate `node scripts/run_xtend_tests.js surface-overlay-bridge --json`.
-
-[SurfaceManager Quality Gates](./surface-manager-quality-gates.md) dokumentiert ab `WP-SM-07` den Contract `xtend.surface.quality-gates.v1`, das Browser-Fixture `tests/browser/fixtures/surface-manager-quality-smoke.html`, die Visual-Baseline `tests/browser/visual-baselines/surface-manager-quality.dom-baseline.json`, A11y-/Performance-/Visual-Domaenen und den lokalen Gate `node scripts/run_xtend_tests.js surface-manager-quality --json`.
-
-[SurfaceManager Native RMT Surfaces](./surface-manager-native-rmt-surfaces.md) dokumentiert ab `WP-SM-08` den Contract `xtend.rmt.surfaces-domain.v1`, den Adapter-Handoff `xtend.surface.adapter.v1`, die Fixture `tests/fixtures/rmt-surface-native-domain.rmt`, Schema-/Typ-/Normalizer-/LSP-Tooling und den lokalen Gate `node scripts/run_xtend_tests.js surface-native-rmt --json`.
-
-[SurfaceManager Authoring Guide](./surface-manager-authoring-guide.md), [SurfaceManager Component Lab](./surface-manager-component-lab.md), [SurfaceManager Migration Guide](./surface-manager-migration-guide.md) und [SurfaceManager Release Handoff](./surface-manager-release-handoff.md) schliessen ab `WP-SM-09` die erste SurfaceManager-Linie. Der lokale Gate `node scripts/run_xtend_tests.js surface-release-handoff --json` prueft Authoring-Modi, Component-Lab-Fixture, Migration von `components[*].metadata.surface` zu `surfaces[*]`, Package-/Scaffold-Metadaten und Referenzpfade.
-
-[SurfaceManager Lazy Hydration](./surface-manager-lazy-hydration.md) dokumentiert ab `WP-SM-13` den Contract `xtend.surface.loading-policy.v1`, die Policies `eager`, `visible`, `open`, `idle` und `route`, SkeletonLoader-basierte Content-Hydration fuer Surface-Scopes, Parsedown-Container und remote-faehige Slots. Der lokale Gate `node scripts/run_xtend_tests.js surface-lazy-hydration --json` prueft den shell-first Pfad ohne Doku-App-Monkeypatch.
-
-[SurfaceManager Route Lifecycle](./surface-manager-route-lifecycle.md) dokumentiert ab `WP-SM-14` den Contract `xtend.surface.route-lifecycle.v1`, route-aware Manager, XRouter-gebundene Surface-Policies, globale Surfaces und die Boundary, dass XRouter Route-State liefert, waehrend SurfaceManager Surface-Lifecycles steuert. Der lokale Gate `node scripts/run_xtend_tests.js surface-route-lifecycle --json` prueft den Pfad ohne konkurrierende Lifecycle-Quellen.
-
-[SurfaceManager Stack Policy](./surface-manager-stack-policy.md) dokumentiert ab `WP-SM-15` den Contract `xtend.surface.stack-policy.v1`, Manager-owned `modal-policy`, Focus Trap/Restore ueber Surface-Grenzen, Inert/`aria-hidden`, Escape-Prioritaet, Scroll Lock und Layer Tokens fuer gemischte Window-/Panel-/Overlay-Stacks. Der lokale Gate `node scripts/run_xtend_tests.js surface-stack-policy --json` prueft den Pfad ohne zweite Registry.
-
-[SurfaceManager Layout Engines](./surface-manager-layout-engines.md) dokumentiert ab `WP-SM-16` den Contract `xtend.surface.layout-engine.v1`, die Engines `freeform`, `docked`, `split`, `tile` und `stacked`, snapshot-kompatible Bounds, sichtbares Docking, `undockSurface`, Viewport-Constraints, Snap-Regeln und responsive Fallbacks. Der lokale Gate `node scripts/run_xtend_tests.js surface-layout-engines --json` prueft den Pfad ohne zweite Registry.
-
-[SurfaceManager Remote Policy Bridge](./surface-manager-remote-policy.md) dokumentiert ab `WP-SM-17` den Contract `xtend.surface.remote-policy-bridge.v1`, E16 Remote-Surface-Records, Owner-/Version-/Origin-/Integrity-/Capability-Pruefung, Enterprise Registry Lookup, Degradation/Fallback, Event-Governance und die Boundary `kein Remote Runtime Loading im RMT Kernel`. Der lokale Gate `node scripts/run_xtend_tests.js surface-remote-policy --json` prueft den Pfad ohne zweite Registry.
-
-[SurfaceManager Browser Lab](./surface-manager-browser-lab.md) dokumentiert ab `WP-SM-18` den Contract `xtend.surface.browser-lab.v1`, Browser-Lab-Fixture, DOM/Pseudo-Pixel-Baselines fuer Kaltstart, Skeleton, Hydration, Route-Change und Modal-Stack sowie Performance-/CLS-/Pop-In-Budgets. Der lokale Gate `node scripts/run_xtend_tests.js surface-browser-lab --json` prueft Docs-App- und Workbench-Proben ohne Doku-App-Monkeypatch.
-
-[SurfaceManager Runtime Release Handoff](./surface-manager-runtime-release-handoff.md) dokumentiert ab `WP-SM-19` den Contract `xtend.surface.runtime-release-handoff.v1`, den produktiven Runtime-Claim fuer native `surfaces[*]`, die finale Release-Gate-Matrix, Migration Notes, Compatibility Notes, SemVer-Hinweise und offene Scopes. Der lokale Gate `node scripts/run_xtend_tests.js surface-runtime-release-handoff --json` prueft, dass die Surface Runtime releasefaehig bleibt, ohne Fabric, RMT-Kernel oder die SurfaceController-Registry zu ersetzen.
-
-[Component UX Authoring](./component-ux-authoring.md), [Component UX App Authoring](./component-ux-app-authoring.md) und [Component UX Gates](./component-ux-gates.md) dokumentieren ab `WP-E11-16`, wie Komponentenautorinnen und App-Autoren Shell, Styling, A11y, Performance, Component Network, RMT Shell Authoring, Browser-Smokes und Component Shell Theme Matrix als zusammenhaengende UX-Reife nutzen. Der Gate `node scripts/run_xtend_tests.js component-ux-authoring-docs --json` prueft diese Doku-Linie.
-
-[Component Long-Tail Migration](./component-long-tail-migration.md) dokumentiert ab `WP-E11-17`, wie die verbleibenden Long-Tail-Komponenten ohne Big-Bang-Refactor in Migrationswellen gehaertet werden. Nach `WP-E12-09` sind `x-tabs`, `x-theme`, `x-button` und `x-menu` geschlossen; seit `WP-E13-05` sind auch `xstate` als Runtime-Boundary und `x-utils` als Utility-Boundary geschlossen. Der Gate `node scripts/run_xtend_tests.js component-long-tail-migration --json` prueft Plan, Package, Scaffold, Referenzen und Handoff.
-
-[Epic 11 Enterprise UX Handoff](./epic11-enterprise-ux-handoff.md) dokumentiert ab `WP-E11-18` den Abschluss `xtend.epic11.enterprise-ux-handoff.v1`, den Modus `completed-with-accepted-long-tail-handoff`, die KPI-Abnahme, historische Accepted Residuals fuer `xstate` und `x-utils`, Release Boundary und Next-Wave Handoff. Der aktuelle RC1-Stand ist in [Known Residual Triage](./known-residual-triage.md) geschlossen.
-
-[Component Lab](./component-lab.md) dokumentiert ab `WP-E10-12` den lokalen Shell-first RMT-Pilot fuer Component Preview, RMT Inspector, Telemetry, A11y-, Performance- und Source-Link-Panels. Der Gate `node scripts/run_xtend_tests.js component-lab-rmt-inspector --json` prueft Plan, RMT-Fixture und Referenzpfade.
-
-[RMT-first Demo-App](./rmt-first-demo-app.md) dokumentiert ab `WP-E10-13`, wie `xtendrmt-rmt-first-demo.html` nur noch einen generischen RMT Root bereitstellt und `xtendrmt/rmt-first-demo-app.rmt` die App Shell, Routen, Templates, Schedules und XTend-Komponentenzuordnung besitzt. Der Gate `node scripts/run_xtend_tests.js rmt-first-demo-app --json` prueft den No-Manual-Shell-Pfad.
-
-[Existing Component Metadata](./existing-component-metadata.md) dokumentiert ab `WP-E10-14`, wie `x-router`, `x-link`, `x-input`, `x-form`, `x-modal`, `x-dialog`, `x-tabs`, `x-toast` und `x-alert` ueber `catalog/epic10-existing-component-metadata.js` als `js-legacy` Contract Overlay RMT/Fabric-kompatibel werden. Der Gate `node scripts/run_xtend_tests.js existing-component-metadata --json` prueft die Metadata-Linie.
-
-[Epic 10 Platform Gates](./epic10-platform-gates.md) dokumentiert ab `WP-E10-15`, wie Browser-Smokes, A11y, Performance, Visual Regression, Existing Component Metadata und RMT-first Demo-App als `xtend.epic10.platform-gates.v1` zusammenhaengen. Der Gate `node scripts/run_xtend_tests.js epic10-platform-gates --json` prueft die Fast-PR- und Release-Handoff-Linie.
-
-[Epic 10 Release Handoff](./epic10-release-handoff.md) dokumentiert ab `WP-E10-16` den Abschluss `xtend.epic10.release-handoff.v1`, die kanonische Guide-Struktur, Migration Notes, Release Candidate Gates, die Fabric Boundary Entscheidung `adapter-injection-via-xtend-component-resolveFabricContext` und den Next-Wave Handoff.
-
-[Visual Browser Regression](./visual-browser-regression.md) dokumentiert ab `ER-WP-35`, wie XTend sichtbare Regression, Browser-Smokes, mobile Viewports, Theme-Varianten, Performance-Profile, A11y-Remediation und Long-Tail-Haertung pro Manifest-Komponente priorisiert.
-
-[Visual Snapshot Automation](./visual-snapshot-automation.md) dokumentiert ab `WP-E12-10` den Contract `xtend.epic12.visual-snapshot-automation-contract.v1` und ab `WP-E12-11` den Runner `xtend.epic12.visual-snapshot-runner.v1`, der Component Shell Theme Matrix, lokale Fixture, JSON DOM-Baseline und DOM-first-Diff zusammenfuehrt.
-
-[Visual Owner Artifacts](./visual-owner-artifacts.md) dokumentiert ab `WP-E13-08` den Contract `xtend.epic13.visual-owner-artifact.v1`, das Manifest `tests/browser/visual-baselines/rc1-visual-owner-artifact.manifest.json` und den lokalen Gate `node scripts/run_xtend_tests.js epic13-visual-owner-artifact --json`. Screenshots und Pixel-Diff bleiben `optional-browser-driver-or-ci-artifact`, waehrend der lokale Gate DOM-first und netzwerkfrei bleibt.
-
-[RMT Production Readiness](./rmt-production-readiness.md) dokumentiert ab `WP-E13-09` den Contract `xtend.epic13.rmt-production-readiness.v1`, der RMT-first App Shell, Routing, Components, Fabric/Lanes, Lifecycle Telemetry, Diagnostics und Artifact Parity als RC1-Buendel zusammenfuehrt. Der lokale Gate `node scripts/run_xtend_tests.js epic13-rmt-production-readiness --json` bleibt statisch, offline und framework-agnostisch.
-
-[Docs RMT Production Hardening](./docs-rmt-production-hardening.md) dokumentiert ab `WP-E13-10` den Contract `xtend.epic13.docs-rmt-production-hardening.v1`. Die Docs-App bleibt Parsedown-basiert, stellt aber stabile RMT Extension-Slots fuer `parsedownHtml`, `richHtml`, `xplayerTutorial` und Diagnostics bereit. Der lokale Gate ist `node scripts/run_xtend_tests.js epic13-docs-rmt-production-hardening --json`.
+- [RMT Linter und AI-Agent Repair Report](./rmt-linter.md)
+- [RMT Language Server und Editor Setup](./rmt-language-server.md)
+- [RMT DSL Authoring Polish](./rmt-dsl-authoring-polish.md)
+- [RMT Tooling Release Gates](./rmt-tooling-release-gates.md)
 
-[Enterprise Adoption Guide](./enterprise-adoption.md) dokumentiert ab `ER-WP-39`, wie Teams Loader, lokalen Dev Server, XTend UI, XTend-Fabric, XTendRMT, Security, A11y, Performance, CI Gates und Release Readiness als zusammenhaengenden Einfuehrungspfad nutzen.
+Wichtige lokale Befehle:
 
-[Known Residual Triage](./known-residual-triage.md) dokumentiert ab `WP-E13-05`, wie `xstate` und `x-utils` fuer RC1 als Boundary-Contracts geschlossen werden und `xtend.component.hydrate` als einziger Watchpoint nach `WP-E13-06` ging.
+```bash
+xt rmt lint app.rmt
+xt rmt lint app.rmt --json
+xt rmt lint app.rmt --agent
+node tools/rmt-language-server/server.js
+```
 
-[Hydration Performance Closure](./hydration-performance-closure.md) dokumentiert ab `WP-E13-06`, wie `xtend.component.hydrate` mit `31ms / 32ms` owner-frei geschlossen wurde. Der Gate `node scripts/run_xtend_tests.js epic13-hydration-performance-closure --json` prueft Contract, Baseline, Package, Scaffold, Registry und Handoff nach `WP-E13-08`.
+Der Tooling-Dokumentationscontract bleibt `xtend.rmt.tooling-docs.v1`; der
+zugehoerige lokale Check ist
+`node scripts/run_xtend_tests.js rmt-tooling-docs --json`.
 
-[PROD Browser CSP Smokes](./prod-browser-csp-smokes.md) dokumentiert ab `WP-E13-07` den Contract `xtend.epic13.prod-browser-csp-smoke.v1`, die Fixture `tests/browser/fixtures/epic13-prod-csp-smoke.html`, Nonce, same-origin Manifest, lokalen CSP Header und `npm run dev:local:csp`.
+## XTend Components nutzen
 
----
+XTend Components sind Web Components, die von RMT-Surfaces gemountet,
+hydriert und mit Events verbunden werden koennen. Nutze sie als UI-Bausteine,
+waehrend RMT die App-Struktur und den Lifecycle beschreibt.
 
-## Komponentenübersicht
+Die RMT vNext Component Capability Registry macht diese Grenze generisch: alle
+44 public Manifest-Eintraege werden als Matrix erfasst, 40 renderbare UI-
+Komponenten bekommen Component Contracts, RMT-Metadaten, Slots, Parts,
+Attribute, Events und State-Bridges als gemeinsame Runtime-Faehigkeiten. Damit
+werden RMT-Primitives stack-ergaenzend statt als zweite UI-Schicht umgesetzt.
 
-> **Tipp:** Jede Komponente ist einzeln dokumentiert und enthält Querverweise zu verwandten Modulen.
+- [RMT vNext Component Primitives und XTend UI](./rmt-vnext-component-primitives.md)
+- [Komponenten-Entwicklung](./components.md)
+- [Component Platform](./component-platform.md)
+- [TypeScript Components](./typescript-components.md)
+- [Component UX Authoring](./component-ux-authoring.md)
+- [Component UX App Authoring](./component-ux-app-authoring.md)
+- [Component UX Gates](./component-ux-gates.md)
+- [Component Lab](./component-lab.md)
+- [Component Long-Tail Migration](./component-long-tail-migration.md)
+- [Existing Component Metadata](./existing-component-metadata.md)
+- [Public Component Types](./public-component-types.md)
+- [Component Catalog Coverage](./component-catalog-coverage.md)
 
-| Komponente      | Beschreibung                        |
-|-----------------|-------------------------------------|
-| [xalert](./components/xalert.md)         | Hinweise, Warnungen, Fehleranzeigen      |
-| [xbutton](./components/xbutton.md)       | Flexibler Button                        |
-| [xcalendar](./components/xcalendar.md)   | Kalender & Datumsauswahl                |
-| [xcards](./components/xcards.md)         | Grid-Layout für Cards                    |
-| [xcode](./components/xcode.md)           | Code-Ansicht & Highlighting             |
-| [xdialog](./components/xdialog.md)       | Modale Dialoge & Overlays               |
-| [xmodal](./components/xmodal.md)         | State-getriebene Modals                 |
-| [xfooter](./components/xfooter.md)       | Footer mit Branding                     |
-| [xform](./components/xform.md)           | Flexibles Formular                      |
-| [xheader](./components/xheader.md)       | Header mit Logo & Navigation            |
-| [xhero](./components/xhero.md)           | Hero-Bereich für Landingpages           |
-| [xinput](./components/xinput.md)         | Eingabefeld                             |
-| [xlightbox](./components/xlightbox.md)   | Overlay für Bilder & Medien             |
-| [xmasonry](./components/xmasonry.md)     | Masonry-Grid-Layout                     |
-| [xmenu](./components/xmenu.md)           | Navigation & Menüs                      |
-| [xplayer](./components/xplayer.md)       | Audio/Video-Player                      |
-| [xsection](./components/xsection.md)     | Layout-Abschnitt                        |
-| [xspinner](./components/xspinner.md)     | Ladeanzeige/Spinner                     |
-| [xstate](./components/xstate.md)         | State-Management                        |
-| [xsummary](./components/xsummary.md)     | Ausklappbare Disclosure-Zusammenfassung |
-| [xtabs](./components/xtabs.md)           | Tab-Navigation                          |
-| [xtheme](./components/xtheme.md)         | Theme-Management                        |
-| [xtoast](./components/xtoast.md)         | Toast-Benachrichtigungen                |
-| [xtype](./components/xtype.md)           | Typing-Animation                        |
-| [xutils](./components/xutils.md)         | Utility-Modul fuer DOM, Events und Formate |
-| [xwriter](./components/xwriter.md)       | Rich-Text-Editor                        |
-| [xrouter](./components/xrouter.md)       | SPA-Routing-Komponente                   |
-| [xlink](./components/xlink.md)           | Deklarativer Link für Routing            |
+Ausgewaehlte Komponenten:
 
----
+- [x-router](./components/xrouter.md)
+- [x-link](./components/xlink.md)
+- [x-modal](./components/xmodal.md)
+- [x-summary](./components/xsummary.md)
+- [x-utils](./components/xutils.md)
+- [x-button](./components/xbutton.md)
+- [x-input](./components/xinput.md)
+- [x-menu](./components/xmenu.md)
 
-## Weitere Ressourcen
-- [XTend-ADR](./XTend-ADR.md)
-- [Core Migration Guide](./core-migration-guide.md)
-- [parsedown.php (Markdown zu HTML)](./utils/parsedown.php)
+## Runtime, Fabric und Surfaces
 
----
+Fabric fuehrt Runtime-Arbeit in Lanes und Fibers aus. RMT beschreibt die
+Schedule- und Lifecycle-Absicht, der Host-Adapter verbindet diese Records mit
+XTend Components, XRouter und Browser-DOM.
 
-## Testbindung
+- [XTend-Fabric Runtime](./xtend-fabric.md)
+- [XTend-Fabric RMT Lane Mapping](./xtend-fabric-rmt-lane-mapping.md)
+- [RMT Node SSR Adapter](./rmt-node-ssr-adapter.md)
+- [RMT PHP/Laravel SSR Adapter](./rmt-php-ssr-adapter.md)
+- [SurfaceManager RMT Authoring](./surface-manager-rmt-authoring.md)
+- [SurfaceManager Controller](./surface-manager-controller.md)
+- [SurfaceManager Window Runtime](./surface-manager-window-runtime.md)
+- [SurfaceManager SidePanel Runtime](./surface-manager-side-panel-runtime.md)
+- [SurfaceManager Workbench Fixture](./surface-manager-workbench-fixture.md)
+- [SurfaceManager Native RMT Surfaces](./surface-manager-native-rmt-surfaces.md)
+- [SurfaceManager Authoring Guide](./surface-manager-authoring-guide.md)
+- [SurfaceManager Migration Guide](./surface-manager-migration-guide.md)
+- [SurfaceManager Component Lab](./surface-manager-component-lab.md)
+- [SurfaceManager Release Handoff](./surface-manager-release-handoff.md)
+- [SurfaceManager Overlay Bridge](./surface-manager-overlay-bridge.md)
+- [SurfaceManager Quality Gates](./surface-manager-quality-gates.md)
+- [SurfaceManager Runtime Release Handoff](./surface-manager-runtime-release-handoff.md)
 
-Priorisierte Dokumentations- und Demo-Referenzen werden im Epic-02-Harness geprueft:
+Die Docs-App selbst ist ein Beispiel fuer Shell-first-Denken:
+[XTendRMT Parsedown Scheduling Pilot](./xtendrmt-parsedown-scheduling.md)
+beschreibt, wie `docs/xtendrmt-parsedown-docs.rmt` die sichtbare Docs-Shell
+fuehrt. Der Contract ist `xtend.docs.parsedown-rmt-pilot.v1`, der lokale Check
+ist `npm run test:docs-rmt-pilot`.
 
-```bash
-node scripts/run_xtend_tests.js references
-node scripts/run_xtend_tests.js rmt-compatibility
-```
+## Quality und Security
 
-Die Referenzliste liegt unter `development/XTend-Dokumentations-und-Demo-Referenzpfade.md`.
+Diese Artikel helfen, Apps produktionsnaeher zu bauen, ohne die RMT-Kernel-
+Grenze zu verletzen:
 
-Fuer lokale Ausfuehrung, JSON-Reports und spaetere CI-Anbindung siehe `development/XTend-Test-Reporting-und-CI-Vorbereitung.md`.
+- [Performance fuer Komponentenautoren](./performance.md)
+- [Performance Measurements](./performance-measurements.md)
+- [Performance Regression](./performance-regression.md)
+- [Hydration Performance Closure](./hydration-performance-closure.md)
+- [Hydration Policies](./hydration-policies.md)
+- [A11y Keyboard Smokes](./a11y-keyboard-smokes.md)
+- [Screenreader Signals](./screenreader-signals.md)
+- [Motion und Contrast](./motion-contrast.md)
+- [Manifest Import Policy](./manifest-import-policy.md)
+- [Trusted DOM und Sanitizing](./trusted-dom-sanitizing.md)
+- [Trusted DOM Boundary Browser Proof](./trusted-dom-boundary-browser-proof.md)
+- [Visual Browser Regression](./visual-browser-regression.md)
+- [Visual Snapshot Automation](./visual-snapshot-automation.md)
+- [Design Tokens](./design-tokens.md)
+- [Drittanbieter Design Authoring](./third-party-design-authoring.md)
 
-Neue, modernisierte und ueber `XTend-Scaffold` erzeugte Komponenten muessen ausserdem die Testpflicht aus `development/XTend-Testpflicht-und-Scaffold-Anschluss.md` erfuellen.
+## Release- und Typing-Referenzen
+
+Release- und Gate-Artikel bleiben verfuegbar, stehen aber nicht mehr im
+Vordergrund des Lernpfads. Nutze sie, wenn du Release-Reife, Typing oder
+Owner-Akzeptanz pruefst.
+
+CI- und release-nahe Contract-Anker bleiben hier sichtbar:
+`xtend.epic12.docs-adoption.v1` unter
+[RC0 Adoption Guide](./rc0-adoption-guide.md) mit
+`node scripts/run_xtend_tests.js epic12-docs-adoption --json`,
+`xtend.epic13.rc1-migration-notes-semver.v1` unter
+[RC1 Migration Notes](./rc1-migration-notes.md),
+`xtend.epic13.release-report-pack-dry-run-evidence.v1` unter
+[Release Report und Pack Dry Run Evidence](./release-report-pack-dry-run-evidence.md),
+`xtend.epic13.rc1-gate-matrix-ci-handoff.v1` unter
+[RC1 Gate Matrix und CI](./rc1-gate-matrix-ci-handoff.md) und
+`xtend.epic13.conditional-network-evidence-ci.v1` unter
+[Conditional Network Evidence CI](./conditional-network-evidence-ci.md).
+Der Enterprise-Component-Flex-Handoff
+`xtend.enterprise.component-flex-release-handoff.v1` bleibt unter
+[Enterprise Component Flex Release Notes](./enterprise-component-flex-release-handoff.md)
+referenziert. Die RMT-vNext-Enterprise-Linie markiert
+`rmt-vnext-enterprise-mfe-ready` ueber
+[RMT vNext Remote Surfaces](./rmt-vnext-remote-surfaces.md),
+[RMT vNext Enterprise Surface Registry](./rmt-vnext-surface-registry-enterprise.md),
+[RMT vNext Cross Surface Events](./rmt-vnext-cross-surface-events.md)
+und [RMT vNext Enterprise MFE Handoff](./rmt-vnext-enterprise-mfe-handoff.md).
+Surface-Runtime-Reife bleibt ueber
+[SurfaceManager Overlay Bridge](./surface-manager-overlay-bridge.md),
+[SurfaceManager Quality Gates](./surface-manager-quality-gates.md),
+[SurfaceManager Runtime Release Handoff](./surface-manager-runtime-release-handoff.md)
+und [Hydration Performance Closure](./hydration-performance-closure.md)
+auffindbar.
+Der RMT-Kernel-Handoff `xtend.rmt.kernel-migration-authoring-incident-handoff.v1`
+bleibt ueber
+[RMT Kernel Security Hardening Migration](./rmt-kernel-security-hardening-migration.md),
+[RMT Kernel Trusted Output Authoring](./rmt-kernel-trusted-output-authoring.md)
+und
+[RMT Kernel Panic Recovery Incident Handoff](./rmt-kernel-panic-recovery-incident-handoff.md)
+mit `node scripts/run_xtend_tests.js rmt-kernel-handoff-docs --json`
+auffindbar.
+
+- [XTend Changelog](./changelog.md)
+- [RC0 Gate Matrix](./rc0-gate-matrix.md)
+- [RC0 Adoption Guide](./rc0-adoption-guide.md)
+- [RC0 Abschlussnotizen](./epic12-rc0-handoff.md)
+- [RC1 Readiness](./rc1-readiness.md)
+- [Release Owner Acceptance](./release-owner-acceptance.md)
+- [RC1 Migration Notes](./rc1-migration-notes.md)
+- [RC1 Gate Matrix und CI](./rc1-gate-matrix-ci-handoff.md)
+- [Release Report und Pack Dry Run Evidence](./release-report-pack-dry-run-evidence.md)
+- [Package Export Lock](./package-export-lock.md)
+- [TypeExports](./type-exports.md)
+- [XTend Loader Types](./xtend-loader-types.md)
+- [XTend API Types](./xtend-api-types.md)
+- [XTend RMT Types](./xtend-rmt-types.md)
+- [XTend Policy Types](./xtend-policy-types.md)
+- [XTend Builder Types](./xtend-builder-types.md)
+- [XTend Catalog Types](./xtend-catalog-types.md)
+- [XTend Vendor and Utility Types](./xtend-vendor-types.md)
+- [Known Residual Triage](./known-residual-triage.md)
+- [Conditional Network Evidence](./conditional-network-evidence.md)
+- [Conditional Network Evidence CI](./conditional-network-evidence-ci.md)
+- [PROD Browser CSP Smokes](./prod-browser-csp-smokes.md)
+- [Visual Owner Artifacts](./visual-owner-artifacts.md)
+- [RMT Production Readiness](./rmt-production-readiness.md)
+- [Docs RMT Production Hardening](./docs-rmt-production-hardening.md)
+- [Epic 10 Platform Gates](./epic10-platform-gates.md)
+- [Platform Release Notes](./epic10-release-handoff.md)
+- [Enterprise UX Notes](./epic11-enterprise-ux-handoff.md)
+- [Vendor Bugfixes](./epic18-vendor-bugfixes.md)
+- [RMT App Platform Release Notes](./epic18-rmt-app-platform-release-handoff.md)
+- [Enterprise Component Flex Release Notes](./enterprise-component-flex-release-handoff.md)
+- [RMT vNext Enterprise MFE Handoff](./rmt-vnext-enterprise-mfe-handoff.md)
+- [SurfaceManager Runtime Release Handoff](./surface-manager-runtime-release-handoff.md)
 
----
+## Wenn du nur vier Seiten liest
 
-*Letzte Aktualisierung: 8. Mai 2026*
+1. [Quick Start Guide](./quick-start-guide.md)
+2. [RMT vNext Authoring Guide](./rmt-vnext-authoring.md)
+3. [RMT vNext Component Primitives und XTend UI](./rmt-vnext-component-primitives.md)
+4. [Komponenten-Entwicklung](./components.md)