Back to overviewMethodology · version 1.1

Document understanding can assist. Versioned code owns the conclusion.

WageShield is designed around a hard boundary: with explicit consent, a multimodal model may propose cited facts and a separate grounding pass may support or reject them. A person must still confirm every value. Money, dates, tolerances, statuses, access, reporting, and deletion remain deterministic and inspectable.

Private documents

User-authorized records remain case scoped.

→
AI propose + verify

Two bounded passes extract typed values, check the cited page, and abstain when support is missing.

→
Human confirmation

Every supported proposal remains blocked from analysis until a person confirms or corrects it.

→
Pure rules

Integer-cent math and half-open date intervals produce neutral, inspectable statuses.

What the system checks

Evidence before explanation

Every result comes from an accepted rule result, an approved source mapping, and explicit assumptions and limitations. Supported findings keep same-case evidence references, while a more-evidence-needed result names the missing source instead of inventing a citation. Monetary comparisons also include a reproducible calculation.

  • Ordinary base pay is kept separate from bonuses, taxes, and deductions.
  • Partial periods and unresolved corrections route to review.
  • Temporary and remote work qualifiers prevent a simplistic worksite conclusion.
  • A contract clause is never presented as a completed payroll transaction.
Status vocabulary

Responsible abstention is a feature

No mismatch detected

Reviewed records agree within the configured comparison tolerance.

Possible discrepancy

The documents support a relevant difference; missing context may change interpretation.

More evidence needed

A required fact or usable document is missing.

Documents conflict

Credible sources disagree and precedence is unresolved.

Human review recommended

Context or an exception prevents safe automated resolution.

Official context

Primary sources stay separate from private evidence

Findings link to versioned U.S. Department of Labor guidance for the issue category. That material gives general context; it does not transform a documentary difference into a case-specific legal conclusion.