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
|
|
|
|
|
|
fix(WP-0014/A2): close remaining pure-param and structural compilation errors
Convert all remaining `<- paramOrNothing / param / paramOrDefault /
currentUserOrNothing` monadic binds to `let` — these functions are pure
(ImplicitParams-based) in IHP v1.5, so `<-` is a type error in an IO
do-block.
Controllers fixed:
AgentDelegations, AiGovernancePolicies, Annotations, ApiConsumers,
CollectiveProposals, DecisionRecords, DeploymentRecords,
HubCapabilityManifests, HubRoutingRules, InstitutionalKnowledge,
OutcomeCorrelations, RequirementCandidates, TypeRegistries,
WebhookSubscriptions, Widgets,
Api/V2/{Annotations,InteractionEvents,Token}
WebhookSubscriptions: remove orphaned `Right () ->` case arm that was
left inside a bare `unless` block (structural parse error).
Also carries forward all in-progress fixes from the working tree:
helpers (AgentBridge, ApiRateLimit, BottleneckDetector,
CrossHubPropagation, FrictionScore),
views (CanSelect instances, HSX lambda extraction, formFor wrappers),
env/build (envrc GHCi perms, flake.nix Tailwind + GHC resource limits,
static/app.css additional Tailwind output).
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-10 01:14:08 +00:00
|
|
|
-- | Authentication type family instance (required by IHP.LoginSupport)
|
|
|
|
|
type instance CurrentUserRecord = User
|
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
|
|
|
|
|
|
|
|
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) }
|
2026-05-16 08:34:20 +02:00
|
|
|
| ApiV2CreateWidgetAction
|
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
|
|
|
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
|
2026-05-16 09:06:15 +02:00
|
|
|
| ApiV2ListPolicyScopesAction
|
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
|
|
|
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)
|
|
|
|
|
|
2026-04-04 09:55:12 +00:00
|
|
|
-- | GAAF compliance status derived from manifest and registry.
|
|
|
|
|
data GaafStatus
|
|
|
|
|
= GaafCompliant -- active manifest, all declared types registered
|
|
|
|
|
| GaafNoManifest -- hub has no active manifest
|
|
|
|
|
| GaafDraftOnly -- hub has a draft but no active manifest
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
gaafStatus :: Maybe HubCapabilityManifest -> GaafStatus
|
|
|
|
|
gaafStatus Nothing = GaafNoManifest
|
|
|
|
|
gaafStatus (Just m)
|
|
|
|
|
| m.status == "active" = GaafCompliant
|
|
|
|
|
| m.status == "draft" = GaafDraftOnly
|
|
|
|
|
| otherwise = GaafNoManifest
|
|
|
|
|
|
|
|
|
|
-- | Aggregated row for the hub registry index.
|
|
|
|
|
data HubRegistryRow = HubRegistryRow
|
|
|
|
|
{ hub :: !Hub
|
|
|
|
|
, mManifest :: !(Maybe HubCapabilityManifest)
|
|
|
|
|
, mLatestSnapshot :: !(Maybe HubHealthSnapshot)
|
|
|
|
|
}
|
|
|
|
|
|
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
|
|
|
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)
|
|
|
|
|
|
2026-05-16 08:34:20 +02:00
|
|
|
data ApiV2HubsController
|
|
|
|
|
= ApiV2IndexHubsAction
|
|
|
|
|
| ApiV2ShowHubAction { hubId :: !(Id Hub) }
|
|
|
|
|
| ApiV2CreateHubAction
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
2026-05-16 09:06:15 +02:00
|
|
|
data ApiV2HubCapabilityManifestsController
|
|
|
|
|
= ApiV2IndexHubCapabilityManifestsAction
|
|
|
|
|
| ApiV2ShowHubCapabilityManifestAction { hubCapabilityManifestId :: !(Id HubCapabilityManifest) }
|
|
|
|
|
| ApiV2CreateHubCapabilityManifestAction
|
|
|
|
|
| ApiV2UpdateHubCapabilityManifestAction { hubCapabilityManifestId :: !(Id HubCapabilityManifest) }
|
|
|
|
|
| ApiV2ActivateHubCapabilityManifestAction { hubCapabilityManifestId :: !(Id HubCapabilityManifest) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
2026-05-19 01:56:48 +02:00
|
|
|
data ApiV2ApiConsumersController
|
|
|
|
|
= ApiV2IndexApiConsumersAction
|
|
|
|
|
| ApiV2ShowApiConsumerAction { apiConsumerId :: !(Id ApiConsumer) }
|
|
|
|
|
| ApiV2CreateApiConsumerAction
|
|
|
|
|
| ApiV2CreateApiConsumerKeyAction { apiConsumerId :: !(Id ApiConsumer) }
|
|
|
|
|
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
|
|
|
data ApiV2WidgetPatternsController
|
|
|
|
|
= ApiV2IndexWidgetPatternsAction
|
|
|
|
|
| ApiV2ShowWidgetPatternAction { widgetPatternId :: !(Id WidgetPattern) }
|
|
|
|
|
| ApiV2AdoptWidgetPatternAction { widgetPatternId :: !(Id WidgetPattern) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
feat(WP-0012): IHF Phase 11 — Advanced AI Federation
- Schema: AgentRegistration, ModelRoutingPolicy, AgentDelegation,
CollectiveProposal, CollectiveProposalContribution, AiGovernancePolicy,
AgentPerformanceRecord + ALTER TABLE agent_proposals
(migration 1744156800; CHECK constraints on trust_level, status,
consensus_status — GAAF compliant)
- Bridge: scripts/llm_bridge.py (llm-connect subprocess seam) +
Application/Helper/AgentBridge.hs (callBridge, callAgent,
checkGovernancePolicy, jsonArrayTexts)
- Routing: Application/Helper/ModelRouter.hs (resolveAgent,
resolveAllAgents) + ModelRoutingPolicies CRUD
- Registry: AgentRegistrations CRUD (Index/Show/New/Edit/Performance),
DeactivateAgentAction, ComputeAgentPerformanceAction
- Delegation: AgentDelegations controller + views, DelegateSubtaskAction
with token budget enforcement at bridge call time
- Collective: CollectiveProposals controller + views,
CreateCollectiveProposalAction (fan-out → synthesis → consensus detection)
- Governance: AiGovernancePolicies CRUD + ToggleAiGovernancePolicyAction;
checkGovernancePolicy enforced at all 4 Phase 5 invocation points
- Phase 5 wiring: replaced callClaudeApi in Widgets, DecisionRecords,
RequirementCandidates with resolveAgent + callAgent + token tracking
- llm-connect feature requests: ~/llm-connect/FEATURE_REQUESTS.md
(FR-1 HTTP serve, FR-2 RoutingPolicy, FR-3 async, FR-4 BudgetTracker)
- GAAF scorecard: 3.61 (up from 3.56); Functional 3.4→3.6, Extensions 3.8→3.9
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-01 20:57:17 +00:00
|
|
|
-- Phase 11 — Advanced AI Federation
|
|
|
|
|
|
|
|
|
|
data AgentRegistrationsController
|
|
|
|
|
= AgentRegistrationsAction
|
|
|
|
|
| ShowAgentRegistrationAction { agentRegistrationId :: !(Id AgentRegistration) }
|
|
|
|
|
| NewAgentRegistrationAction
|
|
|
|
|
| CreateAgentRegistrationAction
|
|
|
|
|
| EditAgentRegistrationAction { agentRegistrationId :: !(Id AgentRegistration) }
|
|
|
|
|
| UpdateAgentRegistrationAction { agentRegistrationId :: !(Id AgentRegistration) }
|
|
|
|
|
| DeactivateAgentAction { agentRegistrationId :: !(Id AgentRegistration) }
|
|
|
|
|
| ComputeAgentPerformanceAction { agentRegistrationId :: !(Id AgentRegistration) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data ModelRoutingPoliciesController
|
|
|
|
|
= ModelRoutingPoliciesAction
|
|
|
|
|
| NewModelRoutingPolicyAction
|
|
|
|
|
| CreateModelRoutingPolicyAction
|
|
|
|
|
| DeleteModelRoutingPolicyAction { modelRoutingPolicyId :: !(Id ModelRoutingPolicy) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data AgentDelegationsController
|
|
|
|
|
= AgentDelegationsAction
|
|
|
|
|
| ShowAgentDelegationAction { agentDelegationId :: !(Id AgentDelegation) }
|
|
|
|
|
| DelegateSubtaskAction { agentProposalId :: !(Id AgentProposal) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data CollectiveProposalsController
|
|
|
|
|
= CollectiveProposalsAction
|
|
|
|
|
| ShowCollectiveProposalAction { collectiveProposalId :: !(Id CollectiveProposal) }
|
|
|
|
|
| CreateCollectiveProposalAction
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data AiGovernancePoliciesController
|
|
|
|
|
= AiGovernancePoliciesAction
|
|
|
|
|
| NewAiGovernancePolicyAction
|
|
|
|
|
| CreateAiGovernancePolicyAction
|
|
|
|
|
| ToggleAiGovernancePolicyAction { aiGovernancePolicyId :: !(Id AiGovernancePolicy) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
feat(WP-0013): IHF Phase 12 — Platform Memory and Continuous Learning
Closes the long-range feedback loop: outcome signals now enrich the full
traceability chain and feed back into routing, triage, and AI proposals.
Schema (T01):
- outcome_correlations (CHECK correlation_type)
- pattern_performance_records
- adaptive_threshold_configs
- institutional_knowledge_entries (GIN tsvector FTS)
- learning_insights (CHECK insight_type)
- ALTER TABLE decision_records + requirement_candidates: outcome_summary JSONB
- AFTER INSERT trigger trg_enrich_lineage on outcome_signals
- contracts/core/ updated (outcome-summary-columns-v1, append-only addendum)
Correlation engine (T02):
- Application/Helper/CorrelationEngine.hs: pure annotation→outcome SQL
- Web/Controller/OutcomeCorrelations.hs: ComputeCorrelationsAction + index
Pattern performance (T03):
- Web/Controller/PatternPerformance.hs: ComputePatternPerformanceAction
Adaptive thresholds (T04):
- Web/Controller/AdaptiveThresholds.hs: CalibrateThresholdsAction
- Application/Helper/FrictionScore.hs: applyAdaptiveWeights
Institutional knowledge (T05):
- DistilDecisionAction in DecisionRecords controller
- Web/Controller/InstitutionalKnowledge.hs: QueryKnowledgeBaseAction
Lineage enrichment (T06):
- Web/Controller/LineageEnrichment.hs: EnrichLineageAction (batch backfill)
- enrich_lineage_on_outcome_batch() PL/pgSQL helper in migration
Learning dashboard (T07):
- Web/Controller/LearningDashboard.hs: 5-panel autoRefresh view
- "Learning" nav link in FrontController
API v2 learning endpoints (T08):
- GET /api/v2/outcome-correlations, /pattern-performance, /knowledge-base/{id}
- OpenAPI schemas: OutcomeCorrelation, PatternPerformanceRecord, InstitutionalKnowledgeEntry
GAAF scorecard + docs (T09):
- Core 3.8→3.9, Functional 3.6→3.8, overall 3.61→3.68
- CLAUDE.md: IHF v0.2 complete, no active workplan
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-01 23:14:15 +00:00
|
|
|
-- Phase 12 — Platform Memory and Continuous Learning
|
|
|
|
|
|
|
|
|
|
data OutcomeCorrelationsController
|
|
|
|
|
= OutcomeCorrelationsAction
|
|
|
|
|
| ComputeCorrelationsAction { hubId :: !(Id Hub) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data PatternPerformanceController
|
|
|
|
|
= PatternPerformanceAction
|
|
|
|
|
| ComputePatternPerformanceAction { hubIdForPerformance :: !(Id Hub) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data AdaptiveThresholdsController
|
|
|
|
|
= AdaptiveThresholdsAction
|
|
|
|
|
| CalibrateThresholdsAction { hubIdForThreshold :: !(Id Hub) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data InstitutionalKnowledgeController
|
|
|
|
|
= InstitutionalKnowledgeAction
|
|
|
|
|
| ShowInstitutionalKnowledgeAction { knowledgeEntryId :: !(Id InstitutionalKnowledgeEntry) }
|
|
|
|
|
| QueryKnowledgeBaseAction
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data LineageEnrichmentController
|
|
|
|
|
= LineageEnrichmentAction
|
|
|
|
|
| EnrichLineageAction { hubIdForLineage :: !(Id Hub) }
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data LearningDashboardController
|
|
|
|
|
= LearningDashboardAction
|
|
|
|
|
deriving (Eq, Show, Data)
|
|
|
|
|
|
|
|
|
|
data ApiV2LearningController
|
|
|
|
|
= ApiV2IndexOutcomeCorrelationsAction
|
|
|
|
|
| ApiV2IndexPatternPerformanceAction
|
|
|
|
|
| ApiV2IndexKnowledgeBaseAction
|
|
|
|
|
| ApiV2ShowKnowledgeBaseAction { knowledgeEntryId :: !(Id InstitutionalKnowledgeEntry) }
|
|
|
|
|
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)
|
feat(WP-0015/B1-B6): StaticPages controller and public intro/tutorial UI
B1 — Web/Controller/StaticPages.hs: LandingAction, CapabilitiesAction,
TutorialAction, ExtensionGuideAction (no auth guard)
B2 — Web/View/StaticPages/Landing.hs: hero, traceability chain, capability
grid, GAAF status bar, CTAs to capabilities and management UI
B3 — Web/View/StaticPages/Capabilities.hs: 12-phase capability map, GAAF
scorecard, API v1/v2 surface table, learning loop, type registry system
B4 — Web/View/StaticPages/Tutorial.hs: 6-step developer tutorial (widgets,
events, governance, deployment, learning, federation)
Web/View/StaticPages/ExtensionGuide.hs: 6-step hub extension guide
(HubCapabilityManifest, type registry, widgets, patterns, agents)
with GAAF rules summary
B5 — Web/Routes.hs: StaticPagesController manual routes; "/" → Landing,
"/capabilities", "/tutorial", "/extension-guide"
Web/Types.hs: StaticPagesController data type
B6 — Web/FrontController.hs: import StaticPagesController; register route
(last, catches root); nav adds About/Tutorial/Extend links and
separator; logo now links to LandingAction
B7 (deployment verification) remains pending until devenv up is available.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-08 02:02:44 +00:00
|
|
|
|
|
|
|
|
-- WP-0015 — Public intro / tutorial pages
|
|
|
|
|
|
|
|
|
|
data StaticPagesController
|
|
|
|
|
= LandingAction
|
|
|
|
|
| CapabilitiesAction
|
|
|
|
|
| TutorialAction
|
|
|
|
|
| ExtensionGuideAction
|
|
|
|
|
deriving (Eq, Show, Data)
|