> ## 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.

# Integration Document: CL-02-EN-58 — Trauma-Informed Assessment Instruments

> 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 enh…

**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`.

### CL-11 (Consent Management & 42 CFR Part 2)

* **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`