Skip to content

Latest commit

 

History

History
76 lines (63 loc) · 7.91 KB

frontend-parity-matrix.md

File metadata and controls

76 lines (63 loc) · 7.91 KB

Frontend ↔ Backend ↔ Worker Parity Matrix

Status: active

Generated by the platform frontend-parity sweep (2026-06-03). Maps each platform domain to its backend route surface, worker job family, MCP tool area, and the frontend surface that exposes it. Status reflects state at audit time.

IA note: The frontend uses a hub-and-tabs information architecture. A single route (e.g. /ai/observability/*) fans out into many tabbed sub-views, and extension frontends (system, supply-chain, marketing, business) are injected into the live build at runtime via frontend/src/shared/services/extensionLoader.ts. Parity is therefore measured at tab/sub-feature granularity, and a frontend/src-only scan cannot see extension-hosted surfaces.

Legend

  • ✅ Surfaced — has a reachable route/tab consuming the backend.
  • 🟡 Partial — surfaced but thin, or only some sub-capabilities exposed.
  • 🔌 Orphaned — frontend built but not wired to a route/nav (fixable by wire-up).
  • ❌ Gap — no frontend surface (or, for system, no operator REST controller).

Core AI domains

Domain Backend route Worker job family MCP tool area Frontend surface Status
Agents /ai/agents (+executions, conversations, intelligence) ai_agent_execution, ai_agent_fleet_* (5) AgentManagementTool (8) /ai/agents hub (Agents/Cards/Community tabs) + detail ✅
Teams /ai/teams (+roles, channels, templates, executions) ai_agent_team_execution TeamManagementTool (8) /ai/teams ✅
Missions / Code Factory /ai/missions, /ai/code_factory ai_mission_* (9), ai_code_factory_* (8) (job-driven) /ai/missions hub (Missions + Code Factory) ✅
Providers / Model Router /ai/providers, /ai/model_router ai_provider_* (provider tools) /ai/providers, /ai/model-router (AI Platform items) ✅
Conversations / Chat /ai/conversations, /chat/* ai_chat_* (3), ai_conversation_response ConversationTool (11) chat surfaces + /ai/conversations ✅
Knowledge / RAG / Graph /ai/rag, /ai/knowledge_graph, /ai/skill_graph ai_knowledge_* (3) RagManagementTool, KnowledgeGraphTool /ai/knowledge hub (Contexts/Tiered Memory/RAG/Graph/Learning); /ai/skills, /ai/prompts ✅
Memory /ai/contexts, /ai/memory_pools, /tiered_memory ai_memory_* (4), ai_consolidate_memory_entry MemoryTool, AgentMemoryManagementTool Knowledge → Tiered Memory tab; agent detail → Memory tab (/ai/agents/:id/memory: Agent Memory, Memory Pools) ✅
Autonomy / Governance /ai/autonomy, /ai/governance, /ai/kill_switch ai_governance_scan, ai_collusion_detection, ai_goal_*, ai_escalation_timeout GovernanceTool, AgentAutonomyTool, KillSwitchTool /ai/control (rail: Approvals / Policies / Budgets / Safety / Trust & Lineage / Goals / Compliance Audit); Coordination is a tab on /ai/teams ✅
Ralph Loops /ai/ralph_loops ai_ralph_loop_scheduler, ai_ralph_loop_run_all RalphLoopTool (7) /ai/execution → Ralph Loops tab ✅
Monitoring / Observability /ai/monitoring, /ai/aiops ai_monitoring_*, ai_self_healing_monitor, ai_predictive_monitor ActivityMonitorTool /ai/observability hub ✅
Sandboxes / Execution /ai/sandboxes, /ai/container_sandboxes ai_container_agent, ai_execution_* ContainerDeployment/Status/Logs/Terminate /ai/execution hub (Ralph/A2A/Parallel/Resources/AG-UI/Testing/Sandboxes) ✅
A2A / Federation / Community /ai/a2a, /ai/federation, /ai/community/agents federation_* (4) (federation jobs) /ai/agents → Community (incl. FederationPartner* components) ✅
FinOps /ai/finops (analytics jobs) — features/ai/finops built (FinOpsContent + 5 components) 🔌 orphaned
ROI /ai/roi (analytics jobs) — features/ai/roi built (RoiDashboard + RoiApiService) 🔌 orphaned
Execution Traces execution_traces_controller ai_trajectory_* (2) — features/ai/debugging built (TraceViewer/Timeline/SpanDetail) 🔌 orphaned

Core platform domains

Domain Backend route Worker job family Frontend surface Status
Git / Source Control /git/* git/* (4) /devops/source-control hub ✅
CI/CD Pipelines /devops/pipelines devops/* (13) /devops/ci-cd hub ✅
Docker / Swarm / K8s /devops/{docker,swarm,kubernetes} docker/* (3) /devops/containers hub (/devops/containers/{docker,swarm,kubernetes}) ✅ (K8s 🟡 clusters-only)
Integrations / Webhooks / API Keys /integrations, /webhooks, /api-keys integrations/, webhooks/ /devops/integrations hub + /devops/api-keys ✅
Supply Chain /supply_chain/* (26 controllers) (job-driven) supply-chain extension ✅ (extension)
Account / Users / Roles /accounts, /users, /roles, /delegations — /profile, /admin/users, /admin/roles ✅ (delegations 🟡)
Admin / Settings / Maintenance /admin/*, /admin_settings maintenance/* (5) /admin/* hubs ✅
Files / Storage /files, /storage_providers file_processing/* /content/files, /admin/storage ✅
KB / Pages /kb/*, /pages reports/* /content/kb, /content/pages ✅
Notifications / Audit /notifications, /audit_logs notifications/* NotificationCenter, /admin/audit-logs ✅
Privacy /privacy/* compliance/* /privacy ✅
OAuth apps /oauth/applications auth_cleanup consent + callback only 🟡 no app-mgmt UI
Reports /reports reports/* — ❌ no report builder UI
Developer portal api_reference, /api-keys — features/developer built (Portal/ApiDocs/ApiKeyManager) 🔌 orphaned

System / Fleet (extension extensions/system/)

Hub exists in the submodule frontend (extensions/system/frontend/src/, 11 hub pages, ~45 services), wired via extensionLoader.ts. REST controllers exist for essentially every tab.

Sub-hub Backend Frontend tab Status
Compute (Nodes/Devices/Volumes/Providers/Networks) system/{nodes,node_instances,unclaimed_devices,providers,provider_networks} ComputePage ✅
Catalog (Templates/Modules/Packages/Puppet/Scripts/Arch/Platforms) system/{node_templates,node_modules,package_repositories,puppet_modules,...} CatalogPage ✅
Operations (Fleet/Tasks/CI Workers/CI Webhooks) system/{fleet,tasks,ci_workers,disk_image_webhooks} OperationsHubPage ✅
SDWAN (Topology/Networks/Routing/Federation/OVN/IPFIX) system/sdwan/* (80+ MCP, REST for reads+core writes) SdwanHubPage ✅ (OVN/host-bridge writes intentionally MCP-only)
Federation / Service Delivery / ACME / Ingress / Instance Pools system/{platform,federation,acme_*,ingress_routes,instance_pools} respective pages ✅
GitOps system/gitops_repositories (REST exists) — none ❌ frontend gap
CVE operator only worker_api/cve* (service-to-service) — none ❌ needs backend operator controller first

Worker job → UI surface (user-facing families)

All "produces user-facing results" families (agent execution, missions, code factory, provisioning, governance, monitoring, pipelines, ralph loops, chat, traces, git, MCP, analytics, federation, ACME cert status) have a surfacing route per the matrix above. Purely internal maintenance families (memory decay, learning dedup, compliance cleanup, session/token cleanup, backup cleanup) intentionally have no UI.

Summary of actionable gaps

  1. Wire-ups (built, unrouted): FinOps, ROI, Execution Traces, Developer Portal → new Cost + Developer nav sections.
  2. System extension: add GitOps tab (backend ready) and CVE operator surface (backend controller first).
  3. Lower priority (cataloged, not in this sweep): Reports builder UI, OAuth application management UI.

Last verified: 2026-06-04