Phased execution order
- P0 - Restore and stabilize build: Restore risky deletions, run build/typecheck/dead-code scan, freeze delete actions.
- P1 - Already-routed imports: For routes that already exist, wire missing leaf components/hooks into existing page containers.
- P2 - Page-level wiring: Connect feature components to page-level tabs/cards/dialog triggers and permissions.
- P3 - New routes if needed: Add routes only where specs require distinct navigation surface and no existing page can host the feature.
- P4 - Selective pruning: After wiring validation and spec checks, prune truly dead files in small reviewed batches.
CL (Clinical)
Cluster: AI documentation controls
- Target route/page/component:
/cl/ambient-review,/cl/electronic-consents;src/cores/cl/ai-documentation/components/* - Current wiring state: Core routes are present; multiple AI documentation UI controls exist but are not consistently referenced by active page modules.
- Exact implementation tasks: Attach missing controls to review/settings surfaces; reconnect matching hooks; validate permission gating.
- Acceptance checks: Route renders without missing import errors; controls visible behind expected permissions; build + dead-code scan no longer flags wired files.
Cluster: Referral status subcomponents
- Target route/page/component:
/cl/referral-outcomes;src/cores/cl/components/referral-status/* - Current wiring state: Route is active; shared referral-status dialogs/tables were restored but are not all referenced.
- Exact implementation tasks: Reconnect detail sheet/history/update dialog into referral outcome workflows; ensure query/mutation hooks are consumed by container page.
- Acceptance checks: User can open referral status history/update from route UI; no unresolved imports; dead-code count reduced for this cluster.
CE (Community Engagement)
Cluster: Mobile CRM shell + SMS conversation UI
- Target route/page/component:
/ce/*pages,src/cores/ce/components/mobile/*,src/cores/ce/components/sms/SmsConversation* - Current wiring state: Core CE routes are present; mobile and conversation leaf components were restored after accidental deletion but remain weakly connected.
- Exact implementation tasks: Reattach mobile shell wrappers to CE page layouts; wire SMS conversation panel/bubbles into active SMS pages.
- Acceptance checks: CE pages compile on desktop/mobile breakpoints; SMS conversation flow renders end-to-end; no dead imports from restored SMS/mobile files.
Cluster: Assignment queue web-form components
- Target route/page/component:
/ce/web-forms/:idand related builder pages;src/cores/ce/components/web-forms/AssignmentQueue* - Current wiring state: Web-form routes exist, assignment queue leaf components are not clearly reachable.
- Exact implementation tasks: Hook assignment queue panel/search/item into web-form builder/detail workflows.
- Acceptance checks: Queue configuration accessible in UI; saved assignment rules persist and rehydrate; components are referenced by route-driven pages.
FW (Forms & Workflow)
Cluster: Sandbox/testing panel
- Target route/page/component:
/fw/forms/edit,/fw/automations/:id/workflow;src/cores/fw/components/testing/* - Current wiring state: Editing routes exist; sandbox testing components are present but not consistently mounted.
- Exact implementation tasks: Add explicit sandbox tab/accordion entry points in editor/workflow pages; bind state and execution handlers.
- Acceptance checks: Sandbox opens, executes test scenarios, and writes to expected history/telemetry paths; no unresolved imports.
Cluster: Template/marketplace/prefill adjunct components
- Target route/page/component:
/fw/templates/marketplace,/fw/wizards/marketplace, form prefill surfaces. - Current wiring state: Marketplace routes exist; several leaf UI components (cards/badges/version widgets/prefill indicators) remain disconnected.
- Pre-step: Run
npm run audit:component-duplication -- --head 20and reuse existing shared widgets before adding new composition wrappers. - Exact implementation tasks: Consolidate to one canonical marketplace composition path; wire only selected components used by active pages.
- Acceptance checks: Marketplace list/detail pages render complete cards/dialogs; dead-code findings for selected components drop after wiring.
HR (Human Resources)
Cluster: Compensation and analytics adjunct widgets
- Target route/page/component:
/hr/compensation/*,/hr/ats/analytics/*,src/cores/hr/analytics/* - Current wiring state: Compensation routes are active; additional analytics widgets/helpers are partially disconnected.
- Exact implementation tasks: Map each spec-complete widget to one owning page; remove duplicate adapters only after usage is confirmed.
- Acceptance checks: Compensation and analytics pages load target widgets; duplicate export warnings reduced; no missing route references.
IT (IT Operations)
Cluster: Asset assignment + license/procurement wizard leaf steps
- Target route/page/component:
/it/assets/*,/it/licenses/*,/it/procurement/*;src/cores/it/components/* - Current wiring state: Route coverage exists; several dialog/step components were restored and may not be mounted by current pages.
- Exact implementation tasks: Reconnect assignment dialog and procurement step components into create/edit flows; ensure barrel exports match page imports.
- Acceptance checks: Create/edit flows open all expected steps; forms submit successfully; dead-code findings for these steps decrease.
GR (Governance & Risk)
Cluster: AI assistive panels and hooks
- Target route/page/component:
/gr/ai/*;src/cores/gr/components/ai/*,src/cores/gr/hooks/index.ts - Current wiring state: GR AI routes exist; component/hook surface appears larger than currently composed pages.
- Exact implementation tasks: Audit page-by-page usage and mount only approved AI panels; align hook exports with actual route usage.
- Acceptance checks: Each
/gr/ai/*route renders intended panel set; no orphaned route-level imports for AI cluster.
PM (Practice Management)
Cluster: Enrollment and site billing wizard steps
- Target route/page/component:
/pm/enrollment/new,/pm/site-billing, wizard step folders undersrc/cores/pm/components/wizards/* - Current wiring state: Top-level routes are active; step-level components were restored and need explicit composition checks.
- Exact implementation tasks: Verify each wizard step is referenced by the owning wizard controller; rewire missing step registrations.
- Acceptance checks: Wizard can navigate all steps, validate, and submit; dead-code no longer reports restored wizard step files as isolated.
Cluster: Batch operation wizard
- Target route/page/component: batch operation workflows in PM revenue/claims tooling.
- Current wiring state: Batch history route exists; batch wizard step files were restored after deletion.
- Exact implementation tasks: Reconnect step sequence (scope -> impact -> confirm -> submit) to batch operation entry points.
- Acceptance checks: Batch flow reaches final confirmation and execution from UI; no runtime import failures.
RH (Recovery Housing)
Cluster: Admission wizard step pack
- Target route/page/component:
/rh/admissions/new,src/cores/rh/components/wizards/admission-steps/* - Current wiring state: Admission route exists; step components were restored and must be validated in step registry/wizard controller.
- Exact implementation tasks: Confirm step registry references each restored step; wire missing exports in admission-step index and wizard shell.
- Acceptance checks: Full admission wizard path (basic info -> program -> bed -> docs -> review) runs without missing-step errors.
Cluster: Discharge/outcomes operational dialogs
- Target route/page/component:
/rh/discharge-plans,/rh/discharge-documents,/rh/outcomes/* - Current wiring state: Routes exist; several dialog/form leaf components were restored but not guaranteed reachable.
- Exact implementation tasks: Add explicit triggers from list/detail pages; bind forms to existing RH hooks and mutation handlers.
- Acceptance checks: Dialogs open from route pages and persist updates; unresolved imports eliminated for restored RH forms.
Platform
Cluster: Wizard analytics + marketplace + review components
- Target route/page/component:
/fw/wizards/:id/analytics,/fw/wizards/marketplace/*,src/platform/wizards/components/{analytics,marketplace,review}/* - Current wiring state: Routes are present; many specialized visualization/review leaf components were restored after broad deletion.
- Exact implementation tasks: Recompose page containers to consume restored chart/review components where spec requires; avoid duplicate component paths.
- Acceptance checks: Wizard analytics and marketplace pages render full cards/charts/review sections; dead-code findings narrow to truly unused leaves.
Cluster: Platform AI widget set
- Target route/page/component: platform AI widget surfaces and dashboard embed points.
- Current wiring state: Widget barrel exists; individual widget files were restored and need intentional usage mapping.
- Exact implementation tasks: Define canonical host pages for each widget class (assistant, analyzer, summarizer); wire skeleton pairing where used.
- Acceptance checks: Widget hosts render and hydrate successfully; unused-file alerts drop for widgets intentionally retained.
Execution safety gates (apply to every cluster)
- Verify route reachability from
src/routes/**and lazy page imports. - Verify spec state in module README +
IMPLEMENTATION_LOG+ deferred dashboard before any prune action. - Run
npm run audit:integration-contractsbefore wiring cross-module surfaces. - Run
npm run typecheckandnpm run buildafter each cluster batch. - Run
npm run test:baselinefor end-to-end safety before deletion proposals. - Run
npm run deadcodeto confirm net reduction and avoid regressions. - Deletion actions require explicit human approval after showing exact file list and evidence.