Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt

Use this file to discover all available pages before exploring further.

Feature ID: CL-02-EN-58
Created: 2026-03-04
Status: ✅ Complete

​
Overview

CL-02-EN-58 adds four trauma-informed assessment instruments (PCL-5, ACE-10, LEC-5, BTQ) to the CL-02 comprehensive assessment library. This is an intra-CL enhancement — no cross-core dependencies.

​
Integration Points

​
CL-02 (Comprehensive Assessments) — Parent

  • Instruments: Seeded into cl_assessment_instruments via migration. Uses existing instrument CRUD hooks (useAssessmentInstruments).
  • Scoring: Trauma-specific scoring in src/cores/cl/utils/traumaScoring.ts supplements computeScore in assessmentScoring.ts. Dispatch by isTraumaInstrument() from src/cores/cl/constants/instruments.ts.
  • UI: TraumaAssessmentForm opens from ChartAssessmentsSection when instrument code matches TRAUMA_INSTRUMENT_CODES.
  • Gating: SUD-flagged charts require consent before trauma assessment access. Uses useConsentCheck(chartId, 'trauma_assessment') from @/platform/clinical/consent/useConsentCheck.
  • RPC: cl_check_sud_consent accepts 'trauma_assessment' as p_record_type (TEXT parameter — no schema change needed).

​
CL-03 (Treatment Planning) — Future

  • Stub: “Link to Treatment Plan” button rendered disabled with tooltip “Treatment planning coming soon.” on TraumaResultAlert.
  • Future work: When CL-03 supports trauma-informed goals, enable button to navigate to treatment plan creation pre-populated with assessment findings.

​
Permissions

Uses existing CL-02 permission keys:
  • cl.assessment.create — start trauma assessment
  • cl.assessment.view — view results
  • cl.assessment.manage — save/edit assessments
No new permission keys added.

​
Data Flow

ChartAssessmentsSection
  → isTraumaInstrument(code) check
  → useConsentCheck (if SUD-flagged)
  → TraumaAssessmentForm (item-level input)
  → scorePcl5 / scoreAce10 / scoreLec5 / scoreBtq
  → TraumaResultAlert (PCL-5 ≥ 33 threshold)
  → Save to cl_assessments / cl_assessment_sections

​
References

  • Spec: specs/cl/specs/CL-02-EN-58-trauma-informed-assessments.md
  • Context: specs/cl/specs/CL-02-EN-58-CONTEXT.md
  • Parent integration: CL-02-comprehensive-assessments-INTEGRATION.md
  • Consent integration: CL-11-consent-management-42cfr-part2-INTEGRATION.md