Take a photo, choose files, or bring in a full packet. This lane keeps the upload queue visible, preserves draft state, and carries the packet into human review before staging.
Public upload APIs create quarantine SourceFile records and parser candidate envelopes. Filing, queue, and docket records stay fenced until human review confirms what should be promoted.
The public filing draft keeps ownership and provenance separate from the raw file. SourceFile records carry metadata only: owner, draft, hash, source, timestamp, file type, scan state, and audit event.
Parser job lifecycle
Allowed states
pending → running → blocked → failed → needs_review → complete
Visible + recoverable
confirmed
Candidate-only output
staged candidates only
parser-job-1
pendingstart-or-resume-parser
resumable: true · recoverable: true
Pass 552 · Filing candidate extraction
Court, venue, docket, filing type, parties, document class, signature, certificate, proposed order, fee, waiver, and confidentiality signals are review candidates only.
Output
staged candidates only
Review gate
human confirmation required
Canonical records
no official mutation
signature
needs_reviewsignature-not-detected
editable · confirmation resets on edit · confidence 42%
certificate of service
needs_reviewcertificate-of-service-not-detected
editable · confirmation resets on edit · confidence 42%
proposed order
needs_reviewproposed-order-not-detected
editable · confirmation resets on edit · confidence 42%
fee
needs_reviewfee-status-needs-review
editable · confirmation resets on edit · confidence 40%
fee waiver
needs_reviewfee-waiver-not-detected
editable · confirmation resets on edit · confidence 43%
confidential indicator
needs_reviewconfidentiality-needs-review
editable · confirmation resets on edit · confidence 45%
Pass 553 · Candidate contradiction detection
Court, venue, docket, party, caption, filing type, and document class conflicts create warnings before staging. They do not overwrite official records.
Conflict output
warnings only
Staging
blocked until reviewed
Canonical records
no official mutation
court
needs_human_reviewDistrict Court · Court needs review
warning only · human review required · no canonical write
caption
needs_human_reviewCaption needs review · Caption candidate from upload
warning only · human review required · no canonical write
Pass 554 · Missing item detection
Signature, certificate, required attachment, proposed order, fee waiver posture, service proof, and required form gaps create review warnings before staging.
Gap output
warnings only
Staging
visible before staging
Canonical records
no official mutation
Signature
needs_human_reviewMissing signature must be visible before staging and reviewed by a person.
visible before staging · human review required · no canonical write
Certificate of service
needs_human_reviewMissing certificate of service must be visible before staging and reviewed by a person.
visible before staging · human review required · no canonical write
Required attachment
needs_human_reviewMissing required attachment must be visible before staging and reviewed by a person.
visible before staging · human review required · no canonical write
Proposed order
needs_human_reviewMissing proposed order must be visible before staging and reviewed by a person.
visible before staging · human review required · no canonical write
Pass 555 · Human promotion gate
Parser values remain candidates until a filer or court staff reviewer confirms them. Any reviewed field change resets confirmation and blocks staging again.
Parser output
candidate-only
Promotion
human confirmation required
Staging
blocked on resets
human confirmation required
needs_reviewCandidate value cannot become staged filing data until a public filer or court staff reviewer confirms it.
no parser output becomes staged filing data without confirmation
human confirmation required
needs_reviewCandidate value cannot become staged filing data until a public filer or court staff reviewer confirms it.
no parser output becomes staged filing data without confirmation
unresolved warning
needs_human_reviewWarning must be reviewed before staging.
no parser output becomes staged filing data without confirmation
unresolved warning
needs_human_reviewWarning must be reviewed before staging.
no parser output becomes staged filing data without confirmation
Pass 556 · Ingest failure recovery
Password-protected, corrupted, unsupported, unreadable, OCR-needed, oversized, or unsafe uploads produce visible recovery steps before staging.
Failure mode
visible
Recovery
action required
Staging
blocked until recovered
OCR needed
recoverableThe file appears to be a scan or image-only document and needs OCR review before candidate extraction.
actions: request_ocr_review, manual_clerk_review, preserve_failure_receipt
Unsupported file type
recoverableConvert the file to PDF, JPG, PNG, DOCX, or text before uploading again.
actions: convert_to_pdf_or_image, retry_upload, preserve_failure_receipt
ProSeOps, CounselOps, Firm PSA, and public e-filing use the same canonical preflight protocol. Court/location, caption/docket, filing code, required form, attachment, signature, fee/waiver, confidentiality, and relation-back checks stay review-safe and cannot submit to court.
Party → service method → contact → authorized → selected → case service list → blocking issue → fix is shown for every service row. The filing path separates eFile Only, eFile and Serve, manual service, and mixed service, while proof, receipts, rejection intake, repair tasks, and fallback packets remain review-safe.