feat(inbound-api): surface method compile errors to operators — api-method validate/recompile + compile state on get (ScadaBridge#75)

The data plane answers a broken inbound method with the generic "Script
compilation failed for this method"; the Roslyn diagnostic reached only the
central log, and the known-bad cache could not be observed or reset per method.

- InboundScriptExecutor keeps the diagnostics with each known-bad record and
  exposes GetCompileState(name, currentScript): IsCompiled / IsKnownBad /
  LastCompileError, judged against the current script text (a record for older
  text is reported as not compiled yet).
- Management: ValidateApiMethodCommand (compile the stored script, return
  ApiMethodCompileResult, register nothing, cache untouched) and
  RecompileApiMethodCommand (CompileAndRegister without re-sending the entity,
  drops the node's ApiMethodCache row, audited "Recompile"). Both Designer, like
  UpdateApiMethod; dispatched through the shared ApiMethodCompileOperations.
  GetApiMethod keeps the entity fields top-level and adds isCompiled,
  isKnownBad, lastCompileError and compileStateNode. Compile state is per
  central node and every result names the node.
- CLI: api-method validate --id, api-method recompile --id.
- Central UI: the API-method edit page shows the saved script's compile state
  and last error, with Validate and Recompile actions (same operations, same
  Designer gate, fresh DI scope).
- RequiredRoleMatrixTests entries; ManagementSurfaceParityTests covers the new
  CLI leaves; ApiMethodCompileDiagnosticsTests + an executor CompileState test.
- Docs: CLI README, Component-CLI/ManagementService/InboundAPI, components/*.

Claude-Session: https://claude.ai/code/session_01GT67AEHd2Acv1YPwGfXEoV

src/ZB.MOM.WW.ScadaBridge.ManagementService/ManagementActor.cs

@@ -328,6 +328,9 @@ public class ManagementActor : ReceiveActor
             or CreateSharedSchemaCommand or UpdateSharedSchemaCommand or DeleteSharedSchemaCommand
             or CreateDatabaseConnectionDefCommand or UpdateDatabaseConnectionDefCommand or DeleteDatabaseConnectionDefCommand
             or CreateApiMethodCommand or UpdateApiMethodCommand or DeleteApiMethodCommand
+            // ScadaBridge#75: operator compile diagnostics + targeted recompile, the same
+            // authority as UpdateApiMethod (which recompiles as a side effect).
+            or ValidateApiMethodCommand or RecompileApiMethodCommand
             or CreateTemplateFolderCommand or RenameTemplateFolderCommand
             or MoveTemplateFolderCommand or ReorderTemplateFolderCommand or DeleteTemplateFolderCommand
             or MoveTemplateToFolderCommand
@@ -526,6 +529,8 @@ public class ManagementActor : ReceiveActor
             CreateApiMethodCommand cmd => await HandleCreateApiMethod(sp, cmd, user.Username),
             UpdateApiMethodCommand cmd => await HandleUpdateApiMethod(sp, cmd, user.Username),
             DeleteApiMethodCommand cmd => await HandleDeleteApiMethod(sp, cmd, user.Username),
+            ValidateApiMethodCommand cmd => await ApiMethodCompileOperations.ValidateAsync(sp, cmd.ApiMethodId),
+            RecompileApiMethodCommand cmd => await ApiMethodCompileOperations.RecompileAsync(sp, cmd.ApiMethodId, user.Username),
 
             // Security
             ListRoleMappingsCommand => await HandleListRoleMappings(sp),
@@ -3802,7 +3807,26 @@ public class ManagementActor : ReceiveActor
     private static async Task<object?> HandleGetApiMethod(IServiceProvider sp, GetApiMethodCommand cmd)
     {
         var repo = sp.GetRequiredService<IInboundApiRepository>();
-        return await repo.GetApiMethodByIdAsync(cmd.ApiMethodId);
+        var method = await repo.GetApiMethodByIdAsync(cmd.ApiMethodId);
+        if (method is null)
+            return null;
+        // ScadaBridge#75: the entity fields stay top-level (additive), plus this node's
+        // compile state so an operator can see why a method fails without firing it.
+        var status = ApiMethodCompileOperations.GetStatus(sp, method);
+        return new
+        {
+            method.Id,
+            method.Name,
+            method.Script,
+            method.ParameterDefinitions,
+            method.ReturnDefinition,
+            method.TimeoutSeconds,
+            method.TraceAllCalls,
+            status?.IsCompiled,
+            status?.IsKnownBad,
+            status?.LastCompileError,
+            CompileStateNode = status?.Node,
+        };
     }
 
     private static async Task<object?> HandleCreateApiMethod(IServiceProvider sp, CreateApiMethodCommand cmd, string user)