inter-hub-haskell/Application/Helper/RoutingEngine.hs

43 lines
1.7 KiB
Haskell
Raw Normal View History

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>
2026-03-29 22:53:01 +00:00
module Application.Helper.RoutingEngine where
import IHP.Prelude
import IHP.ModelSupport
import Generated.Types
-- | Apply active routing rules to a RequirementCandidate.
-- Finds the highest-priority matching active rule for the candidate's hub
-- and sets routed_to_hub_id. Returns the updated candidate.
applyRoutingRules
:: (?modelContext :: ModelContext)
=> RequirementCandidate
-> [Widget] -- to resolve widget_type for the source widget
-> IO RequirementCandidate
applyRoutingRules candidate widgets = do
rules <- query @HubRoutingRule
|> filterWhere (#status, "active")
|> orderByDesc #priority
|> fetch
-- Find the hub of the source widget
let mWidget = find (\w -> w.id == candidate.sourceWidgetId) widgets
widgetType = maybe Nothing (\w -> Just w.widgetType) mWidget
let matchingRule = find (ruleMatches candidate.category widgetType) rules
case matchingRule of
Nothing -> pure candidate
Just rule -> do
candidate
|> set #routedToHubId (Just rule.targetHubId)
|> updateRecord
-- | A rule matches if:
-- - source hub matches candidate's source widget's hub
-- - match_category is null OR equals candidate category
-- - match_widget_type is null OR equals widget type
ruleMatches :: Text -> Maybe Text -> HubRoutingRule -> Bool
ruleMatches category mWidgetType rule =
categoryMatch && widgetTypeMatch
where
categoryMatch = isNothing rule.matchCategory
|| rule.matchCategory == Just category
widgetTypeMatch = isNothing rule.matchWidgetType
|| (isJust mWidgetType && rule.matchWidgetType == mWidgetType)