feat(T02-T11): IHF Phase 1 schema, controllers, views, and helpers
- Schema: hubs, widgets, widget_versions, interaction_events (append-only
trigger), annotations, users — single migration file
- Web layer: Types, Routes, FrontController with auth + AutoRefresh layout
- Controllers: Hubs (CRUD), Widgets (CRUD + versioning), InteractionEvents
(JSON capture, canonical event_type validation), Annotations (threaded,
append-only)
- Sessions controller for IHP auth
- Views: Hubs (index/show/new/edit), Widgets (index/show/new/edit),
Annotations (index/new), Sessions (login)
- widgetEnvelope helper with full data-* governance attributes
- Integration tests: Hub CRUD, Widget versioning, event capture, append-only
guard, annotation threading, validation
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-27 01:42:43 +00:00
|
|
|
module Web.Types where
|
|
|
|
|
|
|
|
|
|
import IHP.Prelude
|
|
|
|
|
import IHP.ModelSupport
|
|
|
|
|
import IHP.LoginSupport.Types
|
|
|
|
|
import Generated.Types
|
|
|
|
|
|
|
|
|
|
-- | Authentication type alias
|
|
|
|
|
type CurrentUserRecord = User
|
|
|
|
|
|
|
|
|
|
instance HasNewSessionUrl User where
|
|
|
|
|
newSessionUrl _ = "/NewSession"
|
|
|
|
|
|
|
|
|
|
-- Controllers
|
|
|
|
|
|
|
|
|
|
data WebApplication = WebApplication deriving (Eq, Show)
|
|
|
|
|
|
|
|
|
|
data HubsController
|
|
|
|
|
= HubsAction
|
|
|
|
|
| NewHubAction
|
2026-03-29 10:38:50 +00:00
|
|
|
| ShowHubAction { hubId :: !(Id Hub) }
|
feat(T02-T11): IHF Phase 1 schema, controllers, views, and helpers
- Schema: hubs, widgets, widget_versions, interaction_events (append-only
trigger), annotations, users — single migration file
- Web layer: Types, Routes, FrontController with auth + AutoRefresh layout
- Controllers: Hubs (CRUD), Widgets (CRUD + versioning), InteractionEvents
(JSON capture, canonical event_type validation), Annotations (threaded,
append-only)
- Sessions controller for IHP auth
- Views: Hubs (index/show/new/edit), Widgets (index/show/new/edit),
Annotations (index/new), Sessions (login)
- widgetEnvelope helper with full data-* governance attributes
- Integration tests: Hub CRUD, Widget versioning, event capture, append-only
guard, annotation threading, validation
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-27 01:42:43 +00:00
|
|
|
| CreateHubAction
|
2026-03-29 10:38:50 +00:00
|
|
|
| EditHubAction { hubId :: !(Id Hub) }
|
|
|
|
|
| UpdateHubAction { hubId :: !(Id Hub) }
|
|
|
|
|
| DeleteHubAction { hubId :: !(Id Hub) }
|
2026-03-29 12:27:30 +00:00
|
|
|
| TriageDashboardAction { hubId :: !(Id Hub) }
|
|
|
|
|
| GovernanceDashboardAction { hubId :: !(Id Hub) }
|
|
|
|
|
| AntifragilityDashboardAction { hubId :: !(Id Hub) }
|
2026-03-29 21:03:00 +00:00
|
|
|
| AgentAuditDashboardAction { hubId :: !(Id Hub) }
|
|
|
|
|
| AdapterCompatibilityDashboardAction { hubId :: !(Id Hub) }
|
feat(P7): IHF Phase 7 complete — advanced observability and operational integration
T01 schema: friction_scores, bottleneck_records, hub_health_snapshots,
cross_hub_propagations + migration 1743552000.
T02 Widget Pain Heatmap: computeFrictionScore (formula documented), RecomputeFriction
action, colour-coded grid view (green/yellow/amber/red).
T03 Workflow Bottleneck Analysis: detectBottlenecks across 4 pipeline stages
(candidate 30d, requirement 60d, decision 30d, observation 14d), idempotent,
severity from age ratio, resolve action.
T04 Hub Health Correlation: computeHubHealth (deduction table documented),
append-only HubHealthSnapshot, health history view, badge on hub Show page.
T05 Cross-Hub Propagation: annotation_cluster + widget_type_friction heuristics,
idempotent detection, acknowledge/resolve lifecycle.
T06 Operational Review Board: 4-panel AutoRefresh global dashboard — health matrix,
top-10 friction, bottleneck stage counts, open propagations.
T07 gate: 5 describe blocks in Test/Integration.hs; SCOPE.md updated Phase 7
complete; docs/phase7-summary.md written.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-29 21:49:22 +00:00
|
|
|
| FrictionHeatmapAction { hubId :: !(Id Hub) }
|
|
|
|
|
| RecomputeFrictionAction { hubId :: !(Id Hub) }
|
|
|
|
|
| BottleneckDashboardAction { hubId :: !(Id Hub) }
|
|
|
|
|
| DetectBottlenecksAction { hubId :: !(Id Hub) }
|
|
|
|
|
| ResolveBottleneckAction { bottleneckRecordId :: !(Id BottleneckRecord) }
|
|
|
|
|
| SnapshotHubHealthAction { hubId :: !(Id Hub) }
|
|
|
|
|
| HubHealthHistoryAction { hubId :: !(Id Hub) }
|
|
|
|
|
| OperationalReviewBoardAction
|
feat(T02-T11): IHF Phase 1 schema, controllers, views, and helpers
- Schema: hubs, widgets, widget_versions, interaction_events (append-only
trigger), annotations, users — single migration file
- Web layer: Types, Routes, FrontController with auth + AutoRefresh layout
- Controllers: Hubs (CRUD), Widgets (CRUD + versioning), InteractionEvents
(JSON capture, canonical event_type validation), Annotations (threaded,
append-only)
- Sessions controller for IHP auth
- Views: Hubs (index/show/new/edit), Widgets (index/show/new/edit),
Annotations (index/new), Sessions (login)
- widgetEnvelope helper with full data-* governance attributes
- Integration tests: Hub CRUD, Widget versioning, event capture, append-only
guard, annotation threading, validation
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-27 01:42:43 +00:00
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data WidgetsController
|
|
|
|
|
= WidgetsAction
|
|
|
|
|
| NewWidgetAction
|
|
|
|
|
| ShowWidgetAction { widgetId :: !(Id Widget) }
|
|
|
|
|
| CreateWidgetAction
|
feat(P5): IHF Phase 5 complete — agent-assisted distillation
Adds bounded AI support to the IHF governance loop. All AI outputs are
attributed (model_ref), reviewable (AgentReviewRecord), and reversible.
No autonomous decisions; no silent requirement promotion.
- T01: Schema — agent_proposals, agent_review_records,
confidence_annotations (migration 1743379200)
- T02: AgentProposalsController (index/show/accept/reject, idempotent
review guard), global nav "Agent" link
- T03: SummarizeClusterAction — Claude API cluster summary on widget show
- T04: DraftRequirementAction — AI requirement draft; acceptance creates
RequirementCandidate (human-gated)
- T05: DetectDuplicatesAction — duplicate_flag proposal on candidate show
- T06: DetectPolicySensitivityAction — policy_flag with
ConfidenceAnnotations per concern scope
- T07: ProposeImplementationAction — impl_proposal from decision show
- T08: AgentAuditDashboardAction — autoRefresh; KPI row, unreviewed queue,
recent proposals, attribution log matrix
- T09: integration tests, SCOPE.md updated, phase5-summary.md, flake.nix
adds http-conduit/aeson/string-conversions
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-29 15:54:33 +00:00
|
|
|
| EditWidgetAction { widgetId :: !(Id Widget) }
|
|
|
|
|
| UpdateWidgetAction { widgetId :: !(Id Widget) }
|
|
|
|
|
| SummarizeClusterAction { widgetId :: !(Id Widget) }
|
|
|
|
|
| DraftRequirementAction { widgetId :: !(Id Widget) }
|
feat(T02-T11): IHF Phase 1 schema, controllers, views, and helpers
- Schema: hubs, widgets, widget_versions, interaction_events (append-only
trigger), annotations, users — single migration file
- Web layer: Types, Routes, FrontController with auth + AutoRefresh layout
- Controllers: Hubs (CRUD), Widgets (CRUD + versioning), InteractionEvents
(JSON capture, canonical event_type validation), Annotations (threaded,
append-only)
- Sessions controller for IHP auth
- Views: Hubs (index/show/new/edit), Widgets (index/show/new/edit),
Annotations (index/new), Sessions (login)
- widgetEnvelope helper with full data-* governance attributes
- Integration tests: Hub CRUD, Widget versioning, event capture, append-only
guard, annotation threading, validation
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-27 01:42:43 +00:00
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data InteractionEventsController
|
|
|
|
|
= CreateInteractionEventAction { widgetId :: !(Id Widget) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data AnnotationsController
|
feat(P2+P3): IHF Phase 2 complete; register Phase 3 workplan
Phase 2 — Structured Feedback and Triage (IHUB-WP-0002):
- Schema: annotation_threads, requirement_candidates, triage_states,
reviewer_assignments; annotations extended with severity + thread_id
- AnnotationThreadsController: create threads, assign annotations
- RequirementCandidatesController: CRUD, escalation, triage lifecycle,
reviewer assignment, my-queue
- Annotation severity (low/medium/high/critical) with Tailwind color cues
- TriageDashboardAction on HubsController with autoRefresh
- Integration tests (T01–T09), SCOPE.md updated, docs/phase2-summary.md
Phase 3 — Governance and Decision Linkage (IHUB-WP-0003):
- Workplan registered: 9 tasks, State Hub workstream 5f201ee3
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-28 23:37:34 +00:00
|
|
|
= WidgetAnnotationsAction { widgetId :: !(Id Widget) }
|
|
|
|
|
| ShowAnnotationAction { annotationId :: !(Id Annotation) }
|
|
|
|
|
| NewAnnotationAction { widgetId :: !(Id Widget) }
|
|
|
|
|
| CreateAnnotationAction { widgetId :: !(Id Widget) }
|
|
|
|
|
| EscalateAnnotationAction { annotationId :: !(Id Annotation) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data AnnotationThreadsController
|
|
|
|
|
= WidgetAnnotationThreadsAction { widgetId :: !(Id Widget) }
|
|
|
|
|
| ShowAnnotationThreadAction { annotationThreadId :: !(Id AnnotationThread) }
|
|
|
|
|
| NewAnnotationThreadAction { widgetId :: !(Id Widget) }
|
|
|
|
|
| CreateAnnotationThreadAction { widgetId :: !(Id Widget) }
|
|
|
|
|
| AssignAnnotationToThreadAction { annotationId :: !(Id Annotation) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data RequirementCandidatesController
|
|
|
|
|
= RequirementCandidatesAction
|
|
|
|
|
| ShowRequirementCandidateAction { requirementCandidateId :: !(Id RequirementCandidate) }
|
|
|
|
|
| NewRequirementCandidateAction
|
|
|
|
|
| CreateRequirementCandidateAction
|
|
|
|
|
| EditRequirementCandidateAction { requirementCandidateId :: !(Id RequirementCandidate) }
|
|
|
|
|
| UpdateRequirementCandidateAction { requirementCandidateId :: !(Id RequirementCandidate) }
|
|
|
|
|
| UpdateTriageStatusAction { requirementCandidateId :: !(Id RequirementCandidate) }
|
|
|
|
|
| AssignReviewerAction { requirementCandidateId :: !(Id RequirementCandidate) }
|
|
|
|
|
| MyQueueAction
|
feat(P5): IHF Phase 5 complete — agent-assisted distillation
Adds bounded AI support to the IHF governance loop. All AI outputs are
attributed (model_ref), reviewable (AgentReviewRecord), and reversible.
No autonomous decisions; no silent requirement promotion.
- T01: Schema — agent_proposals, agent_review_records,
confidence_annotations (migration 1743379200)
- T02: AgentProposalsController (index/show/accept/reject, idempotent
review guard), global nav "Agent" link
- T03: SummarizeClusterAction — Claude API cluster summary on widget show
- T04: DraftRequirementAction — AI requirement draft; acceptance creates
RequirementCandidate (human-gated)
- T05: DetectDuplicatesAction — duplicate_flag proposal on candidate show
- T06: DetectPolicySensitivityAction — policy_flag with
ConfidenceAnnotations per concern scope
- T07: ProposeImplementationAction — impl_proposal from decision show
- T08: AgentAuditDashboardAction — autoRefresh; KPI row, unreviewed queue,
recent proposals, attribution log matrix
- T09: integration tests, SCOPE.md updated, phase5-summary.md, flake.nix
adds http-conduit/aeson/string-conversions
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-29 15:54:33 +00:00
|
|
|
| PromoteToRequirementAction { requirementCandidateId :: !(Id RequirementCandidate) }
|
|
|
|
|
| LinkToDecisionAction { requirementCandidateId :: !(Id RequirementCandidate) }
|
|
|
|
|
| DetectDuplicatesAction { requirementCandidateId :: !(Id RequirementCandidate) }
|
|
|
|
|
| DetectPolicySensitivityAction { requirementCandidateId :: !(Id RequirementCandidate) }
|
2026-03-29 10:38:50 +00:00
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data RequirementsController
|
|
|
|
|
= RequirementsAction
|
|
|
|
|
| ShowRequirementAction { requirementId :: !(Id Requirement) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data DecisionRecordsController
|
|
|
|
|
= DecisionRecordsAction
|
|
|
|
|
| ShowDecisionRecordAction { decisionRecordId :: !(Id DecisionRecord) }
|
|
|
|
|
| NewDecisionRecordAction
|
|
|
|
|
| CreateDecisionRecordAction
|
|
|
|
|
| EditDecisionRecordAction { decisionRecordId :: !(Id DecisionRecord) }
|
|
|
|
|
| UpdateDecisionRecordAction { decisionRecordId :: !(Id DecisionRecord) }
|
|
|
|
|
| AddPolicyReferenceAction { decisionRecordId :: !(Id DecisionRecord) }
|
|
|
|
|
| DeletePolicyReferenceAction { policyReferenceId :: !(Id PolicyReference) }
|
|
|
|
|
| AddImplementationRefAction { decisionRecordId :: !(Id DecisionRecord) }
|
|
|
|
|
| DeleteImplementationRefAction { implementationChangeReferenceId :: !(Id ImplementationChangeReference) }
|
feat(P5): IHF Phase 5 complete — agent-assisted distillation
Adds bounded AI support to the IHF governance loop. All AI outputs are
attributed (model_ref), reviewable (AgentReviewRecord), and reversible.
No autonomous decisions; no silent requirement promotion.
- T01: Schema — agent_proposals, agent_review_records,
confidence_annotations (migration 1743379200)
- T02: AgentProposalsController (index/show/accept/reject, idempotent
review guard), global nav "Agent" link
- T03: SummarizeClusterAction — Claude API cluster summary on widget show
- T04: DraftRequirementAction — AI requirement draft; acceptance creates
RequirementCandidate (human-gated)
- T05: DetectDuplicatesAction — duplicate_flag proposal on candidate show
- T06: DetectPolicySensitivityAction — policy_flag with
ConfidenceAnnotations per concern scope
- T07: ProposeImplementationAction — impl_proposal from decision show
- T08: AgentAuditDashboardAction — autoRefresh; KPI row, unreviewed queue,
recent proposals, attribution log matrix
- T09: integration tests, SCOPE.md updated, phase5-summary.md, flake.nix
adds http-conduit/aeson/string-conversions
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-29 15:54:33 +00:00
|
|
|
| ProposeImplementationAction { decisionRecordId :: !(Id DecisionRecord) }
|
feat(T02-T11): IHF Phase 1 schema, controllers, views, and helpers
- Schema: hubs, widgets, widget_versions, interaction_events (append-only
trigger), annotations, users — single migration file
- Web layer: Types, Routes, FrontController with auth + AutoRefresh layout
- Controllers: Hubs (CRUD), Widgets (CRUD + versioning), InteractionEvents
(JSON capture, canonical event_type validation), Annotations (threaded,
append-only)
- Sessions controller for IHP auth
- Views: Hubs (index/show/new/edit), Widgets (index/show/new/edit),
Annotations (index/new), Sessions (login)
- widgetEnvelope helper with full data-* governance attributes
- Integration tests: Hub CRUD, Widget versioning, event capture, append-only
guard, annotation threading, validation
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-27 01:42:43 +00:00
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
2026-03-29 12:27:30 +00:00
|
|
|
data DeploymentRecordsController
|
|
|
|
|
= DeploymentRecordsAction
|
|
|
|
|
| ShowDeploymentRecordAction { deploymentRecordId :: !(Id DeploymentRecord) }
|
|
|
|
|
| NewDeploymentRecordAction
|
|
|
|
|
| CreateDeploymentRecordAction
|
|
|
|
|
| RecordOutcomeSignalAction { deploymentRecordId :: !(Id DeploymentRecord) }
|
|
|
|
|
| EvaluateChangeAction { deploymentRecordId :: !(Id DeploymentRecord) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
feat(P5): IHF Phase 5 complete — agent-assisted distillation
Adds bounded AI support to the IHF governance loop. All AI outputs are
attributed (model_ref), reviewable (AgentReviewRecord), and reversible.
No autonomous decisions; no silent requirement promotion.
- T01: Schema — agent_proposals, agent_review_records,
confidence_annotations (migration 1743379200)
- T02: AgentProposalsController (index/show/accept/reject, idempotent
review guard), global nav "Agent" link
- T03: SummarizeClusterAction — Claude API cluster summary on widget show
- T04: DraftRequirementAction — AI requirement draft; acceptance creates
RequirementCandidate (human-gated)
- T05: DetectDuplicatesAction — duplicate_flag proposal on candidate show
- T06: DetectPolicySensitivityAction — policy_flag with
ConfidenceAnnotations per concern scope
- T07: ProposeImplementationAction — impl_proposal from decision show
- T08: AgentAuditDashboardAction — autoRefresh; KPI row, unreviewed queue,
recent proposals, attribution log matrix
- T09: integration tests, SCOPE.md updated, phase5-summary.md, flake.nix
adds http-conduit/aeson/string-conversions
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-29 15:54:33 +00:00
|
|
|
data AgentProposalsController
|
|
|
|
|
= AgentProposalsAction
|
|
|
|
|
| ShowAgentProposalAction { agentProposalId :: !(Id AgentProposal) }
|
|
|
|
|
| AcceptProposalAction { agentProposalId :: !(Id AgentProposal) }
|
|
|
|
|
| RejectProposalAction { agentProposalId :: !(Id AgentProposal) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
2026-03-29 21:11:03 +00:00
|
|
|
|
|
|
|
|
data ApiInteractionEventsController
|
|
|
|
|
= CreateApiInteractionEventAction
|
|
|
|
|
deriving (Eq, Show, Data)
|
feat(P5): IHF Phase 5 complete — agent-assisted distillation
Adds bounded AI support to the IHF governance loop. All AI outputs are
attributed (model_ref), reviewable (AgentReviewRecord), and reversible.
No autonomous decisions; no silent requirement promotion.
- T01: Schema — agent_proposals, agent_review_records,
confidence_annotations (migration 1743379200)
- T02: AgentProposalsController (index/show/accept/reject, idempotent
review guard), global nav "Agent" link
- T03: SummarizeClusterAction — Claude API cluster summary on widget show
- T04: DraftRequirementAction — AI requirement draft; acceptance creates
RequirementCandidate (human-gated)
- T05: DetectDuplicatesAction — duplicate_flag proposal on candidate show
- T06: DetectPolicySensitivityAction — policy_flag with
ConfidenceAnnotations per concern scope
- T07: ProposeImplementationAction — impl_proposal from decision show
- T08: AgentAuditDashboardAction — autoRefresh; KPI row, unreviewed queue,
recent proposals, attribution log matrix
- T09: integration tests, SCOPE.md updated, phase5-summary.md, flake.nix
adds http-conduit/aeson/string-conversions
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-29 15:54:33 +00:00
|
|
|
|
2026-03-29 21:03:00 +00:00
|
|
|
data EnvelopeEmissionContractsController
|
|
|
|
|
= EnvelopeEmissionContractsAction
|
|
|
|
|
| ShowEnvelopeEmissionContractAction { envelopeEmissionContractId :: !(Id EnvelopeEmissionContract) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data InteractionReportingContractsController
|
|
|
|
|
= InteractionReportingContractsAction
|
|
|
|
|
| ShowInteractionReportingContractAction { interactionReportingContractId :: !(Id InteractionReportingContract) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data WidgetAdapterSpecsController
|
|
|
|
|
= WidgetAdapterSpecsAction
|
|
|
|
|
| ShowWidgetAdapterSpecAction { widgetAdapterSpecId :: !(Id WidgetAdapterSpec) }
|
|
|
|
|
| NewWidgetAdapterSpecAction
|
|
|
|
|
| CreateWidgetAdapterSpecAction
|
|
|
|
|
| EditWidgetAdapterSpecAction { widgetAdapterSpecId :: !(Id WidgetAdapterSpec) }
|
|
|
|
|
| UpdateWidgetAdapterSpecAction { widgetAdapterSpecId :: !(Id WidgetAdapterSpec) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
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
|
|
|
-- Phase 8: Federated Hub Maturity
|
|
|
|
|
|
|
|
|
|
data WidgetOwnershipsController
|
|
|
|
|
= WidgetOwnershipsAction
|
|
|
|
|
| ShowWidgetOwnershipAction { widgetOwnershipId :: !(Id WidgetOwnership) }
|
|
|
|
|
| NewWidgetOwnershipAction
|
|
|
|
|
| CreateWidgetOwnershipAction
|
|
|
|
|
| EditWidgetOwnershipAction { widgetOwnershipId :: !(Id WidgetOwnership) }
|
|
|
|
|
| UpdateWidgetOwnershipAction { widgetOwnershipId :: !(Id WidgetOwnership) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data HubRoutingRulesController
|
|
|
|
|
= HubRoutingRulesAction
|
|
|
|
|
| ShowHubRoutingRuleAction { hubRoutingRuleId :: !(Id HubRoutingRule) }
|
|
|
|
|
| NewHubRoutingRuleAction
|
|
|
|
|
| CreateHubRoutingRuleAction
|
|
|
|
|
| EditHubRoutingRuleAction { hubRoutingRuleId :: !(Id HubRoutingRule) }
|
|
|
|
|
| UpdateHubRoutingRuleAction { hubRoutingRuleId :: !(Id HubRoutingRule) }
|
|
|
|
|
| ActivateRoutingRuleAction { hubRoutingRuleId :: !(Id HubRoutingRule) }
|
|
|
|
|
| DeactivateRoutingRuleAction { hubRoutingRuleId :: !(Id HubRoutingRule) }
|
|
|
|
|
| RoutedCandidatesAction { hubId :: !(Id Hub) }
|
|
|
|
|
| RouteNowAction { requirementCandidateId :: !(Id RequirementCandidate) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data FederatedPolicyOverlaysController
|
|
|
|
|
= FederatedPolicyOverlaysAction
|
|
|
|
|
| ShowFederatedPolicyOverlayAction { federatedPolicyOverlayId :: !(Id FederatedPolicyOverlay) }
|
|
|
|
|
| NewFederatedPolicyOverlayAction
|
|
|
|
|
| CreateFederatedPolicyOverlayAction
|
|
|
|
|
| EditFederatedPolicyOverlayAction { federatedPolicyOverlayId :: !(Id FederatedPolicyOverlay) }
|
|
|
|
|
| UpdateFederatedPolicyOverlayAction { federatedPolicyOverlayId :: !(Id FederatedPolicyOverlay) }
|
|
|
|
|
| ActivateFederatedPolicyAction { federatedPolicyOverlayId :: !(Id FederatedPolicyOverlay) }
|
|
|
|
|
| RetireFederatedPolicyAction { federatedPolicyOverlayId :: !(Id FederatedPolicyOverlay) }
|
|
|
|
|
| PolicyComplianceDashboardAction
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data StewardshipRolesController
|
|
|
|
|
= StewardshipRolesAction
|
|
|
|
|
| ShowStewardshipRoleAction { stewardshipRoleId :: !(Id StewardshipRole) }
|
|
|
|
|
| NewStewardshipRoleAction
|
|
|
|
|
| CreateStewardshipRoleAction
|
|
|
|
|
| RevokeRoleAction { stewardshipRoleId :: !(Id StewardshipRole) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data ArchiveRecordsController
|
|
|
|
|
= ArchiveRecordsAction
|
|
|
|
|
| ShowArchiveRecordAction { archiveRecordId :: !(Id ArchiveRecord) }
|
|
|
|
|
| ArchiveWidgetAction { widgetId :: !(Id Widget) }
|
|
|
|
|
| LineageInspectorAction { widgetId :: !(Id Widget) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data FederatedGovernanceController
|
|
|
|
|
= FederatedGovernanceDashboardAction
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
feat(P7): IHF Phase 7 complete — advanced observability and operational integration
T01 schema: friction_scores, bottleneck_records, hub_health_snapshots,
cross_hub_propagations + migration 1743552000.
T02 Widget Pain Heatmap: computeFrictionScore (formula documented), RecomputeFriction
action, colour-coded grid view (green/yellow/amber/red).
T03 Workflow Bottleneck Analysis: detectBottlenecks across 4 pipeline stages
(candidate 30d, requirement 60d, decision 30d, observation 14d), idempotent,
severity from age ratio, resolve action.
T04 Hub Health Correlation: computeHubHealth (deduction table documented),
append-only HubHealthSnapshot, health history view, badge on hub Show page.
T05 Cross-Hub Propagation: annotation_cluster + widget_type_friction heuristics,
idempotent detection, acknowledge/resolve lifecycle.
T06 Operational Review Board: 4-panel AutoRefresh global dashboard — health matrix,
top-10 friction, bottleneck stage counts, open propagations.
T07 gate: 5 describe blocks in Test/Integration.hs; SCOPE.md updated Phase 7
complete; docs/phase7-summary.md written.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-29 21:49:22 +00:00
|
|
|
data CrossHubPropagationsController
|
|
|
|
|
= CrossHubPropagationsAction
|
|
|
|
|
| DetectPropagationsAction
|
|
|
|
|
| AcknowledgePropagationAction { crossHubPropagationId :: !(Id CrossHubPropagation) }
|
|
|
|
|
| ResolvePropagationAction { crossHubPropagationId :: !(Id CrossHubPropagation) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
feat(WP-0009): IHF GAAF Compliance Foundation — type registries, extension manifests, architectural contracts
Implements IHUB-WP-0009: closes four GAAF-2026 gaps before domain hub work begins.
- TypeRegistry helper + controllers/views (hub_kind, hub_capability_manifest)
- HubCapabilityManifest entity with validation and registry linkage
- ARCHITECTURE-LAYERS.md + CI-enforced boundary contracts
- Alembic migration 1743724800, fitness tests (Test/Architecture/)
- GAAF spec, Operational Architecture spec, domain hub extension guide
- Updates to CLAUDE.md, SCOPE.md, Schema.sql, Routes, FrontController, Types
state_hub_sync: pending (tunnel was STALE at completion time; run fix-consistency)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-31 21:17:39 +00:00
|
|
|
-- GAAF Compliance Foundation (IHUB-WP-0009)
|
|
|
|
|
|
|
|
|
|
data TypeRegistriesController
|
|
|
|
|
= WidgetTypeRegistryAction
|
|
|
|
|
| ShowWidgetTypeAction { widgetTypeRegistryId :: !(Id WidgetTypeRegistry) }
|
|
|
|
|
| NewWidgetTypeAction
|
|
|
|
|
| CreateWidgetTypeAction
|
|
|
|
|
| EditWidgetTypeAction { widgetTypeRegistryId :: !(Id WidgetTypeRegistry) }
|
|
|
|
|
| UpdateWidgetTypeAction { widgetTypeRegistryId :: !(Id WidgetTypeRegistry) }
|
|
|
|
|
| DeprecateWidgetTypeAction { widgetTypeRegistryId :: !(Id WidgetTypeRegistry) }
|
|
|
|
|
| EventTypeRegistryAction
|
|
|
|
|
| ShowEventTypeAction { eventTypeRegistryId :: !(Id EventTypeRegistry) }
|
|
|
|
|
| NewEventTypeAction
|
|
|
|
|
| CreateEventTypeAction
|
|
|
|
|
| EditEventTypeAction { eventTypeRegistryId :: !(Id EventTypeRegistry) }
|
|
|
|
|
| UpdateEventTypeAction { eventTypeRegistryId :: !(Id EventTypeRegistry) }
|
|
|
|
|
| DeprecateEventTypeAction { eventTypeRegistryId :: !(Id EventTypeRegistry) }
|
|
|
|
|
| AnnotationCategoryRegistryAction
|
|
|
|
|
| ShowAnnotationCategoryAction { annotationCategoryRegistryId :: !(Id AnnotationCategoryRegistry) }
|
|
|
|
|
| NewAnnotationCategoryAction
|
|
|
|
|
| CreateAnnotationCategoryAction
|
|
|
|
|
| EditAnnotationCategoryAction { annotationCategoryRegistryId :: !(Id AnnotationCategoryRegistry) }
|
|
|
|
|
| UpdateAnnotationCategoryAction { annotationCategoryRegistryId :: !(Id AnnotationCategoryRegistry) }
|
|
|
|
|
| DeprecateAnnotationCategoryAction { annotationCategoryRegistryId :: !(Id AnnotationCategoryRegistry) }
|
|
|
|
|
| PolicyScopeRegistryAction
|
|
|
|
|
| ShowPolicyScopeAction { policyScopeRegistryId :: !(Id PolicyScopeRegistry) }
|
|
|
|
|
| NewPolicyScopeAction
|
|
|
|
|
| CreatePolicyScopeAction
|
|
|
|
|
| EditPolicyScopeAction { policyScopeRegistryId :: !(Id PolicyScopeRegistry) }
|
|
|
|
|
| UpdatePolicyScopeAction { policyScopeRegistryId :: !(Id PolicyScopeRegistry) }
|
|
|
|
|
| DeprecatePolicyScopeAction { policyScopeRegistryId :: !(Id PolicyScopeRegistry) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data HubCapabilityManifestsController
|
|
|
|
|
= HubCapabilityManifestsAction
|
|
|
|
|
| ShowHubCapabilityManifestAction { hubCapabilityManifestId :: !(Id HubCapabilityManifest) }
|
|
|
|
|
| NewHubCapabilityManifestAction
|
|
|
|
|
| CreateHubCapabilityManifestAction
|
|
|
|
|
| EditHubCapabilityManifestAction { hubCapabilityManifestId :: !(Id HubCapabilityManifest) }
|
|
|
|
|
| UpdateHubCapabilityManifestAction { hubCapabilityManifestId :: !(Id HubCapabilityManifest) }
|
|
|
|
|
| ActivateManifestAction { hubCapabilityManifestId :: !(Id HubCapabilityManifest) }
|
|
|
|
|
| RetireManifestAction { hubCapabilityManifestId :: !(Id HubCapabilityManifest) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
feat(WP-0010): IHF Phase 9 — External API Surface and Consumer SDKs
Delivers the full Phase 9 external API layer:
- Versioned REST API (/api/v2/) with OpenAPI 3.1 spec; enum arrays for
widget_type, event_type, annotation category drawn live from registry tables
- OAuth 2.0 client credentials flow (/api/v2/token); hub:*:write scopes
gated on active HubCapabilityManifest FK
- API key management: SHA256-hashed tokens, key_prefix for display,
one-time reveal on creation, revocation support
- TypeScript and Python consumer SDKs generated from registry tables
(/api/v2/sdk/ihf-client.ts, /api/v2/sdk/ihf-client.py)
- Webhook delivery: HMAC-SHA256 signing, append-only webhook_deliveries,
fire-and-forget dispatch via forkIO, 3-retry logic
- Admin API dashboard with 24h stats (request count, error rate, last seen)
- Rate limiting (per-minute) and daily quota enforcement via api_request_log
- Schema migration: api_consumers, api_keys, webhook_subscriptions (CHECK
constraint on 6 framework lifecycle topics), webhook_deliveries
(append-only trigger), api_request_log
- ARCHITECTURE-LAYERS.md scorecard: 3.34 → 3.41 (approaching Strong)
- contracts/functional/interaction-reporting-v1.md extended with Phase 9
endpoint catalogue and 422 validation error format
GAAF: no bare TEXT discriminators; webhook event_type uses CHECK constraint
over 6 allowed framework lifecycle topic strings (not widget event types).
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-01 19:52:20 +00:00
|
|
|
-- Phase 9 — External API Surface (IHUB-WP-0010)
|
|
|
|
|
|
|
|
|
|
data ApiConsumersController
|
|
|
|
|
= ApiConsumersAction
|
|
|
|
|
| NewApiConsumerAction
|
|
|
|
|
| ShowApiConsumerAction { apiConsumerId :: !(Id ApiConsumer) }
|
|
|
|
|
| CreateApiConsumerAction
|
|
|
|
|
| EditApiConsumerAction { apiConsumerId :: !(Id ApiConsumer) }
|
|
|
|
|
| UpdateApiConsumerAction { apiConsumerId :: !(Id ApiConsumer) }
|
|
|
|
|
| DeactivateApiConsumerAction { apiConsumerId :: !(Id ApiConsumer) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data ApiKeysController
|
|
|
|
|
= ApiKeysAction { apiConsumerId :: !(Id ApiConsumer) }
|
|
|
|
|
| NewApiKeyAction { apiConsumerId :: !(Id ApiConsumer) }
|
|
|
|
|
| CreateApiKeyAction
|
|
|
|
|
| RevokeApiKeyAction { apiKeyId :: !(Id ApiKey) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data WebhookSubscriptionsController
|
|
|
|
|
= WebhookSubscriptionsAction { apiConsumerId :: !(Id ApiConsumer) }
|
|
|
|
|
| NewWebhookSubscriptionAction { apiConsumerId :: !(Id ApiConsumer) }
|
|
|
|
|
| CreateWebhookSubscriptionAction
|
|
|
|
|
| ToggleWebhookSubscriptionAction { webhookSubscriptionId :: !(Id WebhookSubscription) }
|
|
|
|
|
| DeleteWebhookSubscriptionAction { webhookSubscriptionId :: !(Id WebhookSubscription) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data ApiDashboardController
|
|
|
|
|
= ShowApiDashboardAction
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
-- /api/v2/ REST controllers
|
|
|
|
|
|
|
|
|
|
data ApiV2WidgetsController
|
|
|
|
|
= ApiV2IndexWidgetsAction
|
|
|
|
|
| ApiV2ShowWidgetAction { widgetId :: !(Id Widget) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data ApiV2InteractionEventsController
|
|
|
|
|
= ApiV2IndexInteractionEventsAction
|
|
|
|
|
| ApiV2ShowInteractionEventAction { interactionEventId :: !(Id InteractionEvent) }
|
|
|
|
|
| ApiV2CreateInteractionEventAction
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data ApiV2AnnotationsController
|
|
|
|
|
= ApiV2IndexAnnotationsAction
|
|
|
|
|
| ApiV2ShowAnnotationAction { annotationId :: !(Id Annotation) }
|
|
|
|
|
| ApiV2CreateAnnotationAction
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data ApiV2RequirementCandidatesController
|
|
|
|
|
= ApiV2IndexRequirementCandidatesAction
|
|
|
|
|
| ApiV2ShowRequirementCandidateAction { requirementCandidateId :: !(Id RequirementCandidate) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data ApiV2DecisionRecordsController
|
|
|
|
|
= ApiV2IndexDecisionRecordsAction
|
|
|
|
|
| ApiV2ShowDecisionRecordAction { decisionRecordId :: !(Id DecisionRecord) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data ApiV2DeploymentRecordsController
|
|
|
|
|
= ApiV2IndexDeploymentRecordsAction
|
|
|
|
|
| ApiV2ShowDeploymentRecordAction { deploymentRecordId :: !(Id DeploymentRecord) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data ApiV2OutcomeSignalsController
|
|
|
|
|
= ApiV2IndexOutcomeSignalsAction
|
|
|
|
|
| ApiV2ShowOutcomeSignalAction { outcomeSignalId :: !(Id OutcomeSignal) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data ApiV2RegistriesController
|
|
|
|
|
= ApiV2ListWidgetTypesAction
|
|
|
|
|
| ApiV2ListEventTypesAction
|
|
|
|
|
| ApiV2ListAnnotationCategoriesAction
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data ApiV2OpenApiController
|
|
|
|
|
= ApiV2OpenApiJsonAction
|
|
|
|
|
| ApiV2OpenApiYamlAction
|
|
|
|
|
| ApiV2DocsAction
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data ApiV2TokenController
|
|
|
|
|
= ApiV2CreateTokenAction
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data ApiV2SdkController
|
|
|
|
|
= ApiV2SdkIndexAction
|
|
|
|
|
| ApiV2SdkTsAction
|
|
|
|
|
| ApiV2SdkPyAction
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
feat(WP-0011): IHF Phase 10 — Hub Registry and Widget Marketplace
Delivers the hub registry discovery UI, widget pattern library,
governance template library, and marketplace dashboard.
Key changes:
- Schema: widget_patterns (widget_type FK to registry), widget_pattern_versions,
pattern_adoptions, governance_templates (categories JSONB, validated at
controller), governance_template_clones — all GAAF-compliant, no bare TEXT
type discriminators
- Migration: 1743897600-ihf-phase10-hub-registry.sql
- HubRegistry controller + views: browsable view over hub_capability_manifests,
hub_health_snapshots, hubs with per-hub GAAF compliance indicator
- WidgetPatterns controller + views: publish, version, adopt; adoption
triggers manifest amendment draft when new types are introduced
- GovernanceTemplates controller + views: CRUD, clone with category
validation against annotation_category_registry
- MarketplaceDashboard controller + view: full-text search, widget-type
filter, sort, trending panel, autoRefresh
- API v2: /api/v2/hub-registry, /api/v2/widget-patterns (+ adopt endpoint)
- OpenAPI spec updated with Phase 10 paths
- GAAF scorecard: Customization 2.5 → 3.2; overall 3.41 → 3.56 (Strong)
- CLAUDE.md: Phase 10 complete; active workplan → Phase 11
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-01 20:14:43 +00:00
|
|
|
-- Phase 10 — Hub Registry and Widget Marketplace (IHUB-WP-0011)
|
|
|
|
|
|
|
|
|
|
data HubRegistryController
|
|
|
|
|
= HubRegistryAction
|
|
|
|
|
| ShowHubRegistryAction { hubId :: !(Id Hub) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data WidgetPatternsController
|
|
|
|
|
= WidgetPatternsAction
|
|
|
|
|
| ShowWidgetPatternAction { widgetPatternId :: !(Id WidgetPattern) }
|
|
|
|
|
| NewWidgetPatternAction
|
|
|
|
|
| CreateWidgetPatternAction
|
|
|
|
|
| EditWidgetPatternAction { widgetPatternId :: !(Id WidgetPattern) }
|
|
|
|
|
| UpdateWidgetPatternAction { widgetPatternId :: !(Id WidgetPattern) }
|
|
|
|
|
| PublishWidgetPatternAction { widgetPatternId :: !(Id WidgetPattern) }
|
|
|
|
|
| PublishNewVersionAction { widgetPatternId :: !(Id WidgetPattern) }
|
|
|
|
|
| AdoptPatternAction { widgetPatternId :: !(Id WidgetPattern) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data GovernanceTemplatesController
|
|
|
|
|
= GovernanceTemplatesAction
|
|
|
|
|
| ShowGovernanceTemplateAction { governanceTemplateId :: !(Id GovernanceTemplate) }
|
|
|
|
|
| NewGovernanceTemplateAction
|
|
|
|
|
| CreateGovernanceTemplateAction
|
|
|
|
|
| CloneGovernanceTemplateAction { governanceTemplateId :: !(Id GovernanceTemplate) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data MarketplaceDashboardController
|
|
|
|
|
= MarketplaceDashboardAction
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
-- /api/v2/ Phase 10 REST controllers
|
|
|
|
|
|
|
|
|
|
data ApiV2HubRegistryController
|
|
|
|
|
= ApiV2IndexHubRegistryAction
|
|
|
|
|
| ApiV2ShowHubRegistryAction { hubId :: !(Id Hub) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data ApiV2WidgetPatternsController
|
|
|
|
|
= ApiV2IndexWidgetPatternsAction
|
|
|
|
|
| ApiV2ShowWidgetPatternAction { widgetPatternId :: !(Id WidgetPattern) }
|
|
|
|
|
| ApiV2AdoptWidgetPatternAction { widgetPatternId :: !(Id WidgetPattern) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
feat(T02-T11): IHF Phase 1 schema, controllers, views, and helpers
- Schema: hubs, widgets, widget_versions, interaction_events (append-only
trigger), annotations, users — single migration file
- Web layer: Types, Routes, FrontController with auth + AutoRefresh layout
- Controllers: Hubs (CRUD), Widgets (CRUD + versioning), InteractionEvents
(JSON capture, canonical event_type validation), Annotations (threaded,
append-only)
- Sessions controller for IHP auth
- Views: Hubs (index/show/new/edit), Widgets (index/show/new/edit),
Annotations (index/new), Sessions (login)
- widgetEnvelope helper with full data-* governance attributes
- Integration tests: Hub CRUD, Widget versioning, event capture, append-only
guard, annotation threading, validation
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-27 01:42:43 +00:00
|
|
|
data SessionsController
|
|
|
|
|
= NewSessionAction
|
|
|
|
|
| CreateSessionAction
|
|
|
|
|
| DeleteSessionAction
|
|
|
|
|
deriving (Eq, Show, Data)
|