Add external object new circuit command

docs/circuit-list-editor-known-limitations.md

@@ -10,10 +10,10 @@
   through the project page with persistent Undo/Redo. Automatic snapshots are
   created every 25 revisions and only their newest 12 entries are retained.
 - The Revit/CSV foundation and confirmed initial import are implemented.
-  Existing-row assignment, move and detach and creation of an external-only row
-  in an existing circuit have atomic persistent commands. Their editor UI, the
-  new-circuit path, follow-up import, conflict review and return export are
-  pending.
+  Existing-row assignment, move and detach plus creation of an external-only
+  row in an existing or newly created circuit have atomic persistent commands.
+  Their API planning and editor UI, follow-up import, conflict review and return
+  export are pending.
 - Persistence currently targets local SQLite; PostgreSQL is an architectural option, not an implemented runtime.
 - The global device library supports basic CRUD and copy operations, but has no
   versioning, permissions or controlled synchronization model.

docs/current-architecture.md

@@ -559,6 +559,17 @@ und löscht die erzeugte Row nur, wenn sie und ihre Linkmenge unverändert sind.
 Der Löschbefehl ist ausschließlich für die Projekthistorie zugelassen; eine
 normale spätere Trennung lässt die Row gemäß der allgemeinen Zuordnungsregel
 bestehen.
+`external-object.assign-to-new-circuit` erzeugt einen neuen Stromkreis mit
+vorab festgeschriebenem BMK, abgeleiteter Projektspannung, genau einer
+externen Row und verpflichtendem Standardschutz zusammen mit den Objektlinks.
+Verteilungs-, Gruppen-, Raum-, Mengen- und Planungsregeln werden vor dem Insert
+gegen den aktuellen Projektstand geprüft. Der historische Gegenbefehl ist kein
+allgemeiner Löschpfad: Er entfernt den vollständigen Circuit-Teilbaum nur bei
+unverändertem Snapshot und unveränderter Objektlinkmenge. Redo verwendet exakt
+dieselben IDs, dasselbe BMK und denselben Schutzsnapshot.
+Die drei Zuordnungsadapter teilen sich
+`external-object-assignment.persistence.ts` für Snapshotvergleich,
+Kompatibilitätsregeln und link-sichere Updates.
 `GET` und `PUT /api/projects/:projectId/external-csv/configuration` lesen oder
 ändern die Konfiguration; der PUT plant Identität und nächsten
 Konfigurationsstand serverseitig und verwendet den typisierten Command.

docs/spec/revit-csv-phase-14-audit-and-plan.md

@@ -205,9 +205,9 @@ bleiben und dürfen spätere Quellstände nicht erneut auswerten.
 - `external-object.update-row-assignment`: Ein oder mehrere Objekte einer
   bestehenden Row zuweisen, zwischen bestehenden Rows verschieben oder lösen
   und alle betroffenen materialisierten Mengen atomar aktualisieren.
-- `external-model-object.assign-to-new-row`: stabile neue Row einfügen,
+- `external-object.assign-to-new-row`: stabile neue Row einfügen,
   Objekte verknüpfen und gegebenenfalls den Reserve-Status aktualisieren.
-- `external-model-object.assign-to-new-circuit`: stabilen Circuit samt Schutz,
+- `external-object.assign-to-new-circuit`: stabilen Circuit samt Schutz,
   Row und Objektlinks in einem Schritt einfügen. Das geplante BMK wird im
   Command gespeichert und bei Redo nicht neu berechnet.
 - `external-model-object.delete-missing`: nur ausdrücklich bestätigte,
@@ -330,7 +330,13 @@ Kombination aus Originalbytes und Matrix als Entscheidungen bestätigt.
    Diese Row erhält eine stabile ID und `manualQuantity = 0`; ihr historischer
    Gegenbefehl entfernt sie nur, solange Row und Objektlinks vollständig
    unverändert sind. Ein direktes Löschen über diesen internen Gegenbefehl ist
-   als Nutzeraktion gesperrt. Der neue Circuit folgt separat.
+   als Nutzeraktion gesperrt. `external-object.assign-to-new-circuit` schließt
+   den dritten Zielpfad: Ein serverseitig vorgeplanter Circuit mit festem BMK,
+   Standardschutz und genau einer externen Row wird gemeinsam mit den
+   Objektlinks eingefügt. Seine Historiengegenrichtung prüft den vollständigen
+   Circuit-Snapshot und die exakte Linkmenge, bevor sie den Teilbaum entfernt.
+   BMK und UUIDs bleiben bei Redo unverändert. Damit ist die persistente
+   Command-Grundlage dieses Schritts abgeschlossen; API-Planung und UI folgen.
 3. Verteilungsbezogenen Drawer, Filter und Vorschau der Mengenwirkung ergänzen.
 4. Einzel- und Mehrfach-Drag-and-drop samt Warnungen, Undo/Redo und Reload
    testen.