docfy coverage

Mede que percentual dos seus endpoints está documentado. Útil como métrica objetiva de qualidade e como gate de CI.

Uso

bash

npx nestjs-docfy coverage [options]

Option	Default	Description
`--root <path>`	`.`	Project root directory
`--tsconfig <path>`	auto-detected	Path to `tsconfig.json`
`--pattern <glob>`	`*/.controller.ts`	Glob pattern to find controllers
`--format <format>`	`ts`	Docs file format to look for: `ts` ou `js`
`--min <percent>`	none	Minimum coverage required (0-100), exits `1` if below
`--quiet`	`false`	Suppress all output except errors

text

Controllers: 42
Endpoints: 187

Documented: 174
Missing docs: 13

Coverage: 93.0%

bash

npx nestjs-docfy coverage --min 95

Quando a coverage cai abaixo de --min, o comando sai com código 1, quebrando o build.

.github/workflows/*.yml

# GitHub Actions example
- name: Enforce documentation coverage
  run: npx nestjs-docfy coverage --min 95

Ou como npm script:

json

{
  "scripts": {
    "docs:coverage": "nestjs-docfy coverage --min 95"
  }
}