Surface inbound API method compile errors to operators (api-method validate / recompile) #75

Open
opened 2026-11-06 15:24:47 -05:00 by dohertj2 · 0 comments
Owner

When an inbound method's script fails to compile, callers get a generic Script compilation failed for this method (correct for the data plane). The real Roslyn diagnostic goes only to the central log, which on the wonder boxes means remote log access. There is no api-method validate, and the _knownBadMethods cache in InboundScriptExecutor cannot be observed or reset per method. A direct DB edit keeps serving the failure until a full-replace UpdateApiMethod or a restart.

Suggested fix:

  • api-method validate --id backed by a role-gated management ValidateApiMethodCommand that returns diagnostics (mirror template validate).
  • LastCompileError + IsKnownBad on api-method get.
  • A lightweight api-method recompile --id (RecompileApiMethodCommand) to re-run CompileAndRegister without re-sending the entity.

Current state: still open. A grep of src/ for ValidateApiMethod|RecompileApiMethod|LastCompileError|IsKnownBad returns nothing.

Source: docs/known-issues/2026-06-25-inbound-api-compile-error-not-client-visible.md (Status: OPEN, items 1 and 2)

When an inbound method's script fails to compile, callers get a generic `Script compilation failed for this method` (correct for the data plane). The real Roslyn diagnostic goes only to the central log, which on the wonder boxes means remote log access. There is no `api-method validate`, and the `_knownBadMethods` cache in `InboundScriptExecutor` cannot be observed or reset per method. A direct DB edit keeps serving the failure until a full-replace `UpdateApiMethod` or a restart. Suggested fix: - `api-method validate --id` backed by a role-gated management `ValidateApiMethodCommand` that returns diagnostics (mirror `template validate`). - `LastCompileError` + `IsKnownBad` on `api-method get`. - A lightweight `api-method recompile --id` (`RecompileApiMethodCommand`) to re-run `CompileAndRegister` without re-sending the entity. **Current state:** still open. A grep of `src/` for `ValidateApiMethod|RecompileApiMethod|LastCompileError|IsKnownBad` returns nothing. Source: `docs/known-issues/2026-06-25-inbound-api-compile-error-not-client-visible.md` (Status: OPEN, items 1 and 2)
dohertj2 added the type:featurepriority:p2migrated labels 2026-11-06 15:24:47 -05:00
Sign in to join this conversation.