EDORA
Skip to content

EDORA Learn β€” Pipelines

Violation Response and Revocation (Post-Disposition Loop)

Pipeline 07

Transparency note: definitions of β€œtechnical” versus β€œnew-law” violations vary. Series breaks are annotated where grid structures, revocation thresholds, or sanction categories change.

Overview

Violations represent moments where youth fail to meet supervision conditions. Jurisdictions distinguish between technical violations (e.g., missed curfew, failed drug test) and new-law violations (committing a new offense). The policy emphasis has shifted toward proportional, graduated responses designed to prevent unnecessary revocations and placements. This page documents how those processes are structured and measured.

What We Track

Violation Type

  • Classified as technical or new-law
    • Technical: missed contact, curfew, program non-attendance
    • New-law: cited/arrested for new offense
  • Event date/time captured; source documentation linked (report, vendor alert, police notice)

Graduated Response Grid

  • Tiered responses mapped to violation severity/frequency
  • Examples:
    • Verbal/written warning; skill session
    • Increased contacts; schedule change
    • Community service; day/evening reporting
    • ATD switch; short-term respite
    • Immediate revocation (criteria-limited)

Timeliness

  • Days from violation β†’ response or hearing
  • Proportion resolved within 30 days (stage-specific targets)

Revocation Outcomes

  • Returned to court; conditions modified; placement; new probation term
  • Revocation-related confinement duration (ALOS/median; IQR)

Equity & Overrides

  • Sanction use rate ratios by race/ethnicity, geography, gender; stage (admin vs. court) disaggregation
  • Overrides / skipped tiers documented with rationale & approver; proportionality monitoring

Typical Flow

  1. Violation detected by officer or provider; type & date recorded
    • Attach supporting documentation (attendance logs, alerts, police notice)
  2. Classification as technical vs. new-law; determine tier via grid
    • Check prior violations within lookback window; apply escalation rules
  3. Administrative response (warning/service/condition change) or refer for revocation hearing
    • Record response timeliness and any overrides with rationale
  4. Revocation hearing if applicable; decision to continue, modify, or revoke
    • Update orders; set next review date; note confinement credit if any
  5. Outcome recorded with length, reason, and future eligibility
    • Flag eligibility for early termination or reentry supports; schedule follow-up check
Schema source: violation

Fields

FieldTypeRequiredCodesetDescription
pipeline_place_iduuidβœ…β€”Unique identifier for this violation/response record.
pipeline_stage_idenumβœ…
stages.yml#stage_key(8)
  • intake
  • detention
  • adjudication
  • disposition
  • supervision
  • commitment_and_placement
  • reentry
  • closure
One of the canonical stages.
pipeline_place_keyenumβœ…
pipeline_places.yml#place_key(45)
  • intake
  • pre_petition_diversion_and_deflection
  • diversion
  • youth_assessment_tools
  • prosecutorial_screening
  • status_offenses
  • adjudication
  • case_planning
  • family_engagement
  • case_timeliness
  • language_access
  • restorative_justice
  • detention_screening
  • community_atds
  • electronic_monitoring
  • court_appearance_and_fta
  • initial_hearing
  • pretrial_supervision
  • probation
  • intensive_supervision
  • …and 25 more
Canonical key for this place (maps to route/slug).
youth_idstringβœ…β€”Salted/hashed or state UID. No plaintext PII.
staff_idstringβ€”Reporting/responding officer or case manager.
occurred_datetimedatetimeβœ…β€”Date/time the violation occurred or was recorded.
jurisdiction_codestringβœ…β€”County/parish/circuit or standardized local code.
legal_case_idstringβ€”Case/docket identifier if applicable.
source_systemstringβœ…β€”Origin system name.
source_filestringβ€”Source batch/file id if flatfile.
extract_run_idstringβ€”ETL run id for lineage.
series_break_flagbooleanβ€”Comparability break applies to this row.
series_break_reasonenum
series_breaks.yml#reason(4)
  • definition_change
  • vendor_change
  • coverage_change
  • policy_change
Reason for break when flagged (policy/tool change, etc.).
violation_classification_codeenumβœ…
violation_classifications.yml#class(2)
  • technical
  • new_law
technical or new_law.
violation_type_codeenumβœ…βŒ missing in _index.ymlSpecific violation (missed_contact, curfew, program_nonattendance, new_offense, other).
violation_detail_codesarray<string>
violation_details.yml#detail(7)
  • first_occurrence
  • repeat_within_30d
  • escalation
  • equipment_alert
  • provider_no_show
  • documentation_error
  • other
Optional detail tags (e.g., gps_tamper, positive_test); semicolon-delimited.
violation_report_source_codeenum
report_sources.yml#source(6)
  • officer_report
  • provider_alert
  • police_notice
  • vendor_alert
  • court_notice
  • other
officer_report, provider_alert, police_notice, vendor_alert, court_notice, other.
source_document_idsarray<string>β€”IDs/links to supporting documents or alerts; semicolon-delimited.
response_grid_keyenum
response_grids.yml#grid(2)
  • standard_grid_v1
  • enhanced_grid_v1
Policy grid identifier used for tiering.
response_tier_codeenum
response_tiers.yml#tier(5)
  • tier1_warning
  • tier2_adjustment
  • tier3_service
  • tier4_atd_switch_respite
  • tier5_revocation
Tier selected given severity/frequency (e.g., tier1_warning … tier5_revocation).
response_action_codesarray<string>
graduated_responses.yml#action(5)
  • contact_attempt
  • home_visit
  • step_up
  • violation_report
  • program_review
Actions applied (warning, skill_session, increased_contacts, schedule_change, community_service, day_reporting, atd_switch, respite, file_revocation); semicolon-delimited.
response_datetimedatetimeβ€”Timestamp the administrative response was executed.
override_flagbooleanβ€”Departure from grid/tier applied.
override_reason_codeenum
overrides.yml#reason(4)
  • safety_exception
  • capacity_constraint
  • policy_exception
  • supervisor_override
Rationale for override.
override_approver_staff_idstringβ€”Approver staff id for override.
referred_for_hearing_flagbooleanβ€”Case referred for court revocation/modification.
hearing_datetimedatetimeβ€”Date/time of revocation or modification hearing.
hearing_decision_codeenum
hearing_decisions.yml#decision(6)
  • continue
  • modify_conditions
  • placement
  • new_probation_term
  • revoke
  • dismissed
continue, modify_conditions, placement, new_probation_term, revoke, dismissed.
modified_condition_codesarray<string>
order_conditions.yml#condition(6)
  • curfew
  • school_attendance
  • no_contact
  • check_ins
  • drug_testing
  • electronic_monitoring
Conditions added/changed by decision; semicolon-delimited.
confinement_type_codeenum
confinement_types.yml#type(5)
  • detention
  • residential
  • respite
  • jail_adult
  • other
detention, residential, respite, jail_adult, other.
confinement_start_datetimedatetimeβ€”Start of revocation-related confinement (if any).
confinement_end_datetimedatetimeβ€”End of revocation-related confinement (if any).
next_review_datedateβ€”Next scheduled review date after response/hearing.
subgroup_codeenum
subgroup_categories.yml#group(5)
  • race_ethnicity
  • gender
  • geography
  • rurality
  • other
Race/ethnicity/gender/geography/rurality subgroup code for equity disaggregation.
Download CSVwhat_we_track.csv

Data & Methods

Violation data are event-based, with each violation episode linked to a supervision spell. Technical violations follow definitions in Technical Violations vs. New Offenses. Timeliness measures use days-to-response metrics, truncated at 90 days for outliers. Revocation duration is calculated as total days of confinement attributable to the violation episode. To assess consistency, jurisdictions compare tier use rates and overrides. Series breaks and small-n suppression follow Series Breaks & Definition Changes and Suppression & Small-n. For proportional response design, see Outcome Measurement & Indicator Design.

Related