feat(P8): IHF Phase 8 complete — Federated Hub Maturity

Implements the final phase of the IHF v0.1 specification:

- WidgetOwnership: delegated ownership registry (local/delegated/global),
  append-only audit artefacts, ownership badge on widget show page
- HubRoutingRule + RoutingEngine: priority-ordered inter-hub routing engine;
  null-inclusive category/widget-type matching; RouteNowAction for manual
  re-evaluation; RoutedCandidates view per hub
- FederatedPolicyOverlay: draft → active → retired lifecycle; activated
  overlays are immutable (same pattern as Phase 6 contracts); policy
  compliance dashboard with decision coverage metrics
- StewardshipRole: named governance roles per hub; point-in-time revocation
  pattern; hub and ops-board integration
- ArchiveRecord + is_archived: soft-delete on widgets; lineage inspector
  traces full traceability chain (Widget → Events → Annotations → Candidates
  → Requirements → Decisions → Deployments → Signals + ArchiveRecord)
- FederatedGovernanceDashboard: 5-panel autoRefresh org-wide governance view
  (ownership coverage, routing activity, policy compliance, stewardship
  coverage, archive activity)

Schema: widget_ownerships, hub_routing_rules, federated_policy_overlays,
stewardship_roles, archive_records; ALTER widgets ADD is_archived;
ALTER requirement_candidates ADD routed_to_hub_id

Migration: 1743638400-ihf-phase8-federated-hub-maturity.sql
Tests: Phase 8 integration tests appended to Test/Integration.hs
Docs: docs/phase8-summary.md; SCOPE.md updated to Phase 8 complete

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Web/View/HubRoutingRules/Edit.hs

@@ -0,0 +1,28 @@
+module Web.View.HubRoutingRules.Edit where
+
+import Web.Types
+import Generated.Types
+import IHP.Prelude
+import IHP.ViewPrelude
+
+data EditView = EditView
+    { rule :: !HubRoutingRule
+    , hubs :: ![Hub]
+    }
+
+instance View EditView where
+    html EditView { .. } = [hsx|
+        <div class="max-w-lg">
+            <h1 class="text-2xl font-semibold mb-6">Edit Routing Rule</h1>
+            {renderForm rule}
+        </div>
+    |]
+
+renderForm :: HubRoutingRule -> Html
+renderForm rule = formFor rule [hsx|
+    {(textField #matchCategory){ helpText = "Leave blank to match any category" }}
+    {(textField #matchWidgetType){ helpText = "Leave blank to match any widget type" }}
+    {numberField #priority}
+    {textareaField #notes}
+    {submitButton}
+|]

Web/View/HubRoutingRules/Index.hs

@@ -0,0 +1,78 @@
+module Web.View.HubRoutingRules.Index where
+
+import Web.Types
+import Generated.Types
+import IHP.Prelude
+import IHP.ViewPrelude
+
+data IndexView = IndexView
+    { rules :: ![HubRoutingRule]
+    , hubs  :: ![Hub]
+    }
+
+instance View IndexView where
+    html IndexView { .. } = [hsx|
+        <div class="flex items-center justify-between mb-6">
+            <h1 class="text-2xl font-semibold">Hub Routing Rules</h1>
+            <a href={NewHubRoutingRuleAction}
+               class="text-sm bg-blue-600 text-white px-3 py-1.5 rounded hover:bg-blue-700">
+                New Rule
+            </a>
+        </div>
+
+        {if null rules
+            then [hsx|<p class="text-sm text-gray-400">No routing rules configured yet.</p>|]
+            else [hsx|
+                <div class="bg-white rounded-lg border border-gray-200 overflow-hidden">
+                    <table class="w-full text-sm">
+                        <thead class="bg-gray-50 border-b border-gray-200">
+                            <tr>
+                                <th class="text-left px-4 py-3 font-medium text-gray-700">Source → Target</th>
+                                <th class="text-left px-4 py-3 font-medium text-gray-700">Match Category</th>
+                                <th class="text-left px-4 py-3 font-medium text-gray-700">Match Widget Type</th>
+                                <th class="text-left px-4 py-3 font-medium text-gray-700">Priority</th>
+                                <th class="text-left px-4 py-3 font-medium text-gray-700">Status</th>
+                                <th class="px-4 py-3"></th>
+                            </tr>
+                        </thead>
+                        <tbody class="divide-y divide-gray-100">
+                            {forEach rules renderRow}
+                        </tbody>
+                    </table>
+                </div>
+            |]}
+    |]
+      where
+        hubName hid = maybe (show hid) (.name) (find (\h -> h.id == hid) hubs)
+
+        renderRow :: HubRoutingRule -> Html
+        renderRow r = [hsx|
+            <tr class="hover:bg-gray-50">
+                <td class="px-4 py-3 font-medium text-gray-800">
+                    {hubName r.sourceHubId} → {hubName r.targetHubId}
+                </td>
+                <td class="px-4 py-3 text-gray-500">{maybe "any" id r.matchCategory}</td>
+                <td class="px-4 py-3 text-gray-500">{maybe "any" id r.matchWidgetType}</td>
+                <td class="px-4 py-3 text-gray-600">{show r.priority}</td>
+                <td class="px-4 py-3">
+                    <span class={statusBadge r.status <> " text-xs px-2 py-0.5 rounded font-medium"}>
+                        {r.status}
+                    </span>
+                </td>
+                <td class="px-4 py-3 text-right space-x-3">
+                    <a href={ShowHubRoutingRuleAction { hubRoutingRuleId = r.id }}
+                       class="text-xs text-blue-600 hover:underline">View</a>
+                    {if r.status == "inactive"
+                        then [hsx|<a href={ActivateRoutingRuleAction { hubRoutingRuleId = r.id }}
+                                     class="text-xs text-green-600 hover:underline">Activate</a>|]
+                        else [hsx|<a href={DeactivateRoutingRuleAction { hubRoutingRuleId = r.id }}
+                                     class="text-xs text-gray-500 hover:underline">Deactivate</a>|]}
+                </td>
+            </tr>
+            |]
+
+statusBadge :: Text -> Text
+statusBadge s = case s of
+    "active"   -> "bg-green-100 text-green-700"
+    "inactive" -> "bg-gray-100 text-gray-500"
+    _          -> "bg-gray-100 text-gray-600"

Web/View/HubRoutingRules/New.hs

@@ -0,0 +1,30 @@
+module Web.View.HubRoutingRules.New where
+
+import Web.Types
+import Generated.Types
+import IHP.Prelude
+import IHP.ViewPrelude
+
+data NewView = NewView
+    { rule :: !HubRoutingRule
+    , hubs :: ![Hub]
+    }
+
+instance View NewView where
+    html NewView { .. } = [hsx|
+        <div class="max-w-lg">
+            <h1 class="text-2xl font-semibold mb-6">New Routing Rule</h1>
+            {renderForm rule hubs}
+        </div>
+    |]
+
+renderForm :: HubRoutingRule -> [Hub] -> Html
+renderForm rule hubs = formFor rule [hsx|
+    {(selectField #sourceHubId hubs){ label = "Source Hub" }}
+    {(selectField #targetHubId hubs){ label = "Target Hub" }}
+    {(textField #matchCategory){ helpText = "Leave blank to match any category" }}
+    {(textField #matchWidgetType){ helpText = "Leave blank to match any widget type" }}
+    {(numberField #priority){ helpText = "Higher priority rules are evaluated first" }}
+    {textareaField #notes}
+    {submitButton}
+|]

Web/View/HubRoutingRules/RoutedCandidates.hs

@@ -0,0 +1,63 @@
+module Web.View.HubRoutingRules.RoutedCandidates where
+
+import Web.Types
+import Generated.Types
+import IHP.Prelude
+import IHP.ViewPrelude
+
+data RoutedCandidatesView = RoutedCandidatesView
+    { hub        :: !Hub
+    , candidates :: ![RequirementCandidate]
+    }
+
+instance View RoutedCandidatesView where
+    html RoutedCandidatesView { .. } = [hsx|
+        <div class="flex items-center gap-3 mb-6">
+            <a href={HubRoutingRulesAction} class="text-sm text-gray-500 hover:underline">Routing Rules</a>
+            <span class="text-gray-300">/</span>
+            <h1 class="text-2xl font-semibold">Routed In: {hub.name}</h1>
+        </div>
+
+        <p class="text-sm text-gray-500 mb-4">
+            Requirement candidates routed to this hub from other hubs.
+        </p>
+
+        {if null candidates
+            then [hsx|<p class="text-sm text-gray-400">No candidates routed to this hub yet.</p>|]
+            else [hsx|
+                <div class="bg-white rounded-lg border border-gray-200 overflow-hidden">
+                    <table class="w-full text-sm">
+                        <thead class="bg-gray-50 border-b border-gray-200">
+                            <tr>
+                                <th class="text-left px-4 py-3 font-medium text-gray-700">Summary</th>
+                                <th class="text-left px-4 py-3 font-medium text-gray-700">Category</th>
+                                <th class="text-left px-4 py-3 font-medium text-gray-700">Status</th>
+                                <th class="text-left px-4 py-3 font-medium text-gray-700">Created</th>
+                                <th class="px-4 py-3"></th>
+                            </tr>
+                        </thead>
+                        <tbody class="divide-y divide-gray-100">
+                            {forEach candidates renderRow}
+                        </tbody>
+                    </table>
+                </div>
+            |]}
+    |]
+      where
+        renderRow :: RequirementCandidate -> Html
+        renderRow c = [hsx|
+            <tr class="hover:bg-gray-50">
+                <td class="px-4 py-3 text-gray-800">{c.summary}</td>
+                <td class="px-4 py-3 text-gray-500">{c.category}</td>
+                <td class="px-4 py-3">
+                    <span class="text-xs bg-yellow-100 text-yellow-800 px-2 py-0.5 rounded font-medium">
+                        {c.status}
+                    </span>
+                </td>
+                <td class="px-4 py-3 text-xs text-gray-400">{show c.createdAt}</td>
+                <td class="px-4 py-3 text-right">
+                    <a href={ShowRequirementCandidateAction { requirementCandidateId = c.id }}
+                       class="text-xs text-blue-600 hover:underline">View</a>
+                </td>
+            </tr>
+            |]

Web/View/HubRoutingRules/Show.hs

@@ -0,0 +1,72 @@
+module Web.View.HubRoutingRules.Show where
+
+import Web.Types
+import Generated.Types
+import IHP.Prelude
+import IHP.ViewPrelude
+import Web.View.HubRoutingRules.Index (statusBadge)
+
+data ShowView = ShowView
+    { rule      :: !HubRoutingRule
+    , sourceHub :: !Hub
+    , targetHub :: !Hub
+    }
+
+instance View ShowView where
+    html ShowView { .. } = [hsx|
+        <div class="max-w-2xl">
+            <div class="flex items-center gap-3 mb-6">
+                <a href={HubRoutingRulesAction} class="text-sm text-gray-500 hover:underline">Routing Rules</a>
+                <span class="text-gray-300">/</span>
+                <h1 class="text-2xl font-semibold">Routing Rule</h1>
+            </div>
+
+            <div class="bg-white rounded-lg border border-gray-200 p-6 space-y-4">
+                <div class="flex items-center gap-3">
+                    <span class="text-lg font-medium text-gray-800">
+                        {sourceHub.name} → {targetHub.name}
+                    </span>
+                    <span class={statusBadge rule.status <> " text-xs px-2 py-0.5 rounded font-medium"}>
+                        {rule.status}
+                    </span>
+                </div>
+
+                <dl class="grid grid-cols-2 gap-4 text-sm">
+                    <div>
+                        <dt class="text-gray-500">Match Category</dt>
+                        <dd class="font-medium">{maybe "any" id rule.matchCategory}</dd>
+                    </div>
+                    <div>
+                        <dt class="text-gray-500">Match Widget Type</dt>
+                        <dd class="font-medium">{maybe "any" id rule.matchWidgetType}</dd>
+                    </div>
+                    <div>
+                        <dt class="text-gray-500">Priority</dt>
+                        <dd>{show rule.priority}</dd>
+                    </div>
+                    <div>
+                        <dt class="text-gray-500">Created</dt>
+                        <dd>{show rule.createdAt}</dd>
+                    </div>
+                    {whenJust rule.notes \n -> [hsx|
+                        <div class="col-span-2">
+                            <dt class="text-gray-500">Notes</dt>
+                            <dd class="text-gray-700">{n}</dd>
+                        </div>
+                    |]}
+                </dl>
+            </div>
+
+            <div class="mt-4 flex gap-4">
+                <a href={EditHubRoutingRuleAction { hubRoutingRuleId = rule.id }}
+                   class="text-sm text-blue-600 hover:underline">Edit</a>
+                {if rule.status == "inactive"
+                    then [hsx|<a href={ActivateRoutingRuleAction { hubRoutingRuleId = rule.id }}
+                                 class="text-sm text-green-600 hover:underline">Activate</a>|]
+                    else [hsx|<a href={DeactivateRoutingRuleAction { hubRoutingRuleId = rule.id }}
+                                 class="text-sm text-gray-500 hover:underline">Deactivate</a>|]}
+                <a href={RoutedCandidatesAction { hubId = targetHub.id }}
+                   class="text-sm text-indigo-600 hover:underline">Routed Candidates →</a>
+            </div>
+        </div>
+    |]