Files
inter-hub/Application/Helper/RoutingEngine.hs
Bernd Worsch 9265ca2d9c 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

43 lines
1.7 KiB
Haskell

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)