Class GetActiveFormForEntityAction

Read-only action that returns the currently-resolved interactive-form override (if any) for the (entity, user) pair plus the full list of applicable variants. Used by the Form Builder agent to decide between Create (no override exists) and Modify (an override already exists).

Resolution mirrors FormResolverService on the client:

• Scope precedence: User > Role > Global.
• Within a tier: Priority DESC, then __mj_CreatedAt DESC.
• Only Status='Active' rows are considered for the "active" pick. The full variants list includes 'Pending' rows so the agent can recognize an in-flight refinement loop and reuse the Pending row instead of spawning a new one.
• On an identity or permission entity only the caller's own User rows apply (FormScopeAllowedOnEntity), so a Role or Global form there is neither active nor listed.

Output shape (JSON in Message, also surfaced as a Result output param):

{
  "EntityName": "MJ: Applications",
  "Active": {
    "OverrideID": "...",
    "ComponentID": "...",
    "Scope": "User" | "Role" | "Global",
    "Priority": 0,
    "Status": "Active",
    "Spec": <ComponentSpec>,
    "ComponentName": "...",
    "ComponentVersion": "1.0.0",
    "VersionSequence": 1
  } | null,
  "Variants": [{ ...same shape... }, ...]   // all applicable, all statuses
}
Copy

If no overrides exist, Active is null and Variants is empty — the calling agent should then call Get Default Form Scaffold For Entity and Create Interactive Form.