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.Routes where
|
|
|
|
|
|
|
|
|
|
import IHP.RouterPrelude
|
|
|
|
|
import Generated.Types
|
|
|
|
|
import Web.Types
|
|
|
|
|
|
|
|
|
|
-- Hubs
|
|
|
|
|
instance AutoRoute HubsController
|
|
|
|
|
|
|
|
|
|
-- Widgets
|
|
|
|
|
instance AutoRoute WidgetsController
|
|
|
|
|
|
|
|
|
|
-- Interaction Events (POST /widgets/:widgetId/events)
|
|
|
|
|
instance AutoRoute InteractionEventsController
|
|
|
|
|
|
|
|
|
|
-- Annotations (scoped to widget: /widgets/:widgetId/annotations/)
|
|
|
|
|
instance AutoRoute 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
|
|
|
-- Annotation Threads (scoped to widget)
|
|
|
|
|
instance AutoRoute AnnotationThreadsController
|
|
|
|
|
|
|
|
|
|
-- Requirement Candidates
|
|
|
|
|
instance AutoRoute RequirementCandidatesController
|
|
|
|
|
|
2026-03-29 10:38:50 +00:00
|
|
|
-- Requirements (Phase 3)
|
|
|
|
|
instance AutoRoute RequirementsController
|
|
|
|
|
|
|
|
|
|
-- Decision Records (Phase 3)
|
|
|
|
|
instance AutoRoute DecisionRecordsController
|
|
|
|
|
|
2026-03-29 12:27:30 +00:00
|
|
|
-- Deployment Records (Phase 4)
|
|
|
|
|
instance AutoRoute DeploymentRecordsController
|
|
|
|
|
|
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
|
|
|
-- Agent Proposals (Phase 5)
|
|
|
|
|
instance AutoRoute AgentProposalsController
|
|
|
|
|
|
2026-03-29 21:03:00 +00:00
|
|
|
-- Phase 6 — Cross-Framework UI Adaptation
|
2026-03-29 21:11:03 +00:00
|
|
|
|
|
|
|
|
-- API endpoint: POST /api/v1/interaction-events
|
|
|
|
|
instance CanRoute ApiInteractionEventsController where
|
|
|
|
|
parseRoute' = do
|
|
|
|
|
_ <- string "/api"
|
|
|
|
|
_ <- string "/v1"
|
|
|
|
|
_ <- string "/interaction-events"
|
|
|
|
|
endOfInput
|
|
|
|
|
pure CreateApiInteractionEventAction
|
|
|
|
|
|
|
|
|
|
instance HasPath ApiInteractionEventsController where
|
|
|
|
|
pathTo CreateApiInteractionEventAction = "/api/v1/interaction-events"
|
|
|
|
|
|
2026-03-29 21:03:00 +00:00
|
|
|
instance AutoRoute EnvelopeEmissionContractsController
|
|
|
|
|
instance AutoRoute InteractionReportingContractsController
|
|
|
|
|
instance AutoRoute WidgetAdapterSpecsController
|
|
|
|
|
|
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
|
|
|
-- Phase 7 — Advanced Observability
|
|
|
|
|
instance AutoRoute CrossHubPropagationsController
|
|
|
|
|
|
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
|
|
|
|
|
instance AutoRoute WidgetOwnershipsController
|
|
|
|
|
instance AutoRoute HubRoutingRulesController
|
|
|
|
|
instance AutoRoute FederatedPolicyOverlaysController
|
|
|
|
|
instance AutoRoute StewardshipRolesController
|
|
|
|
|
instance AutoRoute ArchiveRecordsController
|
|
|
|
|
instance AutoRoute FederatedGovernanceController
|
|
|
|
|
|
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
|
|
|
-- Sessions
|
|
|
|
|
instance AutoRoute SessionsController
|