Metadata Extraction (SDC) AsyncTask Stuck

What This Skill Diagnoses

Bulk metadata extraction (Key Pointers / SDC) creates AsyncTask records of type EXTRACT_SUGGESTIONS before checking if the contract's contract_kind + display_status combination is supported. When an unsupported contract is included (e.g., DRAFT, VOIDED), the pipeline raises KPExtractionNotAllowedException — but this is uncaught in the outer use case. The started field is never set. The timeout cronjob requires started IS NOT NULL to mark the task TIMED_OUT, so the task stays IN_PROGRESS forever.

The customer cannot re-trigger extraction because there is a one-extraction-per-contract limit that checks for existing IN_PROGRESS tasks.

The stuck cycle:

Bulk extraction → AsyncTask created (started=NULL) → pipeline raises KPExtractionNotAllowedException
  → exception uncaught → started never set → timeout cronjob never fires → stuck forever
  → customer tries re-run → blocked by IN_PROGRESS check