mobius-charles 0.3.0__tar.gz

mobius_charles-0.3.0/PKG-INFO

@@ -0,0 +1,178 @@
+Metadata-Version: 2.4
+Name: mobius-charles
+Version: 0.3.0
+Summary: Local-first AI workflow CLI with event-sourced runs and deterministic agent routing.
+Keywords: ai-agents,cli,event-sourcing,local-first,workflow
+Author: Mobius contributors
+License-Expression: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Dist: pydantic>=2.12.0
+Requires-Dist: rich>=14.0.0
+Requires-Dist: typer>=0.20.0
+Requires-Python: >=3.12
+Project-URL: Homepage, https://github.com/charlescstpierr/mobius-charles
+Project-URL: Repository, https://github.com/charlescstpierr/mobius-charles
+Project-URL: Issues, https://github.com/charlescstpierr/mobius-charles/issues
+Project-URL: Changelog, https://github.com/charlescstpierr/mobius-charles/blob/main/CHANGELOG.md
+Description-Content-Type: text/markdown
+
+# Mobius
+
+[![CI](https://github.com/charlescstpierr/mobius-charles/actions/workflows/ci.yml/badge.svg)](https://github.com/charlescstpierr/mobius-charles/actions/workflows/ci.yml)
+[![Coverage](https://img.shields.io/badge/coverage-%E2%89%A595%25-brightgreen.svg)](docs/benchmarks.md)
+[![PyPI](https://img.shields.io/pypi/v/mobius-charles.svg)](https://pypi.org/project/mobius-charles/)
+[![License](https://img.shields.io/github/license/charlescstpierr/mobius-charles)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.12%2B-blue.svg)](pyproject.toml)
+
+Mobius est une CLI Python **local-first, auditable et déterministe** pour piloter des agents IA. Event sourcing SQLite, lineage rejouable, routage d'agent offline (PAL Router) — zéro serveur, zéro dépendance réseau. Un **chemin débutant en une commande** :
+
+```sh
+mobius go "je veux une app de recettes"
+```
+
+Cette commande clarifie l'idée, écrit `spec.yaml`, crée le seed, lance un run, puis vous indique les prochaines commandes lisibles (`mobius status`, `mobius qa`, `mobius ralph`). Quand l'exécution est activée, `go` transmet l'approbation agent au run généré par défaut; utilisez `--ask-agent` pour reprendre une validation explicite.
+
+> **Event sourcing** — chaque décision, chaque run, chaque évaluation est un événement immuable dans SQLite (WAL). Rejouez n'importe quel état passé avec `mobius lineage`.
+>
+> **PAL Router** — routage déterministe offline vers l'agent optimal (claude, codex, droid) sans appel LLM. `--agent auto --approve-agent` résout localement.
+>
+> **Transparence totale** — le code réel reste exécuté par votre agent choisi ou vos commandes locales; Mobius orchestre le happy path et trace les preuves. Pas de serveur, pas de LLM caché.
+
+## Installation
+
+Paquet public PyPI (nom de distribution: `mobius-charles`, commande installée: `mobius`) :
+
+```bash
+uv tool install mobius-charles
+```
+
+```bash
+mobius --help
+```
+
+Chemins équivalents :
+
+```sh
+pipx install mobius-charles
+# ou depuis un checkout de développement
+uv tool install . --force
+./install.sh
+```
+
+Puis démarrez le chemin débutant :
+
+```sh
+mobius go "mon idée"
+```
+
+## Répertoire d'état
+
+Mobius stocke l'état dans SQLite à `$MOBIUS_HOME/events.db`. Sans `MOBIUS_HOME`, le chemin par défaut est `~/.mobius/events.db`, partagé entre les projets (`shared across every Mobius project`). Pour isoler un workspace :
+
+```sh
+export MOBIUS_HOME="$PWD/.mobius"
+```
+
+`mobius init` affiche le chemin résolu et `mobius config get event_store` le retourne à tout moment.
+
+## Démarrage rapide
+
+```sh
+uv tool install mobius-charles
+mobius go "je veux une petite CLI qui salue l'utilisateur"
+mobius status
+mobius qa
+mobius ralph --dry-run
+```
+
+Chemin CI/script avancé :
+
+```bash
+export MOBIUS_HOME="$(mktemp -d)"  # optionnel: isole l'état
+cat > /tmp/mobius-fixture.yaml <<'YAML'
+project_type: greenfield
+goal: Livrer un petit test de fumée CLI.
+constraints:
+  - Garder tout l'état dans le MOBIUS_HOME temporaire.
+  - Éviter les services réseau.
+success:
+  - Interview écrit une spec.
+  - Seed crée une session.
+  - Run se termine avec succès.
+YAML
+mobius interview --non-interactive --input /tmp/mobius-fixture.yaml --output /tmp/mobius-spec.yaml
+mobius seed /tmp/mobius-spec.yaml --json
+run_id="$(mobius run --spec /tmp/mobius-spec.yaml)"
+mobius status "$run_id" --follow
+```
+
+Pour démarrer un vrai workspace :
+
+```sh
+mobius go "mon idée de projet"
+```
+
+## Commandes principales
+
+- `mobius interview` — entretien projet interactif (modes deep, quick, conversationnel) avec juge interne à 3 lentilles (Clarté, Risques, Faisabilité), breadth keeper par questions-ponts, et persistance par tour.
+- `mobius seed` — valide une spec et crée une session seed.
+- `mobius run` — exécute avec un agent (`--agent codex --model gpt-5.5`, `--agent claude`, `--agent droid`). Chaque run est isolé dans un git worktree pour permettre l'exécution parallèle.
+- `mobius status` — affiche la santé globale ou le statut d'un run.
+- `mobius qa [RUN_ID]` — évalue un run avec un juge local déterministe.
+- `mobius evolve [RUN_ID]` — lance une boucle d'évolution depuis un run existant.
+- `mobius cancel RUN_ID` — annule un run détaché et nettoie son PID.
+- `mobius lineage [AGGREGATE_ID]` — affiche les ancêtres, descendants ou le hash de replay.
+- `mobius init` — crée un `spec.yaml` de départ et initialise l'event store.
+- `mobius setup` — installe les assets d'intégration agent.
+- `mobius config` — affiche, lit ou modifie la configuration Mobius.
+- `mobius handoff` — génère un prompt versionné pour un agent de code.
+- `mobius hud` — tableau de bord basé sur les projections.
+
+Commandes avancées :
+
+- `mobius build` — compose une première spec guidée depuis une idée.
+- `mobius projection` — gère le cache de projections.
+- `mobius cold-start` — mesure le budget de démarrage à froid.
+
+## Exécution parallèle
+
+Chaque `mobius run` isole automatiquement l'agent dans un **git worktree** dédié. Cela permet de lancer plusieurs runs en parallèle sans conflit :
+
+```sh
+mobius run --spec spec-auth.yaml --agent codex --model gpt-5.5 --approve-agent
+mobius run --spec spec-ui.yaml --agent codex --model gpt-5.5 --approve-agent
+mobius run --spec spec-api.yaml --agent claude --model opus-4.7 --approve-agent
+# Les 3 tournent en parallèle, chacun dans son propre espace.
+```
+
+## Interview Deep améliorée
+
+Le mode `--mode deep` inclut :
+
+- **Persistance par tour** — chaque round est sauvegardé dans un fichier JSON incrémental. Un crash ne perd aucune donnée.
+- **Juge interne à 3 lentilles** — Clarté (Socrate), Risques (Avocat), Faisabilité (Architecte). Le juge guide silencieusement le choix des questions et hausse le ton quand un problème est détecté.
+- **Breadth keeper** — si un axe thématique est touché 2 fois de suite, une question-pont connecte naturellement vers un axe non couvert.
+- **Recommandations argumentées** — chaque question inclut la recommandation de Mobius avant de demander l'avis de l'utilisateur.
+- **Reprise après crash** — détection automatique d'une interview interrompue avec 3 choix (reprendre / recommencer / voir le résumé).
+
+## Préparation release PyPI
+
+Avant publication, sans effet externe :
+
+1. Vérifier que le nom PyPI public est libre/choisi : `mobius-charles` (le nom `mobius` est déjà pris sur PyPI).
+2. Vérifier les métadonnées : `uv build --out-dir /tmp/mobius-dist`.
+3. Valider les artefacts : `uvx twine check /tmp/mobius-dist/*`.
+4. Installer le wheel dans un environnement propre et lancer `mobius --help`.
+5. Tester les assets sans écrire : `mobius setup --runtime claude|codex|hermes --dry-run`.
+6. Vérifier l'authentification de publication sans contacter PyPI : `uv run python scripts/verify_publish_auth.py`.
+7. Publier seulement après GO explicite, idéalement via GitHub Actions `Publish PyPI` + PyPI Trusted Publishing. En local seulement si token disponible : `uv publish --token "$PYPI_TOKEN" /tmp/mobius-dist/*`.
+8. Après publication, vérifier le paquet réellement publié : `uv run python scripts/verify_post_publish.py --version 0.3.0`.
+
+Voir aussi [`docs/cli-reference.md`](docs/cli-reference.md), [`CHANGELOG.md`](CHANGELOG.md), [`CONTRIBUTING.md`](CONTRIBUTING.md) et [`SECURITY.md`](SECURITY.md).

mobius_charles-0.3.0/README.md

@@ -0,0 +1,153 @@
+# Mobius
+
+[![CI](https://github.com/charlescstpierr/mobius-charles/actions/workflows/ci.yml/badge.svg)](https://github.com/charlescstpierr/mobius-charles/actions/workflows/ci.yml)
+[![Coverage](https://img.shields.io/badge/coverage-%E2%89%A595%25-brightgreen.svg)](docs/benchmarks.md)
+[![PyPI](https://img.shields.io/pypi/v/mobius-charles.svg)](https://pypi.org/project/mobius-charles/)
+[![License](https://img.shields.io/github/license/charlescstpierr/mobius-charles)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.12%2B-blue.svg)](pyproject.toml)
+
+Mobius est une CLI Python **local-first, auditable et déterministe** pour piloter des agents IA. Event sourcing SQLite, lineage rejouable, routage d'agent offline (PAL Router) — zéro serveur, zéro dépendance réseau. Un **chemin débutant en une commande** :
+
+```sh
+mobius go "je veux une app de recettes"
+```
+
+Cette commande clarifie l'idée, écrit `spec.yaml`, crée le seed, lance un run, puis vous indique les prochaines commandes lisibles (`mobius status`, `mobius qa`, `mobius ralph`). Quand l'exécution est activée, `go` transmet l'approbation agent au run généré par défaut; utilisez `--ask-agent` pour reprendre une validation explicite.
+
+> **Event sourcing** — chaque décision, chaque run, chaque évaluation est un événement immuable dans SQLite (WAL). Rejouez n'importe quel état passé avec `mobius lineage`.
+>
+> **PAL Router** — routage déterministe offline vers l'agent optimal (claude, codex, droid) sans appel LLM. `--agent auto --approve-agent` résout localement.
+>
+> **Transparence totale** — le code réel reste exécuté par votre agent choisi ou vos commandes locales; Mobius orchestre le happy path et trace les preuves. Pas de serveur, pas de LLM caché.
+
+## Installation
+
+Paquet public PyPI (nom de distribution: `mobius-charles`, commande installée: `mobius`) :
+
+```bash
+uv tool install mobius-charles
+```
+
+```bash
+mobius --help
+```
+
+Chemins équivalents :
+
+```sh
+pipx install mobius-charles
+# ou depuis un checkout de développement
+uv tool install . --force
+./install.sh
+```
+
+Puis démarrez le chemin débutant :
+
+```sh
+mobius go "mon idée"
+```
+
+## Répertoire d'état
+
+Mobius stocke l'état dans SQLite à `$MOBIUS_HOME/events.db`. Sans `MOBIUS_HOME`, le chemin par défaut est `~/.mobius/events.db`, partagé entre les projets (`shared across every Mobius project`). Pour isoler un workspace :
+
+```sh
+export MOBIUS_HOME="$PWD/.mobius"
+```
+
+`mobius init` affiche le chemin résolu et `mobius config get event_store` le retourne à tout moment.
+
+## Démarrage rapide
+
+```sh
+uv tool install mobius-charles
+mobius go "je veux une petite CLI qui salue l'utilisateur"
+mobius status
+mobius qa
+mobius ralph --dry-run
+```
+
+Chemin CI/script avancé :
+
+```bash
+export MOBIUS_HOME="$(mktemp -d)"  # optionnel: isole l'état
+cat > /tmp/mobius-fixture.yaml <<'YAML'
+project_type: greenfield
+goal: Livrer un petit test de fumée CLI.
+constraints:
+  - Garder tout l'état dans le MOBIUS_HOME temporaire.
+  - Éviter les services réseau.
+success:
+  - Interview écrit une spec.
+  - Seed crée une session.
+  - Run se termine avec succès.
+YAML
+mobius interview --non-interactive --input /tmp/mobius-fixture.yaml --output /tmp/mobius-spec.yaml
+mobius seed /tmp/mobius-spec.yaml --json
+run_id="$(mobius run --spec /tmp/mobius-spec.yaml)"
+mobius status "$run_id" --follow
+```
+
+Pour démarrer un vrai workspace :
+
+```sh
+mobius go "mon idée de projet"
+```
+
+## Commandes principales
+
+- `mobius interview` — entretien projet interactif (modes deep, quick, conversationnel) avec juge interne à 3 lentilles (Clarté, Risques, Faisabilité), breadth keeper par questions-ponts, et persistance par tour.
+- `mobius seed` — valide une spec et crée une session seed.
+- `mobius run` — exécute avec un agent (`--agent codex --model gpt-5.5`, `--agent claude`, `--agent droid`). Chaque run est isolé dans un git worktree pour permettre l'exécution parallèle.
+- `mobius status` — affiche la santé globale ou le statut d'un run.
+- `mobius qa [RUN_ID]` — évalue un run avec un juge local déterministe.
+- `mobius evolve [RUN_ID]` — lance une boucle d'évolution depuis un run existant.
+- `mobius cancel RUN_ID` — annule un run détaché et nettoie son PID.
+- `mobius lineage [AGGREGATE_ID]` — affiche les ancêtres, descendants ou le hash de replay.
+- `mobius init` — crée un `spec.yaml` de départ et initialise l'event store.
+- `mobius setup` — installe les assets d'intégration agent.
+- `mobius config` — affiche, lit ou modifie la configuration Mobius.
+- `mobius handoff` — génère un prompt versionné pour un agent de code.
+- `mobius hud` — tableau de bord basé sur les projections.
+
+Commandes avancées :
+
+- `mobius build` — compose une première spec guidée depuis une idée.
+- `mobius projection` — gère le cache de projections.
+- `mobius cold-start` — mesure le budget de démarrage à froid.
+
+## Exécution parallèle
+
+Chaque `mobius run` isole automatiquement l'agent dans un **git worktree** dédié. Cela permet de lancer plusieurs runs en parallèle sans conflit :
+
+```sh
+mobius run --spec spec-auth.yaml --agent codex --model gpt-5.5 --approve-agent
+mobius run --spec spec-ui.yaml --agent codex --model gpt-5.5 --approve-agent
+mobius run --spec spec-api.yaml --agent claude --model opus-4.7 --approve-agent
+# Les 3 tournent en parallèle, chacun dans son propre espace.
+```
+
+## Interview Deep améliorée
+
+Le mode `--mode deep` inclut :
+
+- **Persistance par tour** — chaque round est sauvegardé dans un fichier JSON incrémental. Un crash ne perd aucune donnée.
+- **Juge interne à 3 lentilles** — Clarté (Socrate), Risques (Avocat), Faisabilité (Architecte). Le juge guide silencieusement le choix des questions et hausse le ton quand un problème est détecté.
+- **Breadth keeper** — si un axe thématique est touché 2 fois de suite, une question-pont connecte naturellement vers un axe non couvert.
+- **Recommandations argumentées** — chaque question inclut la recommandation de Mobius avant de demander l'avis de l'utilisateur.
+- **Reprise après crash** — détection automatique d'une interview interrompue avec 3 choix (reprendre / recommencer / voir le résumé).
+
+## Préparation release PyPI
+
+Avant publication, sans effet externe :
+
+1. Vérifier que le nom PyPI public est libre/choisi : `mobius-charles` (le nom `mobius` est déjà pris sur PyPI).
+2. Vérifier les métadonnées : `uv build --out-dir /tmp/mobius-dist`.
+3. Valider les artefacts : `uvx twine check /tmp/mobius-dist/*`.
+4. Installer le wheel dans un environnement propre et lancer `mobius --help`.
+5. Tester les assets sans écrire : `mobius setup --runtime claude|codex|hermes --dry-run`.
+6. Vérifier l'authentification de publication sans contacter PyPI : `uv run python scripts/verify_publish_auth.py`.
+7. Publier seulement après GO explicite, idéalement via GitHub Actions `Publish PyPI` + PyPI Trusted Publishing. En local seulement si token disponible : `uv publish --token "$PYPI_TOKEN" /tmp/mobius-dist/*`.
+8. Après publication, vérifier le paquet réellement publié : `uv run python scripts/verify_post_publish.py --version 0.3.0`.
+
+Voir aussi [`docs/cli-reference.md`](docs/cli-reference.md), [`CHANGELOG.md`](CHANGELOG.md), [`CONTRIBUTING.md`](CONTRIBUTING.md) et [`SECURITY.md`](SECURITY.md).

mobius_charles-0.3.0/pyproject.toml

@@ -0,0 +1,88 @@
+[project]
+name = "mobius-charles"
+version = "0.3.0"
+description = "Local-first AI workflow CLI with event-sourced runs and deterministic agent routing."
+readme = "README.md"
+keywords = ["ai-agents", "cli", "event-sourcing", "local-first", "workflow"]
+requires-python = ">=3.12"
+license = "MIT"
+authors = [
+  { name = "Mobius contributors" },
+]
+dependencies = [
+  "pydantic>=2.12.0",
+  "rich>=14.0.0",
+  "typer>=0.20.0",
+]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Software Development :: Build Tools",
+  "Topic :: Software Development :: Quality Assurance",
+]
+
+[project.urls]
+Homepage = "https://github.com/charlescstpierr/mobius-charles"
+Repository = "https://github.com/charlescstpierr/mobius-charles"
+Issues = "https://github.com/charlescstpierr/mobius-charles/issues"
+Changelog = "https://github.com/charlescstpierr/mobius-charles/blob/main/CHANGELOG.md"
+
+[project.scripts]
+mobius = "mobius.cli:main"
+
+[dependency-groups]
+dev = [
+  "hypothesis>=6.152.4",
+  "mypy>=1.19.0",
+  "pytest>=9.0.0",
+  "pytest-cov>=7.1.0",
+  "ruff>=0.14.0",
+]
+
+[build-system]
+requires = ["uv_build>=0.10.0,<0.11.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-root = "src"
+module-name = "mobius"
+
+[tool.ruff]
+target-version = "py312"
+line-length = 100
+src = ["src"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM"]
+
+[tool.ruff.lint.per-file-ignores]
+# The blind-spot catalog contains long French prose and diagram strings where
+# wrapping would make the source harder to review without changing behavior.
+"src/mobius/workflow/blind_spot.py" = ["E501"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+
+[tool.mypy]
+python_version = "3.12"
+strict = true
+files = ["src/mobius"]
+
+[tool.pytest.ini_options]
+addopts = "--import-mode=importlib"
+testpaths = ["tests"]
+
+[tool.coverage.run]
+patch = ["subprocess"]
+source = ["src/mobius"]
+branch = true
+
+[tool.coverage.report]
+fail_under = 80
+precision = 2
+show_missing = true

mobius_charles-0.3.0/src/mobius/__init__.py

@@ -0,0 +1,3 @@
+"""Mobius package."""
+
+__version__ = "0.3.0"

mobius_charles-0.3.0/src/mobius/agents/__init__.py

@@ -0,0 +1,6 @@
+"""Agent handoff template registry."""
+
+from __future__ import annotations
+
+KNOWN_AGENTS: tuple[str, ...] = ("claude", "codex", "hermes")
+TEMPLATE_VERSION = 1

mobius_charles-0.3.0/src/mobius/agents/loader.py

@@ -0,0 +1,175 @@
+"""Chargeur de prompts de personas — source unique pour tous les prompts système.
+
+Charge les fichiers .md avec une stratégie de résolution à 3 niveaux :
+
+1. Répertoire projet-local ``.mobius/agents/`` dans le répertoire courant
+2. Variable d'environnement ``MOBIUS_AGENTS_DIR`` — répertoire d'override utilisateur
+3. ``importlib.resources`` — prompts embarqués dans le package
+"""
+
+from __future__ import annotations
+
+import functools
+import importlib.resources
+import os
+import re
+from dataclasses import dataclass
+from pathlib import Path
+
+PERSONAS = ("contrarian", "hacker", "simplifier", "researcher", "architect")
+
+
+def _is_safe_path(path: Path, parent: Path) -> bool:
+    """Vérifier qu'un chemin résolu reste sous le répertoire parent (anti-symlink escape)."""
+    try:
+        resolved = path.resolve(strict=True)
+        return str(resolved).startswith(str(parent.resolve()))
+    except OSError:
+        return False
+
+
+@functools.lru_cache(maxsize=32)
+def _resolve_persona_path(name: str, _cwd: str = "") -> Path | None:
+    """Trouver un fichier .md de persona via la stratégie d'override à 3 niveaux."""
+    filename = f"{name}.md"
+    project_dir = Path(_cwd or Path.cwd()) / ".mobius" / "agents"
+    if project_dir.is_dir():
+        path = project_dir / filename
+        if path.exists() and _is_safe_path(path, project_dir):
+            return path
+    agents_dir = os.environ.get("MOBIUS_AGENTS_DIR")
+    if agents_dir:
+        env_dir = Path(agents_dir)
+        path = env_dir / filename
+        if path.exists() and _is_safe_path(path, env_dir):
+            return path
+    return None
+
+
+@functools.lru_cache(maxsize=32)
+def load_persona(name: str) -> str:
+    """Charger le contenu markdown complet d'une persona.
+
+    Args:
+        name: Identifiant de la persona, ex. ``"contrarian"``.
+
+    Returns:
+        Texte markdown complet.
+
+    Raises:
+        FileNotFoundError: Si le fichier .md est introuvable.
+    """
+    _validate_name(name)
+    path = _resolve_persona_path(name, str(Path.cwd()))
+    if path is not None:
+        return path.read_text(encoding="utf-8")
+
+    package = importlib.resources.files("mobius.agents.personas")
+    resource = package.joinpath(f"{name}.md")
+    try:
+        return resource.read_text(encoding="utf-8")
+    except (FileNotFoundError, TypeError):
+        raise FileNotFoundError(
+            f"Persona introuvable : {name}.md "
+            f"(cherché dans MOBIUS_AGENTS_DIR et mobius.agents.personas)"
+        ) from None
+
+
+def load_section(name: str, section: str) -> str:
+    """Extraire une section ``## <section>`` d'un fichier de persona."""
+    content = load_persona(name)
+    return extract_section(content, section)
+
+
+def list_personas() -> tuple[str, ...]:
+    """Retourner les noms de toutes les personas disponibles (embarquées + projet)."""
+    names: set[str] = set(PERSONAS)
+    project_dir = Path.cwd() / ".mobius" / "agents"
+    if project_dir.is_dir():
+        for md in project_dir.glob("*.md"):
+            names.add(md.stem)
+    agents_dir = os.environ.get("MOBIUS_AGENTS_DIR")
+    if agents_dir:
+        env_path = Path(agents_dir)
+        if env_path.is_dir():
+            for md in env_path.glob("*.md"):
+                names.add(md.stem)
+    return tuple(sorted(names))
+
+
+def clear_cache() -> None:
+    """Vider le cache des prompts. Utile pour les tests."""
+    load_persona.cache_clear()
+    _resolve_persona_path.cache_clear()
+
+
+def extract_section(content: str, section: str) -> str:
+    """Extraire tout entre ``## <section>`` et le prochain ``##``."""
+    lines = content.split("\n")
+    pattern = re.compile(rf"^##\s+{re.escape(section)}\s*$", re.IGNORECASE)
+
+    start: int | None = None
+    for i, line in enumerate(lines):
+        if pattern.match(line.strip()):
+            start = i + 1
+            break
+    if start is None:
+        raise KeyError(f"Section '## {section}' introuvable")
+
+    end = len(lines)
+    for i in range(start, len(lines)):
+        if lines[i].strip().startswith("## "):
+            end = i
+            break
+
+    return "\n".join(lines[start:end]).strip()
+
+
+def extract_questions(name: str) -> tuple[str, ...]:
+    """Extraire les questions (lignes ``- item``) de la section TES QUESTIONS."""
+    section = load_section(name, "TES QUESTIONS")
+    items: list[str] = []
+    for line in section.split("\n"):
+        stripped = line.strip()
+        if stripped.startswith("- "):
+            items.append(stripped[2:].strip())
+    return tuple(items)
+
+
+@dataclass(frozen=True, slots=True)
+class PersonaData:
+    """Données parsées d'un fichier .md de persona."""
+
+    name: str
+    philosophy: str
+    questions: tuple[str, ...]
+
+
+def load_persona_data(name: str) -> PersonaData:
+    """Charger et parser un fichier .md de persona."""
+    content = load_persona(name)
+
+    lines = content.split("\n")
+    philosophy_lines: list[str] = []
+    past_title = False
+    for line in lines:
+        if line.startswith("# ") and not past_title:
+            past_title = True
+            continue
+        if line.startswith("## "):
+            break
+        if past_title and line.strip():
+            philosophy_lines.append(line.strip())
+
+    return PersonaData(
+        name=name,
+        philosophy=" ".join(philosophy_lines),
+        questions=extract_questions(name),
+    )
+
+
+def _validate_name(name: str) -> None:
+    if name not in list_personas():
+        raise FileNotFoundError(
+            f"Persona inconnue : {name}. Personas disponibles : {', '.join(list_personas())}"
+        )

mobius_charles-0.3.0/src/mobius/agents/personas/__init__.py

@@ -0,0 +1 @@
+"""Prompts de personas de pensée latérale embarqués dans le package."""

mobius_charles-0.3.0/src/mobius/agents/personas/architect.md

@@ -0,0 +1,60 @@
+# Architect
+
+Tu remets en question les fondations et restructures l'approche si nécessaire.
+
+## TA PHILOSOPHIE
+
+« Un bon architecte sait quand renforcer les fondations et quand les remplacer. Corriger un défaut structurel tôt coûte 10x moins que le corriger tard. »
+
+Tu ne patches pas — tu restructures. Si les fondations sont bancales, aucun correctif en surface ne tiendra.
+
+## TON APPROCHE
+
+### 1. Évaluer les fondations
+Le problème est-il structurel ou superficiel ?
+- Si chaque correctif crée un nouveau bug → problème structurel
+- Si le code est difficile à modifier → le design est mauvais
+- Si les tests sont fragiles → les abstractions sont mauvaises
+
+### 2. Identifier les couplages toxiques
+Quels composants sont trop liés entre eux ?
+- A change quand B change → couplage à casser
+- Un changement touche 10 fichiers → abstraction manquante
+- Les tests nécessitent des mocks complexes → interfaces mal définies
+
+### 3. Proposer une restructuration ciblée
+Ne pas tout réécrire — cibler le point de levier :
+- Extraire une interface là où le couplage est le pire
+- Inverser une dépendance pour briser un cycle
+- Séparer les préoccupations mélangées
+
+### 4. Valider avec les contraintes réelles
+- La restructuration est-elle possible avec les délais actuels ?
+- Peut-on migrer graduellement sans big bang ?
+- Le bénéfice justifie-t-il le coût ?
+
+## TES QUESTIONS
+
+- Le problème est-il dans le code ou dans le design ?
+- Quel est le couplage le plus toxique du système ?
+- Si on devait repartir de zéro, que ferait-on différemment ?
+- Peut-on restructurer graduellement ou faut-il un big bang ?
+- Quelle est la dette technique la plus coûteuse à ne PAS rembourser ?
+
+## TON RÔLE FACE AU BLOCAGE
+
+Quand les correctifs ne tiennent pas, tu :
+1. Diagnostiques si le problème est structurel
+2. Identifies le point de levier minimal pour restructurer
+3. Proposes un plan de migration graduel
+4. Évalues le coût vs bénéfice de la restructuration
+
+## SORTIE
+
+Fournis une analyse architecturale qui :
+- Diagnostique si le problème est structurel ou superficiel
+- Identifie les 1-2 couplages les plus toxiques
+- Propose une restructuration ciblée (pas une réécriture)
+- Donne un plan de migration en 3 étapes maximum
+
+Sois pragmatique. L'architecture parfaite n'existe pas — seulement l'architecture suffisamment bonne.