feat: explain configured institutional architecture

webui/src/api/docs.ts

@@ -1,5 +1,42 @@
 import { apiFetch, type ApiSettings } from "@govoplan/core-webui";
 
+export type DocsModuleArchitecture = {
+  contract_version: string;
+  layer: string;
+  kind: string;
+  maturity: string;
+  evidence: Array<{ kind: string; reference: string; summary: string }>;
+  known_limits: string[];
+  supported_authority_modes: string[];
+  owned_concepts: string[];
+  non_owned_concepts: string[];
+  reference_packages: string[];
+  target_tested_providers: string[];
+  documentation: Record<string, string[]>;
+};
+
+export type DocsExternalProvider = {
+  id: string;
+  module_id: string;
+  label: string;
+  maturity: string;
+  operations: string[];
+  authority_modes: string[];
+  behavior?: Record<string, unknown>;
+  known_outage_behavior?: string | null;
+  runtime_state?: {
+    configured?: boolean;
+    active?: boolean;
+    authority_mode?: string | null;
+    authority_modes?: string[];
+    health?: string;
+    freshness?: string;
+    conflict?: string;
+    recovery?: string;
+    observed_at?: string;
+  } | null;
+};
+
 export type DocsModule = {
   id: string;
   name: string;
@@ -16,6 +53,9 @@ export type DocsModule = {
   capabilities: string[];
   documentation_count: number;
   documentation_provider_count: number;
+  architecture?: DocsModuleArchitecture | null;
+  external_provider_count: number;
+  external_providers: DocsExternalProvider[];
 };
 
 export type DocsRoute = {
@@ -168,6 +208,8 @@ export type DocsContext = {
   };
   summary: {
     module_count: number;
+    architecture_declared_module_count: number;
+    external_provider_count: number;
     visible_route_count: number;
     available_route_count: number;
     permission_count: number;