fix(interactive): bridge Register-StrataCommand keymaps into the interaction CommandRegistry

Register-StrataCommand handlers (cmd:*) are now registered into the host's
CommandRegistry so CSS command: keymaps actually dispatch to the author's
scriptblock. Also corrects a stale README note.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: claude

src/Strata.Dsl.TerminalGui/StrataInteractiveHost.cs

@@ -20,12 +20,18 @@ public sealed class StrataInteractiveHost
     private readonly StrataElement _root;
     private readonly StrataStore _store;
     private readonly Action<string, StrataUiEvent> _invokeHandler;
+    private readonly string[] _commandNames;
 
-    private StrataInteractiveHost(StrataElement root, StrataStore store, Action<string, StrataUiEvent> invokeHandler)
+    private StrataInteractiveHost(
+        StrataElement root,
+        StrataStore store,
+        Action<string, StrataUiEvent> invokeHandler,
+        IEnumerable<string>? commandNames)
     {
         _root = root;
         _store = store;
         _invokeHandler = invokeHandler;
+        _commandNames = commandNames?.ToArray() ?? Array.Empty<string>();
     }
 
     /// <summary>Copy each bound list's resolved array into its <c>items</c> attribute for the projection.</summary>
@@ -62,6 +68,21 @@ public static void WriteFieldValue(StrataElement field, StrataStore store, strin
         }
     }
 
+    /// <summary>
+    /// Build the <see cref="CommandHandler"/> that bridges a CSS <c>command:</c> keymap named
+    /// <paramref name="name"/> to the author's dispatcher: when the command fires, invoke the
+    /// PowerShell handler registered under <c>cmd:&lt;name&gt;</c> with the focused element.
+    /// </summary>
+    public static CommandHandler MakeCommandHandler(
+        string name, StrataStore store, StrataElement fallback, Action<string, StrataUiEvent> invoke)
+    {
+        ArgumentNullException.ThrowIfNull(name);
+        ArgumentNullException.ThrowIfNull(store);
+        ArgumentNullException.ThrowIfNull(fallback);
+        ArgumentNullException.ThrowIfNull(invoke);
+        return ctx => invoke($"cmd:{name}", new StrataUiEvent(store, ctx.Node as StrataElement ?? fallback, null));
+    }
+
     private static JsonNode? ResolveFirst(string jsonPath, JsonObject state)
     {
         var result = JsonPath.Parse(jsonPath).Evaluate(state);
@@ -81,14 +102,15 @@ public static string Run(
         StrataElement root,
         string cssPath,
         StrataStore store,
-        Action<string, StrataUiEvent> invokeHandler)
+        Action<string, StrataUiEvent> invokeHandler,
+        IEnumerable<string>? commandNames = null)
     {
         ArgumentNullException.ThrowIfNull(root);
         ArgumentNullException.ThrowIfNull(cssPath);
         ArgumentNullException.ThrowIfNull(store);
         ArgumentNullException.ThrowIfNull(invokeHandler);
 
-        var host = new StrataInteractiveHost(root, store, invokeHandler);
+        var host = new StrataInteractiveHost(root, store, invokeHandler, commandNames);
 
         var registry = StylingProperties.CreateRegistry();
         InteractionProperties.RegisterAll(registry);
@@ -130,6 +152,10 @@ private string RunLoop(
 
             using var input = new TerminalGuiInputSource();
             var commands = new CommandRegistry();
+            foreach (var name in _commandNames)
+            {
+                commands.Register(name, MakeCommandHandler(name, _store, _root, _invokeHandler));
+            }
             using var interaction = new InteractionHost(input, commands);
 
             void Render()

src/Strata.PowerShell/README.md

@@ -64,5 +64,6 @@ A reusable layout is a function returning a parameterized subtree — see
 `samples/Strata.Demo.PowerShell/StrataTemplates.psm1` (`HostCard`), reused across the ping and
 uptime monitor samples.
 
-Rendering uses the Spectre live-redraw loop (ideal for monitoring dashboards). A Terminal.Gui
-interactive projection (focus/keyboard) over the same store + widgets is an additive future option.
+Rendering uses the Spectre live-redraw loop (ideal for monitoring dashboards). For interactive
+full-screen apps with focus and keyboard input, use `Show-StrataApp` — see the **Interactive apps**
+section above and `samples/Strata.Demo.PowerShell/db-query.ps1`.

src/Strata.PowerShell/Strata.PowerShell.psm1

@@ -187,7 +187,8 @@ function Show-StrataApp {
         }
     }.GetNewClosure()
     $action = [System.Action[string, Strata.Dsl.TerminalGui.StrataUiEvent]]$dispatch
-    [Strata.Dsl.TerminalGui.StrataInteractiveHost]::Run($Layout, $path, $Store, $action)
+    $commandNames = [string[]]@($script:StrataHandlers.Keys | Where-Object { $_ -like 'cmd:*' } | ForEach-Object { $_.Substring(4) })
+    [Strata.Dsl.TerminalGui.StrataInteractiveHost]::Run($Layout, $path, $Store, $action, $commandNames)
 }
 
 Export-ModuleMember -Function Element, Stack, Card, Text, Graph, Button, TextField, List, Show-Styled, New-StrataStore, Update-StrataStore, Start-StrataApp, Register-StrataCommand, Show-StrataApp

tests/Strata.Dsl.TerminalGui.Tests/HostWiringTests.cs

@@ -1,6 +1,7 @@
 using FluentAssertions;
 using Strata.Dsl;
 using Strata.Dsl.TerminalGui;
+using Strata.Interaction;
 using Xunit;
 
 namespace Strata.Dsl.TerminalGui.Tests;
@@ -43,4 +44,22 @@ public void WriteFieldValue_noop_without_bind_value()
         act.Should().NotThrow();
         store.State.Should().BeEmpty();
     }
+
+    [Fact]
+    public void MakeCommandHandler_invokes_dispatcher_with_cmd_prefixed_id_and_focused_element()
+    {
+        var store = StrataStore.FromJson("{}");
+        var root = new StrataElement("Stack");
+        var focused = new StrataElement("Button");
+        string? gotId = null;
+        StrataUiEvent? gotEvent = null;
+        Action<string, StrataUiEvent> invoke = (id, ev) => { gotId = id; gotEvent = ev; };
+
+        var handler = StrataInteractiveHost.MakeCommandHandler("run-query", store, root, invoke);
+        handler(new CommandContext(focused, new HostEvent.Custom("custom.x", null), null!));
+
+        gotId.Should().Be("cmd:run-query");
+        gotEvent!.Element.Should().BeSameAs(focused);
+        gotEvent.Store.Should().BeSameAs(store);
+    }
 }