ui: plainer wording across labels and command descriptions

Replace internal jargon and uncommon words in user-facing strings (better for
non-native English readers): drop "TransformRegistry-driven" / "drives
transforms" from the connect/set-connector-type subtitles; "transform lookup"
→ "tells connect how to wire its pins"; "populate pin specs" → "fills in each
pin's role and direction"; "clear the visualization area" → "clear the console
output"; "materialised" → "added"; refresh the verify description. Regenerated
commands.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

doc/user/commands.md

@@ -67,7 +67,7 @@ connect a part across two modules (interactive screen if no args)
 ---
 ### `set-connector-type`  *(interactive)*
 
-tag a part's connector type for transform lookup
+tag a part's connector type (tells connect how to wire its pins)
 
 **Arguments**
 
@@ -91,7 +91,7 @@ detect signal groups (diff pairs, buses) and structural anomalies
 ---
 ### `attach-bsdl`
 
-attach a BSDL (.bsd) model to a part and populate pin specs
+attach a BSDL (.bsd) model to a part (fills in each pin's role and direction)
 
 **Arguments**
 
@@ -106,7 +106,7 @@ attach a BSDL (.bsd) model to a part and populate pin specs
 ---
 ### `clear`
 
-clear the visualization area
+clear the console output
 
 **No arguments.**
 ---
@@ -253,7 +253,7 @@ execute a file of commands line by line (interactive cmds rejected)
 ---
 ### `verify`
 
-check pin roles, bridged-net consistency, and model-driven pin specs (contention/undriven/NC)
+check pin roles, power/gnd net consistency, and (with BSDL) pin and JTAG checks
 
 **No arguments.**
 ---

src/tui/commands.cpp

@@ -80,7 +80,7 @@ void Tui::RegisterCommands() {
         "list commands (or `help <name>` for one command's details)",
     };
     commands["clear"] = { {}, [this](auto &) { output.clear(); }, true,
-                          "clear the visualization area" };
+                          "clear the console output" };
     // quit / exit work from any screen: set the flag *and* call Exit() on the
     // captured ScreenInteractive so the FTXUI loop returns immediately. The
     // legacy main-screen Renderer also reads `quit` as a belt-and-braces
@@ -327,7 +327,7 @@ void Tui::RegisterCommands() {
         Print("verify: " + std::to_string(missing_anoms.size())
               + " BSDL completeness issue(s).");
     }, true,
-       "check pin roles, bridged-net consistency, and model-driven pin specs (contention/undriven/NC)" };
+       "check pin roles, power/gnd net consistency, and (with BSDL) pin and JTAG checks" };
 
     commands["dashboard"] = { {}, [this](auto &) {
         screen_idx = 4;
@@ -475,11 +475,11 @@ void Tui::RegisterCommands() {
             Print(mod->name + "/" + prt->name + ": connector_type = "
                   + (args[2].empty() ? "(none)" : args[2]));
             if (rep.materialised > 0)
-                Print("set-connector-type: materialised " + std::to_string(rep.materialised)
+                Print("set-connector-type: added " + std::to_string(rep.materialised)
-                      + " NC pin(s) from connector layout");
+                      + " NC pin(s) from the connector layout");
         },
         /*prompt_for_missing=*/ false,
-        "tag a part's connector type for transform lookup",
+        "tag a part's connector type (tells connect how to wire its pins)",
         /*scriptable=*/ true,
         /*interactive=*/ true,
     };
@@ -530,7 +530,7 @@ void Tui::RegisterCommands() {
                   + (r.unbound ? (", " + std::to_string(r.unbound) + " unbound") : ""));
         },
         /*prompt_for_missing=*/ false,
-        "attach a BSDL (.bsd) model to a part and populate pin specs",
+        "attach a BSDL (.bsd) model to a part (fills in each pin's role and direction)",
         /*scriptable=*/ true,
         /*interactive=*/ false,
     };
@@ -644,7 +644,7 @@ void Tui::RegisterCommands() {
                     int added = FillIdentityNCs(p1, p2);
                     Print("connect: " + info);
                     if (added > 0)
-                        Print("connect: materialised " + std::to_string(added)
+                        Print("connect: added " + std::to_string(added)
                               + " NC pin(s) so both sides match");
                 }
             }

src/tui/screen_connect.cpp

@@ -138,7 +138,7 @@ Component Tui::BuildConnectScreen() {
             text(" essim ") | bold,
             text("→ ") | dim,
             text("connect") | bold,
-            text("  — wire two parts across modules (TransformRegistry-driven)") | dim,
+            text("  — wire two parts across modules") | dim,
         });
 
         Element help = RenderHelpPanel("connect", {

src/tui/screen_settype.cpp

@@ -146,7 +146,7 @@ Component Tui::BuildSettypeScreen() {
             text(" essim ") | bold,
             text("→ ") | dim,
             text("set-connector-type") | bold,
-            text("  — tag a part with its connector kind (drives transforms + pin roles)") | dim,
+            text("  — tag a part's connector type (used to wire it correctly)") | dim,
         });
 
         Element help = RenderHelpPanel("set-connector-type", {