// github

Wire mediva into GitHub

One workflow, one Markdown contract, one failing check when generated docs drift. Inline annotations point at the rule, line, and fix.

0/3 complete0%
.github/workflows/mediva.yml
name: mediva
on: [pull_request]

jobs:
  check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npx mediva check "docs/**/*.md" --schema docs.mdv.md --format github
docs.mdv.md
<!-- mdv: block required minWords=24 noPlaceholder -->
## Summary
<!-- mdv: endblock -->

<!-- mdv: taskList required allChecked exactLabels -->
## Checklist
- [ ] Tests added or updated
- [ ] Docs updated
- [ ] Screenshots or output attached
<!-- mdv: endtaskList -->

<!-- mdv: block required minWords=12 -->
## Manual verification
<!-- mdv: endblock -->
✕ docs/pr.md:3:1
[placeholder] requires real Summary text.
$ npx mediva check --stdin --format json
// output surfaces

Same findings.
Different GitHub surfaces.

The CLI writes annotations for reviewers, JSON for automation, and a non-zero exit code for branch protection.

MeDiVa / check failed
exit 1

2 findings · inline PR annotations emitted

✕[placeholder]docs/pr.md:3:1Fix: write a non-placeholder Summary with at least 24 words.
▲[unchecked-evidence]docs/pr.md:8:1Fix: check Docs updated or remove the claim from the contract.