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/WidgetOwnerships/Edit.hs

@@ -0,0 +1,32 @@
+module Web.View.WidgetOwnerships.Edit where
+
+import Web.Types
+import Generated.Types
+import IHP.Prelude
+import IHP.ViewPrelude
+
+data EditView = EditView
+    { ownership :: !WidgetOwnership
+    , widgets   :: ![Widget]
+    , hubs      :: ![Hub]
+    }
+
+instance View EditView where
+    html EditView { .. } = [hsx|
+        <div class="max-w-lg">
+            <h1 class="text-2xl font-semibold mb-6">Edit Ownership</h1>
+            {renderForm ownership hubs}
+        </div>
+    |]
+
+renderForm :: WidgetOwnership -> [Hub] -> Html
+renderForm ownership hubs = formFor ownership [hsx|
+    {(selectField #stewardHubId hubs){ label = "Steward Hub (optional)" }}
+    {(selectField #ownershipType ownershipTypes){ label = "Ownership Type" }}
+    {dateTimeField #effectiveUntil}
+    {textareaField #notes}
+    {submitButton}
+|]
+  where
+    ownershipTypes :: [(Text, Text)]
+    ownershipTypes = [("local","local"), ("delegated","delegated"), ("global","global")]

Web/View/WidgetOwnerships/Index.hs

@@ -0,0 +1,76 @@
+module Web.View.WidgetOwnerships.Index where
+
+import Web.Types
+import Generated.Types
+import IHP.Prelude
+import IHP.ViewPrelude
+
+data IndexView = IndexView
+    { ownerships :: ![WidgetOwnership]
+    , widgets    :: ![Widget]
+    , hubs       :: ![Hub]
+    }
+
+instance View IndexView where
+    html IndexView { .. } = [hsx|
+        <div class="flex items-center justify-between mb-6">
+            <h1 class="text-2xl font-semibold">Widget Ownerships</h1>
+            <a href={NewWidgetOwnershipAction}
+               class="text-sm bg-blue-600 text-white px-3 py-1.5 rounded hover:bg-blue-700">
+                Assign Ownership
+            </a>
+        </div>
+
+        {if null ownerships
+            then [hsx|<p class="text-sm text-gray-400">No ownership records 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">Widget</th>
+                                <th class="text-left px-4 py-3 font-medium text-gray-700">Owner Hub</th>
+                                <th class="text-left px-4 py-3 font-medium text-gray-700">Steward Hub</th>
+                                <th class="text-left px-4 py-3 font-medium text-gray-700">Type</th>
+                                <th class="text-left px-4 py-3 font-medium text-gray-700">Effective From</th>
+                                <th class="px-4 py-3"></th>
+                            </tr>
+                        </thead>
+                        <tbody class="divide-y divide-gray-100">
+                            {forEach ownerships renderRow}
+                        </tbody>
+                    </table>
+                </div>
+            |]}
+    |]
+      where
+        widgetName wid = maybe (show wid) (.name) (find (\w -> w.id == wid) widgets)
+        hubName hid    = maybe "–" (.name) (find (\h -> h.id == hid) hubs)
+
+        renderRow :: WidgetOwnership -> Html
+        renderRow o = [hsx|
+            <tr class="hover:bg-gray-50">
+                <td class="px-4 py-3 font-medium text-gray-800">{widgetName o.widgetId}</td>
+                <td class="px-4 py-3 text-gray-600">{hubName o.ownerHubId}</td>
+                <td class="px-4 py-3 text-gray-500 text-xs">
+                    {maybe "–" hubName o.stewardHubId}
+                </td>
+                <td class="px-4 py-3">
+                    <span class={typeBadge o.ownershipType <> " text-xs px-2 py-0.5 rounded font-medium"}>
+                        {o.ownershipType}
+                    </span>
+                </td>
+                <td class="px-4 py-3 text-xs text-gray-400">{show o.effectiveFrom}</td>
+                <td class="px-4 py-3 text-right">
+                    <a href={ShowWidgetOwnershipAction { widgetOwnershipId = o.id }}
+                       class="text-xs text-blue-600 hover:underline">View</a>
+                </td>
+            </tr>
+            |]
+
+typeBadge :: Text -> Text
+typeBadge t = case t of
+    "local"     -> "bg-gray-100 text-gray-700"
+    "delegated" -> "bg-blue-100 text-blue-700"
+    "global"    -> "bg-purple-100 text-purple-700"
+    _           -> "bg-gray-100 text-gray-600"

Web/View/WidgetOwnerships/New.hs

@@ -0,0 +1,35 @@
+module Web.View.WidgetOwnerships.New where
+
+import Web.Types
+import Generated.Types
+import IHP.Prelude
+import IHP.ViewPrelude
+
+data NewView = NewView
+    { ownership :: !WidgetOwnership
+    , widgets   :: ![Widget]
+    , hubs      :: ![Hub]
+    }
+
+instance View NewView where
+    html NewView { .. } = [hsx|
+        <div class="max-w-lg">
+            <h1 class="text-2xl font-semibold mb-6">Assign Ownership</h1>
+            {renderForm ownership widgets hubs}
+        </div>
+    |]
+
+renderForm :: WidgetOwnership -> [Widget] -> [Hub] -> Html
+renderForm ownership widgets hubs = formFor ownership [hsx|
+    {(selectField #widgetId widgets) { label = "Widget" }}
+    {(selectField #ownerHubId hubs)  { label = "Owner Hub" }}
+    {(selectField #stewardHubId hubs){ label = "Steward Hub (optional)" }}
+    {(selectField #ownershipType ownershipTypes){ label = "Ownership Type" }}
+    {dateTimeField #effectiveFrom}
+    {dateTimeField #effectiveUntil}
+    {textareaField #notes}
+    {submitButton}
+|]
+  where
+    ownershipTypes :: [(Text, Text)]
+    ownershipTypes = [("local","local"), ("delegated","delegated"), ("global","global")]

Web/View/WidgetOwnerships/Show.hs

@@ -0,0 +1,74 @@
+module Web.View.WidgetOwnerships.Show where
+
+import Web.Types
+import Generated.Types
+import IHP.Prelude
+import IHP.ViewPrelude
+import Web.View.WidgetOwnerships.Index (typeBadge)
+
+data ShowView = ShowView
+    { ownership  :: !WidgetOwnership
+    , widget     :: !Widget
+    , ownerHub   :: !Hub
+    , mStewardHub :: !(Maybe Hub)
+    }
+
+instance View ShowView where
+    html ShowView { .. } = [hsx|
+        <div class="max-w-2xl">
+            <div class="flex items-center gap-3 mb-6">
+                <a href={WidgetOwnershipsAction} class="text-sm text-gray-500 hover:underline">Ownerships</a>
+                <span class="text-gray-300">/</span>
+                <h1 class="text-2xl font-semibold">Ownership Record</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={typeBadge ownership.ownershipType <> " text-sm px-3 py-1 rounded-full font-medium"}>
+                        {ownership.ownershipType}
+                    </span>
+                </div>
+
+                <dl class="grid grid-cols-2 gap-4 text-sm">
+                    <div>
+                        <dt class="text-gray-500">Widget</dt>
+                        <dd class="font-medium">
+                            <a href={ShowWidgetAction { widgetId = widget.id }}
+                               class="text-blue-600 hover:underline">{widget.name}</a>
+                        </dd>
+                    </div>
+                    <div>
+                        <dt class="text-gray-500">Owner Hub</dt>
+                        <dd class="font-medium">{ownerHub.name}</dd>
+                    </div>
+                    <div>
+                        <dt class="text-gray-500">Steward Hub</dt>
+                        <dd class="font-medium">{maybe "Same as owner" (.name) mStewardHub}</dd>
+                    </div>
+                    <div>
+                        <dt class="text-gray-500">Effective From</dt>
+                        <dd>{show ownership.effectiveFrom}</dd>
+                    </div>
+                    <div>
+                        <dt class="text-gray-500">Effective Until</dt>
+                        <dd>{maybe "–" show ownership.effectiveUntil}</dd>
+                    </div>
+                    <div>
+                        <dt class="text-gray-500">Created</dt>
+                        <dd>{show ownership.createdAt}</dd>
+                    </div>
+                    {whenJust ownership.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">
+                <a href={EditWidgetOwnershipAction { widgetOwnershipId = ownership.id }}
+                   class="text-sm text-blue-600 hover:underline">Edit</a>
+            </div>
+        </div>
+    |]