# `mix surfex.completeness`
[🔗](https://github.com/dcoai/surfex/blob/v0.6.2/lib/mix/tasks/surfex.completeness.ex#L1)

Prints the completeness report (`Surfex.Completeness`, §20): a score per kind (spec
units, tests, code) and overall, and every incomplete item with what it lacks and where.

    mix surfex.completeness                  # text
    mix surfex.completeness --format json    # the work list for an agent

It fails when the overall score is below `completeness: [min: N]` in `.surfex.exs`.

---

*Consult [api-reference.md](api-reference.md) for complete listing*