docs: create-time connection bindings (Central UI, DeploymentManager preview flatten, CLI cross-ref)

Claude-Session: https://claude.ai/code/session_01G2GHPnbbKGvyyfbr2XBRVH
2026-08-21 06:14:55 -04:00
parent 80b9ab2d57
commit a26edffd4c
6 changed files with 98 additions and 11 deletions
@@ -252,6 +252,18 @@ remains the authoritative compile**: instance deployment re-flattens with
 `validateScripts: true` (the default), and a script that fails to compile blocks
 the deployment (see Site-Side Apply Atomicity).

+### Preview flatten (no instance row)
+
+`IFlatteningPipeline.PreviewAsync(templateId, siteId)` flattens a template against
+a site **as if** an instance with no overrides and no bindings existed there. It
+returns the `FlattenedConfiguration` alone — no validation, no revision hash,
+nothing persisted, and the instance repository is never touched. It exists for the
+Central UI's Create Instance page, which needs the instance's module groups (and
+therefore a real flatten, composed members included) *before* the instance row is
+created; see `Component-CentralUI.md` → Instance Management. It shares the template
+chain + nested-composition walk with `FlattenAndValidateAsync` (`LoadTemplateGraphAsync`),
+so the two cannot drift, and each call gets a private `FlattenSession`.
+
 ## Deployable Artifacts

 A deployment to a site includes the flattened instance configuration plus any system-wide artifacts that have changed: