erotetique 0.1.0__tar.gz

erotetique-0.1.0/.claude/settings.local.json

@@ -0,0 +1,8 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(git add *)",
+      "Bash(git commit -m ' *)"
+    ]
+  }
+}

erotetique-0.1.0/.env.example

@@ -0,0 +1,2 @@
+# Aucune variable d'environnement requise pour le fonctionnement de base.
+# Le server tourne sans clé API ni base externe.

erotetique-0.1.0/.gitignore

@@ -0,0 +1,39 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+*.egg
+
+# Env
+.venv/
+venv/
+.env
+
+# IDE
+.vscode/
+.idea/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Heavy files — not in package
+connaissance/livres/
+connaissance/extractions/
+connaissance/transcripts/
+connaissance/index/
+
+# Docs (separate from package)
+docs/
+
+# Test artifacts
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Build cache
+.semut-cache.db

erotetique-0.1.0/LICENCE.md

@@ -0,0 +1,291 @@
+# Iterative Knowledge Commons License
+## IKCL — Version 0.1
+
+> Explore librement. Itère honnêtement. Partage ce que tu découvres.
+> La connaissance que tu produis enrichit ceux qui viennent après toi.
+> C'est tout le contrat.
+
+---
+
+## Préambule
+
+Nous explorons ensemble ce que signifie développer en dehors des limites héritées.
+
+Nous n'utilisons pas les LLM pour plagier des organigrammes de 2015. Nous ne reproduisons pas les structures d'hier avec les outils de demain. Nous cherchons ce qui n'existe pas encore — de nouvelles façons de penser, de concevoir, de co-créer avec une intelligence qui n'est pas humaine mais qui peut l'amplifier.
+
+Cette exploration est collective ou elle n'est pas. Ce que tu découvres en pratiquant cette méthode appartient à ceux qui viendront après toi. Pas par obligation morale abstraite — par cohérence avec ce que cette méthode est : un processus vivant, nourri par la friction entre une intention et une réalité.
+
+La IKCL formalise cet engagement : tu explores librement, tu en tires de la valeur — et tu partages ce que tu découvres pour enrichir la manière dont nous co-créons avec l'IA. Le registre est ouvert. La chaîne de preuve est publique. L'exploration continue.
+
+---
+
+## Définitions
+
+| Terme | Sens dans cette licence |
+|---|---|
+| **Méthode** | L'ensemble formalisé distribué sous cette licence : ontologie, niveaux, contraintes SHACL, outils de référence — qui livre une instance à chaque praticien |
+| **Instance** | L'environnement d'expérimentation et d'apprentissage reçu par le praticien — autonome, opérationnel dans son contexte, connecté au registre. Le modèle d'ensemble est une **franchise épistémique** : chaque instance est indépendante mais partage le même corpus de connaissance centralisé |
+| **Utilisable** | L'instance produit des résultats exploitables dans un contexte réel, hors phase d'évaluation ou de POC |
+| **Itération** | Toute modification apportée en réponse à un usage réel — code, configuration, règle, processus, prompt |
+| **Delta de connaissance** | Ce qui a motivé l'itération : le problème observé, la décision prise, l'effet constaté — la connaissance sur *comment construire*, pas ce qui a été construit |
+| **Dépôt REX** | La contribution structurée du delta de connaissance dans le registre MCP désigné |
+| **Registre MCP** | Le serveur MCP désigné par la licence comme infrastructure centrale de capitalisation et de redistribution |
+
+---
+
+## Article 1 — Ce que tu reçois
+
+En adoptant cette méthode, tu reçois une instance d'expérimentation et d'apprentissage pour construire des outils de production neurosymboliques et logiciels.
+
+Cette instance t'appartient. Ce que tu y construis t'appartient. Ce que tu y produis commercialement t'appartient.
+
+Ce qui appartient aux communs : les insights, apprentissages et patterns que tu génères en itérant — la connaissance sur *comment construire*, pas ce que tu construis. C'est cette connaissance qui est centralisée dans le registre et redistribuée à toutes les instances pour faire progresser collectivement l'art de construire des outils de production avec l'IA.
+
+---
+
+## Article 2 — Déclencheur de l'obligation de retour
+
+L'obligation de retour s'active dès que les deux conditions suivantes sont réunies :
+
+1. L'**instance** est **utilisable** — elle produit des résultats exploitables dans un contexte réel
+2. Une **première itération** a été réalisée en réponse à cet usage réel
+
+L'itération est la preuve que de la connaissance a été produite. Tant qu'aucune itération n'a eu lieu, la méthode est en phase d'évaluation et aucune obligation ne s'applique.
+
+---
+
+## Article 3 — Objet du retour
+
+Tu contribues aux communs le delta de connaissance qui a motivé l'itération. Ce dépôt REX doit contenir au minimum :
+
+- **Contexte** : la situation d'usage, le domaine, l'échelle
+- **Observation** : le problème identifié ou l'apprentissage réalisé
+- **Décision** : ce qui a été modifié et pourquoi
+- **Effet** : la conséquence observée — même partielle, même négative, même incertaine
+
+Un retour honnête sur un échec vaut autant qu'un retour sur un succès. Les effets non observés encore peuvent être déclarés comme tels.
+
+---
+
+## Article 4 — Destination et format
+
+Le dépôt REX est déposé dans le **registre MCP désigné par la licence**.
+
+Il devient interrogeable par tous les utilisateurs de la méthode via le protocole MCP, sans restriction d'accès en lecture.
+
+**Format :**
+- Format préféré : OWL/Turtle validé par les shapes IKCL (voir Annexe A)
+- Format accepté : JSON structuré conforme au schéma REX publié
+- Format minimal : langage naturel balisé (`contexte:` / `observation:` / `décision:` / `effet:`)
+
+Le dépôt est généré par l'agent LLM au moment de l'itération et soumis au registre sans intervention humaine. La conformité est vérifiée automatiquement par le validateur SHACL du registre. Un dépôt rejeté par le validateur n'est pas comptabilisé.
+
+---
+
+## Article 5 — Restriction commerciale
+
+La licence n'autorise pas la vente d'un produit ou service dont la valeur principale dérive substantiellement de la méthode elle-même.
+
+Sont notamment interdits sans accord explicite du détenteur de la marque :
+
+- Vendre une formation dont le contenu central est la méthode
+- Vendre une certification de conformité à la méthode
+- Exploiter commercialement un registre MCP concurrent distribuant le même corpus
+- Redistribuer la méthode comme composant principal d'une offre commerciale tierce
+
+L'usage de la méthode comme *outil* pour produire de la valeur dans un autre domaine reste libre et n'est pas concerné par cet article.
+
+---
+
+## Article 6 — Certification et marque
+
+Seules les implémentations ayant satisfait l'Article 3 peuvent :
+
+- Se réclamer conformes à la méthode
+- Utiliser le nom et la marque associés à la méthode
+- Figurer dans le registre des implémentations certifiées
+
+La conformité est vérifiée par le graphe, pas par une autorité centrale. Déclarer une implémentation dans le registre sans dépôt REX valide constitue une violation de cette licence.
+
+---
+
+## Article 7 — Accès différencié au registre MCP
+
+L'accès au registre MCP est structuré en trois niveaux déterminés automatiquement par le graphe :
+
+### Free — Observateur
+- Accès en lecture au corpus public de la méthode (ontologie, niveaux, shapes)
+- Accès en lecture aux REX publics du registre, avec délai de 90 jours
+- Pas d'écriture, pas de support
+
+### Community — Praticien
+- Débloqué automatiquement par ≥ 1 dépôt REX valide dans le registre
+- La validation est effectuée par le SHACL du registre — aucune approbation humaine requise
+- Accès en lecture/écriture au registre MCP
+- Accès aux REX agrégés et aux patterns extraits des contributions, avec délai de 30 jours
+- Support communautaire
+
+### Pro — Praticien avancé / Équipe
+- Période d'essai : 30 jours ou jusqu'au premier dépôt REX valide, selon ce qui arrive en premier
+- Tout le niveau Community, plus :
+- Accès aux REX en temps réel — sans délai
+- **Accompagnement à la construction du Cognitive OS** : support actif pour structurer l'instance SDD, définir l'ontologie du domaine, amorcer le registre REX privé — on construit avec toi, pas juste à côté
+- Support avec engagement de réponse
+- **Namespace privé** : capture et partage sélectif de REX sans obligation de dépôt public — les REX privés ne débloquent pas l'accès Community mais restent disponibles comme brouillons avant décision de publication
+- Namespace partagé entre membres pour les usages équipe — même feature, même namespace, plusieurs instances connectées simultanément
+- Portabilité LLM garantie par le graphe OWL/SHACL — changer de modèle ne perd rien
+- Accès au corpus de prompts curé
+
+Le niveau Pro s'adapte à l'échelle : individu ou équipe, le produit est identique — seul le nombre de membres connectés au namespace varie.
+
+### Enterprise — Actif numérique auditable
+
+Tout le niveau Pro, plus :
+
+**Audit de l'outil de production**
+- Analyse du graphe de la base de code : niveau SDD atteint, gaps, dette sémantique
+- Qualité, sécurité, testabilité, observabilité — mesurés par le graphe, pas par des interviews
+- Modules spécialisés selon le type d'actif (web, API, infrastructure, domaine)
+
+**Audit de l'OS cognitif**
+- Niveau SDD de l'instance organisationnelle (L0→L7)
+- Densité et qualité des REX — proxy de la capacité d'apprentissage collectif
+- Continuité : ce qui survit aux départs d'équipe
+- Transmissibilité : ce qui est portable en cas de cession ou d'acquisition
+
+**Score d'actif numérique unifié**
+- Synthèse des deux audits en un score opposable
+- Référentiel IAS 38 (actifs incorporels) et reporting intégré (IIRC/GRI)
+- Artefact immuable émis dans le registre public — vérifiable par tout tiers sans intermédiaire
+- Score vivant : interrogeable à tout moment via MCP, pas un rapport annuel figé
+
+La preuve est dans le graphe. Pas un cabinet qui produit des slides — une chaîne de preuve vérifiable par quiconque a accès au registre.
+
+Aucune autorité centrale n'arbitre l'accès. Le graphe décide selon les dépôts validés.
+
+---
+
+## Article 8 — Intégrité de la chaîne de preuve
+
+Tout dépôt REX est immuable une fois validé. Il peut être complété (effet constaté a posteriori) mais pas supprimé ni modifié rétroactivement.
+
+L'historique des contributions est public et vérifiable. La chaîne de preuve est elle-même une ressource des communs.
+
+---
+
+## Article 9 — Auto-application
+
+Cette licence est elle-même produite sous IKCL.
+
+La méthode SDD est une instance de SDD. La IKCL est une instance de la IKCL. Toute évolution de cette licence est soumise aux mêmes obligations que celles qu'elle impose — les insights qui motivent sa révision sont déposés dans le registre, la chaîne de preuve est publique, les décisions sont tracées.
+
+Ce n'est pas une clause symbolique. C'est la condition de cohérence du système : une méthode qui ne s'applique pas à elle-même ne mérite pas d'être appliquée par d'autres.
+
+---
+
+## Annexe A — Prompt de sanitisation canonique
+
+Le prompt suivant est une pièce normative de la méthode. Il est distribué via le registre MCP et évolue comme le reste du corpus — par dépôt REX.
+
+Il s'exécute **avant** tout dépôt dans le registre. Le praticien valide le diff produit avant envoi. Aucun dépôt automatique sans validation humaine.
+
+```
+Tu es un agent de sanitisation IKCL.
+
+À partir du contexte d'itération fourni, extrais le delta de connaissance utile aux communs.
+
+Supprime systématiquement :
+- noms propres (personnes, entreprises, clients, partenaires)
+- domaines métier identifiables (secteur, taille, géographie précise)
+- données chiffrées précises (volumes, revenus, effectifs)
+- noms d'outils propriétaires ou internes
+- toute information permettant d'identifier l'organisation ou le projet
+
+Conserve :
+- le problème structurel rencontré
+- la décision prise et son raisonnement
+- l'effet observé, même partiel, même négatif, même incertain
+- le niveau SDD concerné et le contexte technique générique
+
+Produit un REX structuré conforme au schéma IKCL :
+
+contexte: [situation d'usage généralisée, domaine flou, échelle approximative]
+observation: [problème identifié ou apprentissage réalisé]
+décision: [ce qui a été modifié et pourquoi]
+effet: [conséquence observée — ou "non encore observable" si trop tôt]
+
+Un retour honnête sur un échec vaut autant qu'un retour sur un succès.
+```
+
+Le praticien valide le REX sanitisé avant envoi. En cas de doute sur un élément résiduel, le supprimer plutôt que le conserver.
+
+---
+
+## Annexe B — Shapes SHACL
+
+> **Source de vérité : [`ikcl-shapes.ttl`](ikcl-shapes.ttl)**
+>
+> Ce fichier n'est plus la source de vérité des shapes. L'Annexe B initiale (shapes minimales) a été supersédée par l'overlay graphe complet. `ikcl-shapes.ttl` est l'implémentation normative — validable par `pyshacl`, versionnable, interrogeable via MCP.
+>
+> Ce document est généré depuis le graphe. En cas de divergence, le graphe fait foi.
+
+---
+
+## Annexe C — Cycle de vie RGPD des dépôts REX
+
+### Contexte
+
+Le registre MCP collecte des dépôts REX qui peuvent contenir des données personnelles : contexte d'usage impliquant des projets clients, observations sur des systèmes tiers, identité implicite du praticien. Le registre est un **responsable de traitement** au sens de l'Art. 4 RGPD.
+
+### Traitement déclaré
+
+| Champ | Valeur |
+|---|---|
+| **Finalité** | Enrichissement du corpus commun de la méthode — redistribution des patterns d'apprentissage à tous les praticiens |
+| **Base légale** | Contrat IKCL (Art. 6.1.b) — l'obligation de retour est explicitement acceptée lors de l'adoption |
+| **Données collectées** | Contexte d'usage, observations, décisions, effets déclarés — sans obligation d'identifier le praticien |
+| **Durée de conservation** | Indéterminée — immuabilité structurelle (Art. 8 IKCL) |
+| **Destinataires** | Tous les praticiens de niveau Community et Pro ayant accès au registre MCP |
+
+### Tension structurelle : immuabilité IKCL ↔ droit à l'effacement RGPD
+
+L'Art. 8 IKCL déclare les dépôts immuables une fois validés. L'Art. 17 RGPD accorde aux personnes concernées un droit à l'effacement. Ces deux obligations sont incompatibles si le dépôt contient des données personnelles nominatives.
+
+**Résolution retenue** : le dépôt n'efface pas, il **anonymise**.
+
+1. **Avant dépôt** : le praticien (ou l'agent LLM qui génère le dépôt) anonymise les données personnelles — noms de clients, projets commerciaux identifiants, emails — avant soumission. L'anonymisation est une condition de validité du dépôt (voir agent de sanitisation, Annexe A).
+2. **Sur demande** : si une donnée personnelle a malgré tout été intégrée dans un dépôt validé, le registre procède à l'anonymisation du champ concerné. L'entrée reste dans le graphe avec un marqueur `ikcl:anonymisé = true` et un horodatage.
+3. **Ce qui ne peut pas être effacé** : la structure du dépôt (existence, date, hash de validation) — nécessaire à l'intégrité de la chaîne de preuve. La connaissance elle-même, anonymisée, reste dans les communs.
+
+### Droits exercés par les praticiens
+
+| Droit | Modalité |
+|---|---|
+| Accès | Via l'interface MCP — le praticien accède à ses propres dépôts |
+| Rectification | Non applicable (immuabilité) — seul le champ `ikcl:note` peut être complété a posteriori |
+| Effacement | Anonymisation du dépôt sur demande — pas de suppression |
+| Portabilité | Export JSON ou Turtle de ses dépôts via le registre |
+| Opposition | Non applicable — la contribution est un engagement contractuel explicite |
+
+### Implications pour les implémentations
+
+Toute implémentation qui génère des dépôts REX automatiquement (agent LLM) doit :
+- Filtrer les données personnelles avant soumission (agent de sanitisation)
+- Informer le praticien de l'immuabilité avant le premier dépôt
+- Déclarer ce traitement dans son ontologie locale (`ndd:TraitementRegistreMCP` ou équivalent)
+
+---
+
+## À fixer avant publication
+
+- [ ] Nom du registre MCP désigné — déclarer `ikcl:Registre` dans `ikcl-shapes.ttl` avec l'URI du endpoint MCP KAAS
+- [x] Shapes SHACL formalisées — `ikcl-shapes.ttl` (overlay graphe SDD, validé pyshacl, 2026-05-01)
+- [x] Schéma REX — 4 champs formalisés dans `ikcl:KnowledgeDeposit` (`ikcl-shapes.ttl`)
+- [ ] Nom et dépôt de la marque protégée
+- [ ] Validation juridique de la tension immuabilité ↔ Art. 17 RGPD (Annexe C)
+- [ ] Article 10 — Redistribution contributive : % des revenus Enterprise reversé aux contributeurs dont les REX sont les plus utiles (mesure par le graphe — lectures, citations, patterns extraits) — à calibrer avec la communauté
+
+---
+
+*IKCL v0.1 — Iterative Knowledge Commons License*
+*Conçue comme une instance de Semantic-Driven Development — la conformité à cette licence est elle-même vérifiable par le graphe.*

erotetique-0.1.0/MANIFEST.in

@@ -0,0 +1,11 @@
+include README.md
+include LICENCE.md
+recursive-include erotetique/ontology *.ttl
+recursive-include erotetique *.py
+global-exclude *.pyc
+global-exclude __pycache__
+global-exclude .DS_Store
+exclude-dir connaissance
+exclude-dir docs
+exclude-dir tests
+exclude-dir scripts

erotetique-0.1.0/PKG-INFO

@@ -0,0 +1,167 @@
+Metadata-Version: 2.4
+Name: erotetique
+Version: 0.1.0
+Summary: Préprocesseur érotétique — prétraitement formel des questions avant le moteur de réponse
+Author-email: Luc Bizeul <lbizeul@gmail.com>
+License: IKCL-0.1
+License-File: LICENCE.md
+Keywords: erotetique,mcp,ontology,question-engineering,sdd
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: French
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.11
+Requires-Dist: pyshacl>=0.25
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: rdflib>=7.0
+Provides-Extra: rag
+Requires-Dist: pypdf>=4.0; extra == 'rag'
+Requires-Dist: python-docx>=0.8.11; extra == 'rag'
+Requires-Dist: rank-bm25>=0.2.2; extra == 'rag'
+Description-Content-Type: text/markdown
+
+# Préprocesseur érotétique
+
+*Les LLM ont résolu le problème de la réponse — la capacité d'exécution est quasi-illimitée.*
+*Le goulot est désormais la question : pour la première fois dans l'histoire, l'outil dépasse structurellement la capacité de spécification de celui qui s'en sert.*
+
+→ [Manifeste](docs/manifeste.md) · [Livre blanc](docs/livre-blanc.md)
+
+| Format | Fichier | Statut |
+|---|---|---|
+| F1 — Positioning Statement | [docs/positioning-statement.md](docs/positioning-statement.md) | brouillon |
+| F3 — Manifeste | [docs/manifeste.md](docs/manifeste.md) | brouillon |
+| F5 — Livre blanc | [docs/livre-blanc.md](docs/livre-blanc.md) | brouillon |
+| G0 — Ontologie | [ontology/erotetique.ttl](ontology/erotetique.ttl) | brouillon |
+| CQ — Competency Questions | [ontology/cq-erotetique.ttl](ontology/cq-erotetique.ttl) | brouillon |
+| I1 — Howard (1966) VoI | [docs/references/i1-howard-1966-voi.md](docs/references/i1-howard-1966-voi.md) | brouillon |
+| I1 — Lindley (1956) gain d'information | [docs/references/i1-lindley-1956.md](docs/references/i1-lindley-1956.md) | brouillon |
+| I1 — Grüninger & Fox (1995) CQ | [docs/references/i1-gruninger-fox-1995-cq.md](docs/references/i1-gruninger-fox-1995-cq.md) | brouillon |
+| I1 — Wiśniewski, logique érotétique | [docs/references/i1-wisniewski-erotetic-logic.md](docs/references/i1-wisniewski-erotetic-logic.md) | brouillon |
+| I1 — Belnap & Steel (1976) | [docs/references/i1-belnap-steel-1976.md](docs/references/i1-belnap-steel-1976.md) | brouillon |
+| I1 — Groenendijk & Roelofsen (2009) | [docs/references/i1-groenendijk-roelofsen-2009.md](docs/references/i1-groenendijk-roelofsen-2009.md) | brouillon |
+| I1 — Popper (1959) falsifiabilité | [docs/references/i1-popper-1959.md](docs/references/i1-popper-1959.md) | brouillon |
+| I1 — Lakatos (1978) programmes de recherche | [docs/references/i1-lakatos-1978.md](docs/references/i1-lakatos-1978.md) | brouillon |
+| I1 — Dillon (1990) pratique du questionnement | [docs/references/i1-dillon-1990.md](docs/references/i1-dillon-1990.md) | brouillon |
+| I1 — Settles (2010) active learning | [docs/references/i1-settles-2010-active-learning.md](docs/references/i1-settles-2010-active-learning.md) | brouillon |
+| I1 — Ohno (1978) 5 pourquoi | [docs/references/i1-ohno-1978-5pourquoi.md](docs/references/i1-ohno-1978-5pourquoi.md) | brouillon |
+| Carte corpus — 7 strates | [docs/references/strates-corpus-erotetique.md](docs/references/strates-corpus-erotetique.md) | brouillon |
+
+---
+
+## Architecture
+
+```
+ontology/erotetique.ttl          ← G0 source de vérité (dimensions, quadrants, outils, opérations)
+ontology/erotetique-shapes.ttl   ← contraintes SHACL
+ontology/cq-erotetique.ttl       ← 7 Competency Questions SPARQL
+
+erotetique/
+  classifier.py   ← lit quadrants depuis Turtle, classification linguistique
+  soundness.py    ← extraction heuristique présupposés
+  augmenter.py    ← lit dimensions depuis Turtle, génère prompt dynamique
+  server.py       ← MCP JSON-RPC stdio
+```
+
+**Invariant SDD** — le code ne connaît ni les dimensions ni les quadrants. Tout est lu depuis le Turtle au runtime. Ajouter une dimension dans `erotetique.ttl` = elle apparaît dans l'analyse sans toucher au Python (`test_sdd_acid_test` le vérifie).
+
+---
+
+## Installation
+
+```bash
+uv sync
+uv run pytest        # 67 tests
+```
+
+Claude Desktop — `~/Library/Application Support/Claude/claude_desktop_config.json` :
+
+```json
+{
+  "mcpServers": {
+    "erotetique": {
+      "command": "/opt/homebrew/bin/uv",
+      "args": ["run", "--project", "/Users/luc/Projets/erotetique", "python", "-m", "erotetique.server"],
+      "env": { "HOME": "/Users/luc" }
+    }
+  }
+}
+```
+
+---
+
+## Usage as Python Library
+
+Install from PyPI:
+
+```bash
+pip install erotetique
+```
+
+Or locally (editable mode for development):
+
+```bash
+pip install -e /path/to/erotetique
+```
+
+Basic usage:
+
+```python
+from erotetique import classify_question, check_soundness, valorize_question
+from pathlib import Path
+
+# Locate ontology (installed as package data)
+ontology = Path(__file__).parent / "erotetique" / "ontology" / "erotetique.ttl"
+
+question = "Pourquoi notre chiffre d'affaires a-t-il baissé ?"
+
+# Classify into ignorance quadrant (KK/KU/UK/UU)
+result = classify_question(question, ontology)
+print(f"Quadrant: {result.quadrant_label}")
+print(f"Action: {result.action}")
+
+# Check soundness and extract presuppositions
+soundness = check_soundness(question)
+print(f"Sound: {soundness.sound}")
+for p in soundness.presuppositions[:3]:
+    print(f"  • {p.text}")
+
+# Estimate value of information (two proxies)
+voi = valorize_question(question, result, ontology)
+print(f"VoI score (proxy 1 — decisional sensitivity): {voi.score:.2f}")
+print(f"VoI score (proxy 2 — prior entropy): {voi.proxy2_score:.2f}")
+print(f"Prescribed operations: {', '.join(voi.prescribed_operations)}")
+```
+
+### Key Types
+
+- **`ClassificationResult`** — quadrant URI, label, rationale, action
+- **`SoundnessResult`** — `sound: bool`, `presuppositions: list[PresuppositionCheck]`
+- **`VoIEstimate`** — `score: float`, `proxy2_score: float`, `prescribed_operations: list[str]`, `rationale: str`
+
+### Architecture
+
+All logic is **deterministic, LLM-free, zero network**:
+
+- **Classifier** reads quadrant definitions from ontology at runtime (SDD invariant)
+- **Soundness** extracts presuppositions heuristically (linguistic patterns)
+- **Valorizer** estimates VoI via two proxies:
+  - **Proxy 1**: Decision-marker sensitivity (choisir, sélectionner, décider keywords → VoI ↑)
+  - **Proxy 2**: Prior entropy of answer distribution (enumerable answers → low entropy; causal questions → high entropy)
+
+---
+
+## Stack
+
+| Composant | Techno |
+|---|---|
+| Ontologie | Turtle — `rdflib` |
+| Validation | SHACL — `pyshacl` |
+| Classification | Linguistique pure — `re` |
+| MCP | JSON-RPC stdio |
+| LLM | Claude Desktop (le client *est* le LLM) |
+
+Zéro clé API. Zéro base externe. Zéro dépendance réseau au runtime.

erotetique-0.1.0/README.md

@@ -0,0 +1,142 @@
+# Préprocesseur érotétique
+
+*Les LLM ont résolu le problème de la réponse — la capacité d'exécution est quasi-illimitée.*
+*Le goulot est désormais la question : pour la première fois dans l'histoire, l'outil dépasse structurellement la capacité de spécification de celui qui s'en sert.*
+
+→ [Manifeste](docs/manifeste.md) · [Livre blanc](docs/livre-blanc.md)
+
+| Format | Fichier | Statut |
+|---|---|---|
+| F1 — Positioning Statement | [docs/positioning-statement.md](docs/positioning-statement.md) | brouillon |
+| F3 — Manifeste | [docs/manifeste.md](docs/manifeste.md) | brouillon |
+| F5 — Livre blanc | [docs/livre-blanc.md](docs/livre-blanc.md) | brouillon |
+| G0 — Ontologie | [ontology/erotetique.ttl](ontology/erotetique.ttl) | brouillon |
+| CQ — Competency Questions | [ontology/cq-erotetique.ttl](ontology/cq-erotetique.ttl) | brouillon |
+| I1 — Howard (1966) VoI | [docs/references/i1-howard-1966-voi.md](docs/references/i1-howard-1966-voi.md) | brouillon |
+| I1 — Lindley (1956) gain d'information | [docs/references/i1-lindley-1956.md](docs/references/i1-lindley-1956.md) | brouillon |
+| I1 — Grüninger & Fox (1995) CQ | [docs/references/i1-gruninger-fox-1995-cq.md](docs/references/i1-gruninger-fox-1995-cq.md) | brouillon |
+| I1 — Wiśniewski, logique érotétique | [docs/references/i1-wisniewski-erotetic-logic.md](docs/references/i1-wisniewski-erotetic-logic.md) | brouillon |
+| I1 — Belnap & Steel (1976) | [docs/references/i1-belnap-steel-1976.md](docs/references/i1-belnap-steel-1976.md) | brouillon |
+| I1 — Groenendijk & Roelofsen (2009) | [docs/references/i1-groenendijk-roelofsen-2009.md](docs/references/i1-groenendijk-roelofsen-2009.md) | brouillon |
+| I1 — Popper (1959) falsifiabilité | [docs/references/i1-popper-1959.md](docs/references/i1-popper-1959.md) | brouillon |
+| I1 — Lakatos (1978) programmes de recherche | [docs/references/i1-lakatos-1978.md](docs/references/i1-lakatos-1978.md) | brouillon |
+| I1 — Dillon (1990) pratique du questionnement | [docs/references/i1-dillon-1990.md](docs/references/i1-dillon-1990.md) | brouillon |
+| I1 — Settles (2010) active learning | [docs/references/i1-settles-2010-active-learning.md](docs/references/i1-settles-2010-active-learning.md) | brouillon |
+| I1 — Ohno (1978) 5 pourquoi | [docs/references/i1-ohno-1978-5pourquoi.md](docs/references/i1-ohno-1978-5pourquoi.md) | brouillon |
+| Carte corpus — 7 strates | [docs/references/strates-corpus-erotetique.md](docs/references/strates-corpus-erotetique.md) | brouillon |
+
+---
+
+## Architecture
+
+```
+ontology/erotetique.ttl          ← G0 source de vérité (dimensions, quadrants, outils, opérations)
+ontology/erotetique-shapes.ttl   ← contraintes SHACL
+ontology/cq-erotetique.ttl       ← 7 Competency Questions SPARQL
+
+erotetique/
+  classifier.py   ← lit quadrants depuis Turtle, classification linguistique
+  soundness.py    ← extraction heuristique présupposés
+  augmenter.py    ← lit dimensions depuis Turtle, génère prompt dynamique
+  server.py       ← MCP JSON-RPC stdio
+```
+
+**Invariant SDD** — le code ne connaît ni les dimensions ni les quadrants. Tout est lu depuis le Turtle au runtime. Ajouter une dimension dans `erotetique.ttl` = elle apparaît dans l'analyse sans toucher au Python (`test_sdd_acid_test` le vérifie).
+
+---
+
+## Installation
+
+```bash
+uv sync
+uv run pytest        # 67 tests
+```
+
+Claude Desktop — `~/Library/Application Support/Claude/claude_desktop_config.json` :
+
+```json
+{
+  "mcpServers": {
+    "erotetique": {
+      "command": "/opt/homebrew/bin/uv",
+      "args": ["run", "--project", "/Users/luc/Projets/erotetique", "python", "-m", "erotetique.server"],
+      "env": { "HOME": "/Users/luc" }
+    }
+  }
+}
+```
+
+---
+
+## Usage as Python Library
+
+Install from PyPI:
+
+```bash
+pip install erotetique
+```
+
+Or locally (editable mode for development):
+
+```bash
+pip install -e /path/to/erotetique
+```
+
+Basic usage:
+
+```python
+from erotetique import classify_question, check_soundness, valorize_question
+from pathlib import Path
+
+# Locate ontology (installed as package data)
+ontology = Path(__file__).parent / "erotetique" / "ontology" / "erotetique.ttl"
+
+question = "Pourquoi notre chiffre d'affaires a-t-il baissé ?"
+
+# Classify into ignorance quadrant (KK/KU/UK/UU)
+result = classify_question(question, ontology)
+print(f"Quadrant: {result.quadrant_label}")
+print(f"Action: {result.action}")
+
+# Check soundness and extract presuppositions
+soundness = check_soundness(question)
+print(f"Sound: {soundness.sound}")
+for p in soundness.presuppositions[:3]:
+    print(f"  • {p.text}")
+
+# Estimate value of information (two proxies)
+voi = valorize_question(question, result, ontology)
+print(f"VoI score (proxy 1 — decisional sensitivity): {voi.score:.2f}")
+print(f"VoI score (proxy 2 — prior entropy): {voi.proxy2_score:.2f}")
+print(f"Prescribed operations: {', '.join(voi.prescribed_operations)}")
+```
+
+### Key Types
+
+- **`ClassificationResult`** — quadrant URI, label, rationale, action
+- **`SoundnessResult`** — `sound: bool`, `presuppositions: list[PresuppositionCheck]`
+- **`VoIEstimate`** — `score: float`, `proxy2_score: float`, `prescribed_operations: list[str]`, `rationale: str`
+
+### Architecture
+
+All logic is **deterministic, LLM-free, zero network**:
+
+- **Classifier** reads quadrant definitions from ontology at runtime (SDD invariant)
+- **Soundness** extracts presuppositions heuristically (linguistic patterns)
+- **Valorizer** estimates VoI via two proxies:
+  - **Proxy 1**: Decision-marker sensitivity (choisir, sélectionner, décider keywords → VoI ↑)
+  - **Proxy 2**: Prior entropy of answer distribution (enumerable answers → low entropy; causal questions → high entropy)
+
+---
+
+## Stack
+
+| Composant | Techno |
+|---|---|
+| Ontologie | Turtle — `rdflib` |
+| Validation | SHACL — `pyshacl` |
+| Classification | Linguistique pure — `re` |
+| MCP | JSON-RPC stdio |
+| LLM | Claude Desktop (le client *est* le LLM) |
+
+Zéro clé API. Zéro base externe. Zéro dépendance réseau au runtime.