Gerbang konformitas

Lima belas barCopy Anchor Link

Gerbang hanya menjalankan validator yang dapat diperiksa mesin. Pertimbangan bernalar yang dituntut oleh bar Bernalar, beserta separuh bernalar dari setiap bar Mekanis + bernalar, dievaluasi dalam tinjauan.

Tangga tingkat keparahanCopy Anchor Link

Gerbang ini tidak memiliki tangga Kritis, Penting, atau Advisori dan tidak memiliki ambang dua-temuan. Tanpa --strict (atau APOTHEM_CONFORMITY_STRICT=1), gerbang melaporkan temuan dan keluar dengan 0. Dengan --strict, pemeriksaan berkas-tunggal atau hook keluar dengan 2 ketika matcher mana pun gagal, dan eksekusi korpus (--all atau --all-perwrite) keluar dengan 2 ketika validator atau matcher pemblokir gagal; temuan advisori hanya dilaporkan. Hook Write/Edit yang terpasang tidak menyertakan --strict, sehingga ia melaporkan temuan dan penulisan tetap dilanjutkan kecuali APOTHEM_CONFORMITY_STRICT=1 disetel di lingkungannya.

ValidatorCopy Anchor Link

Bagian mekanis berada di src/apothem/conformity/, diorkestrasi oleh src/apothem/conformity/gate.py. Setiap validator berjalan dengan salah satu dari tiga cara:

• per-write: pada setiap penulisan yang tertunda (--hook), atau pada setiap berkas yang dilacak dengan --all-perwrite.
• standalone: di seluruh repositori dengan --all, atau satu per satu dengan --check <name>.
• change-set: terhadap diff yang di-stage, dijalankan langsung sebagai python -m apothem.conformity.semver_stability_grep --staged, bukan melalui gerbang.

Tabel di bawah ini dihasilkan dari modul validator.

The conformity package ships 54 validators: 22 per-write, 31 standalone and 1 change-set. The gate registers the per-write and standalone ones.

Menjalankan gerbangCopy Anchor Link

Pada harness yang terpasang, gerbang berjalan secara otomatis: settings.json milik Claude Code merangkainya sebagai hook PreToolUse yang memanggil salinan termaterialisasi di ~/.claude/.apothem/support/conformity/gate.py sebelum setiap Write/Edit. Gerbang kemudian hanya memeriksa penulisan yang berada di bawah cakupan hook-nya, dan penulisan di luar cakupan itu lolos secara diam-diam; Menjalankan gerbang konformitas mencantumkan cakupannya. Dari checkout sumber, bentuk modul menjalankan kode yang sama; awali setiap perintah python di bawah ini dengan PYTHONPATH=src. Gerbang bersifat advisori secara default: gerbang melaporkan temuan dan keluar dengan 0. Tambahkan --strict untuk keluar dengan 2 pada temuan yang memblokir. Nama validator yang tidak dikenal keluar dengan 3.

# Every standalone validator across the repository:
python -m apothem.conformity.gate --all .

# The same sweep, failing on a blocking finding (the CI form):
python -m apothem.conformity.gate --all --strict .

# Every per-write validator against every tracked file:
python -m apothem.conformity.gate --all-perwrite .

# One validator by name (names come from --list):
python -m apothem.conformity.gate --check naming-grep .

# List every registered validator as JSON:
python -m apothem.conformity.gate --list

# Single-file dispatch (mimics the PreToolUse hook):
echo '{"tool_input": {"file_path": "path/to/file", "content": "..."}}' \
    | python -m apothem.conformity.gate --hook

python -m apothem.conformity.gate --help mencetak ringkasan penggunaan. Lihat Menjalankan gerbang konformitas untuk prosedur lengkapnya.

ReferensiCopy Anchor Link

• Registri gerbang pra-emisi — definisi bar kanonik
• Registri konformitas ke luar — semantik terperinci M1-M15
• Mandat lintas-bidang — sumber kebenaran mandat
• Disiplin kinerja — anggaran runtime per kelas