Portail de conformité

Les quinze barresCopy Anchor Link

Le portail n'exécute que des validateurs vérifiables par machine. Le jugement raisonné que réclament les barres de classe Raisonnée, ainsi que la moitié raisonnée de chaque barre de classe Mécanique + raisonnée, est évalué en revue.

Échelle de sévéritéCopy Anchor Link

Le portail ne comporte ni échelle de sévérité Critique, Importante ou Consultative, ni seuil de deux constats. Sans --strict (ou APOTHEM_CONFORMITY_STRICT=1), le portail signale les constats et se termine avec le code 0. Avec --strict, un contrôle sur un seul fichier ou un hook se termine avec le code 2 dès qu'un matcher échoue, et une exécution sur le corpus (--all ou --all-perwrite) se termine avec le code 2 lorsqu'un validateur ou un matcher bloquant échoue ; les constats consultatifs sont uniquement signalés. Le hook Write/Edit installé ne passe pas --strict : il signale les constats et l'écriture se poursuit, sauf si APOTHEM_CONFORMITY_STRICT=1 est défini dans son environnement.

ValidateursCopy Anchor Link

La fraction mécanique vit dans src/apothem/conformity/, orchestrée par src/apothem/conformity/gate.py. Chaque validateur s'exécute de l'une des trois façons suivantes :

• par écriture : sur chaque écriture en attente (--hook), ou sur chaque fichier suivi avec --all-perwrite.
• autonome : sur l'ensemble du dépôt avec --all, ou un par un avec --check <name>.
• par ensemble de modifications : sur un diff indexé, exécuté directement avec python -m apothem.conformity.semver_stability_grep --staged, et non via le portail.

Le tableau ci-dessous est généré à partir des modules de validateurs.

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

Exécuter le portailCopy Anchor Link

Sur un environnement installé, le portail s'exécute automatiquement : le settings.json de Claude Code le branche en tant que hook PreToolUse qui invoque la copie matérialisée à ~/.claude/.apothem/support/conformity/gate.py avant chaque Write/Edit. Le portail ne vérifie alors que les écritures situées dans la portée de son hook, et une écriture hors de cette portée passe silencieusement ; Exécuter le portail de conformité liste cette portée. Depuis un checkout du code source, la forme module exécute le même code ; faites précéder chaque commande python ci-dessous de PYTHONPATH=src. Le portail est consultatif par défaut : il signale les constats et se termine avec le code 0. Ajoutez --strict pour qu'il se termine avec le code 2 sur un constat bloquant. Un nom de validateur inconnu se termine avec le code 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 affiche le résumé d'utilisation. Voir Exécuter le portail de conformité pour la procédure complète.

RéférenceCopy Anchor Link

• Registre du portail de pré-émission — définitions canoniques des barres
• Registre de conformité externe — sémantique détaillée de M1-M15
• Mandats transversaux — source de vérité des mandats
• Discipline de performance — budgets d'exécution par classe