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>
This commit is contained in:
2026-03-29 22:53:01 +00:00
parent 63fb0e8277
commit 9265ca2d9c
37 changed files with 2400 additions and 12 deletions

View File

@@ -0,0 +1,30 @@
module Web.View.FederatedPolicyOverlays.Edit where
import Web.Types
import Generated.Types
import IHP.Prelude
import IHP.ViewPrelude
data EditView = EditView
{ overlay :: !FederatedPolicyOverlay
, hubs :: ![Hub]
}
instance View EditView where
html EditView { .. } = [hsx|
<div class="max-w-2xl">
<h1 class="text-2xl font-semibold mb-6">Edit Policy Overlay</h1>
<p class="text-sm text-amber-700 bg-amber-50 border border-amber-200 rounded p-3 mb-4">
Only draft overlays can be edited. Once activated, this policy becomes immutable.
</p>
{renderForm overlay}
</div>
|]
renderForm :: FederatedPolicyOverlay -> Html
renderForm overlay = formFor overlay [hsx|
{textField #title}
{textareaField #policyText}
{(textareaField #notes){ label = "Notes (optional)" }}
{submitButton}
|]

View File

@@ -0,0 +1,74 @@
module Web.View.FederatedPolicyOverlays.Index where
import Web.Types
import Generated.Types
import IHP.Prelude
import IHP.ViewPrelude
data IndexView = IndexView
{ overlays :: ![FederatedPolicyOverlay]
, hubs :: ![Hub]
}
instance View IndexView where
html IndexView { .. } = [hsx|
<div class="flex items-center justify-between mb-6">
<h1 class="text-2xl font-semibold">Federated Policy Overlays</h1>
<div class="flex gap-2">
<a href={PolicyComplianceDashboardAction}
class="text-sm bg-gray-100 text-gray-700 px-3 py-1.5 rounded hover:bg-gray-200">
Compliance Dashboard
</a>
<a href={NewFederatedPolicyOverlayAction}
class="text-sm bg-blue-600 text-white px-3 py-1.5 rounded hover:bg-blue-700">
New Overlay
</a>
</div>
</div>
{if null overlays
then [hsx|<p class="text-sm text-gray-400">No policy overlays 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">Title</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">Enforced From</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 overlays renderRow}
</tbody>
</table>
</div>
|]}
|]
where
renderRow :: FederatedPolicyOverlay -> Html
renderRow o = [hsx|
<tr class="hover:bg-gray-50">
<td class="px-4 py-3 font-medium text-gray-800">{o.title}</td>
<td class="px-4 py-3">
<span class={statusBadge o.status <> " text-xs px-2 py-0.5 rounded font-medium"}>
{o.status}
</span>
</td>
<td class="px-4 py-3 text-xs text-gray-500">{maybe "" show o.enforcedFrom}</td>
<td class="px-4 py-3 text-xs text-gray-400">{show o.createdAt}</td>
<td class="px-4 py-3 text-right">
<a href={ShowFederatedPolicyOverlayAction { federatedPolicyOverlayId = o.id }}
class="text-xs text-blue-600 hover:underline">View</a>
</td>
</tr>
|]
statusBadge :: Text -> Text
statusBadge s = case s of
"draft" -> "bg-gray-100 text-gray-600"
"active" -> "bg-green-100 text-green-700"
"retired" -> "bg-red-100 text-red-600"
_ -> "bg-gray-100 text-gray-600"

View File

@@ -0,0 +1,27 @@
module Web.View.FederatedPolicyOverlays.New where
import Web.Types
import Generated.Types
import IHP.Prelude
import IHP.ViewPrelude
data NewView = NewView
{ overlay :: !FederatedPolicyOverlay
, hubs :: ![Hub]
}
instance View NewView where
html NewView { .. } = [hsx|
<div class="max-w-2xl">
<h1 class="text-2xl font-semibold mb-6">New Policy Overlay</h1>
{renderForm overlay}
</div>
|]
renderForm :: FederatedPolicyOverlay -> Html
renderForm overlay = formFor overlay [hsx|
{textField #title}
{(textareaField #policyText){ helpText = "Full policy text; once activated this cannot be changed" }}
{(textareaField #notes){ label = "Notes (optional)" }}
{submitButton}
|]

View File

@@ -0,0 +1,76 @@
module Web.View.FederatedPolicyOverlays.PolicyComplianceDashboard where
import Web.Types
import Generated.Types
import IHP.Prelude
import IHP.ViewPrelude
data PolicyComplianceDashboardView = PolicyComplianceDashboardView
{ overlays :: ![FederatedPolicyOverlay]
, hubs :: ![Hub]
, decisions :: ![DecisionRecord]
, policies :: ![PolicyReference]
}
instance View PolicyComplianceDashboardView where
html PolicyComplianceDashboardView { .. } = [hsx|
<div class="flex items-center justify-between mb-6">
<h1 class="text-2xl font-semibold">Policy Compliance Dashboard</h1>
<a href={FederatedPolicyOverlaysAction}
class="text-sm text-gray-500 hover:underline"> All Policies</a>
</div>
{if null overlays
then [hsx|
<div class="bg-gray-50 rounded-lg border border-gray-200 p-8 text-center">
<p class="text-gray-400 text-sm">No active policy overlays.</p>
</div>
|]
else [hsx|
<div class="space-y-4">
{forEach overlays renderOverlayRow}
</div>
|]}
<div class="mt-8 bg-white rounded-lg border border-gray-200 p-6">
<h2 class="text-lg font-medium text-gray-800 mb-4">Overall Coverage</h2>
<div class="flex items-center gap-6">
<div class="text-center">
<div class="text-3xl font-bold text-gray-900">{show totalDecisions}</div>
<div class="text-xs text-gray-500 mt-1">Total Decisions</div>
</div>
<div class="text-center">
<div class="text-3xl font-bold text-green-600">{show coveredDecisions}</div>
<div class="text-xs text-gray-500 mt-1">With Policy Ref</div>
</div>
<div class="text-center">
<div class="text-3xl font-bold text-indigo-600">{coveragePct}%</div>
<div class="text-xs text-gray-500 mt-1">Coverage</div>
</div>
</div>
</div>
|]
where
decisionIdsWithPolicy = map (.requirementId) policies |> catMaybes |> map show
coveredDecisions = length $ filter (\d -> show d.id `elem` decisionIdsWithPolicy) decisions
totalDecisions = length decisions
coveragePct :: Int
coveragePct = if totalDecisions == 0 then 0
else (coveredDecisions * 100) `div` totalDecisions
renderOverlayRow :: FederatedPolicyOverlay -> Html
renderOverlayRow o = [hsx|
<div class="bg-white rounded-lg border border-gray-200 p-5">
<div class="flex items-start justify-between">
<div>
<h3 class="font-medium text-gray-800">{o.title}</h3>
<p class="text-xs text-gray-500 mt-1">
Enforced from: {maybe "" show o.enforcedFrom}
</p>
</div>
<span class="text-xs bg-green-100 text-green-700 px-2 py-0.5 rounded font-medium">
active
</span>
</div>
</div>
|]

View File

@@ -0,0 +1,70 @@
module Web.View.FederatedPolicyOverlays.Show where
import Web.Types
import Generated.Types
import IHP.Prelude
import IHP.ViewPrelude
import Web.View.FederatedPolicyOverlays.Index (statusBadge)
data ShowView = ShowView
{ overlay :: !FederatedPolicyOverlay
, hubs :: ![Hub]
}
instance View ShowView where
html ShowView { .. } = [hsx|
<div class="max-w-3xl">
<div class="flex items-center gap-3 mb-6">
<a href={FederatedPolicyOverlaysAction} class="text-sm text-gray-500 hover:underline">Policies</a>
<span class="text-gray-300">/</span>
<h1 class="text-2xl font-semibold">{overlay.title}</h1>
<span class={statusBadge overlay.status <> " text-sm px-2 py-0.5 rounded font-medium"}>
{overlay.status}
</span>
</div>
<div class="bg-white rounded-lg border border-gray-200 p-6 space-y-6">
<div>
<h2 class="text-sm font-medium text-gray-500 mb-2">Policy Text</h2>
<div class="bg-gray-50 rounded p-4 text-sm text-gray-800 whitespace-pre-wrap">
{overlay.policyText}
</div>
</div>
<dl class="grid grid-cols-2 gap-4 text-sm">
<div>
<dt class="text-gray-500">Enforced From</dt>
<dd>{maybe "" show overlay.enforcedFrom}</dd>
</div>
<div>
<dt class="text-gray-500">Created</dt>
<dd>{show overlay.createdAt}</dd>
</div>
{whenJust overlay.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">
{if overlay.status == "draft"
then [hsx|
<a href={EditFederatedPolicyOverlayAction { federatedPolicyOverlayId = overlay.id }}
class="text-sm text-blue-600 hover:underline">Edit</a>
<a href={ActivateFederatedPolicyAction { federatedPolicyOverlayId = overlay.id }}
class="text-sm text-green-600 hover:underline">Activate</a>
|]
else mempty}
{if overlay.status == "active"
then [hsx|
<a href={RetireFederatedPolicyAction { federatedPolicyOverlayId = overlay.id }}
class="text-sm text-red-600 hover:underline"
onclick="return confirm('Retire this policy overlay?')">Retire</a>
|]
else mempty}
</div>
</div>
|]