META cas-d'école : conformité de Cortex aux best practices du guide d'activation Anthropic

[cdeust]

Issue de suivi (directive 2026-07-14) : faire de Cortex le repo cas d'école, fonctionnel et adapté au grand public. Chaque écart aux pratiques du guide = une issue liée, avec preuve et leçon de référence.

• postInstall du plugin cassé sur Windows natif : setup.sh échoue sur tout OS ≠ Darwin/Linux, et la CI ne teste pas le vrai chemin d'install #113 postInstall Windows + CI du vrai chemin d'install (fix en cours)
• CLAUDE.md:435 obsolète : « PostgreSQL MANDATORY, no SQLite » contredit le produit réel par-surface (PRIVACY.md/README/manifest) #114 CLAUDE.md : resync stockage par surface + refactor <200 lignes avec @-références (périmètre étendu, cf. commentaire)
• Exposer un outil MCP check_setup (façade doctor.py), sur le modèle check_vision_setup/check_voice_setup #115 outil MCP check_setup (préflight P1, pattern check_vision_setup)
• Documenter proxy/CA d'entreprise pour les téléchargements de modèles (HTTPS_PROXY, REQUESTS_CA_BUNDLE/SSL_CERT_FILE, HF_HUB_*) #116 doc proxy/CA d'entreprise pour téléchargements modèles
• Devcontainer officiel Cortex : environnement une-commande, isolé, versions pinnées #118 devcontainer officiel (une-commande, isolé, pinné)
• Settings projet .claude/settings.json + catalogue de slash commands documenté #119 settings projet + catalogue slash commands + régimes CI --bare
• Floors de bench re-baselinés sur l'instrument isolé (branche chore/floors-rebaseline, en cours)

Critère de fermeture : un utilisateur grand public installe et vérifie Cortex en une commande par plateforme documentée, et chaque réglage/procédure du repo correspond à la pratique enseignée par le guide.

[cdeust]

Clôture avec preuves (2026-07-17) — tous les sous-chantiers sont terminés et mergés sur main :

Écart	Issue	PR mergée
postInstall Windows + CI du vrai chemin d'install	#113	#117 (+ étape « Real postInstall proof » dans ci.yml, job test-windows, qui exécute bash scripts/install-plugin.sh — le vrai postInstall de plugin.json)
CLAUDE.md <200 lignes avec @-références	#114	#125 (92 lignes)
Outil MCP check_setup (préflight)	#115	#133
Doc proxy/CA d'entreprise	#116	#123
Devcontainer une-commande	#118	#129
Settings projet + catalogue commands + CI --bare	#119	#131
Floors de bench re-baselinés	—	#121

Critère de fermeture vérifié par signaux externes : le CI exerce le chemin d'install réel par plateforme (ubuntu docker-smoke contrat bare-container DB-less, test-windows postInstall réel + import smoke, test-sqlite fallback sans PG) et l'intégralité des checks était verte sur l'arbre mergé le plus récent (PR #152 : 10/10 SUCCESS + CodeQL neutral).

La directive reste active hors de cette issue : tout nouvel écart au guide d'activation = nouvelle issue liée, avec preuve.

🤖 Generated with Claude Code