Gouvernance Lite

Statut

Addon first-party livré avec arka-deck. Cortex reste la source de vérité des règles ; arka-deck est l’exécuteur. Mission Guardian remplace progressivement la promesse de gouvernance mission critique — Gouvernance Lite reste une brique locale de policy et de followup.

Champ	Valeur
Manifest	addons/gouvernance-lite/manifest.json
Entrypoint	addons/gouvernance-lite/src/index.ts
Famille	capability
Maturité	beta
Licence	Apache 2.0

Rôle

Gouvernance Lite transforme les règles Cortex en politiques d’exécution concrètes dans arka-deck. L’utilisateur choisit quand injecter, quoi injecter, dans quel budget, puis simule le résultat avant de lancer une session. Le module ne copie jamais la gouvernance : Cortex reste le cerveau, arka-deck orchestre l’application locale.

Capacités principales

• Policy par projet : active ou désactive la gouvernance, choisit le niveau, conserve une configuration propre à chaque projet.
• Wizard de configuration : parcours manuel ou parcours préparé pour le worker governance-policy-designer (worker-ready, appel live conditionné à la livraison Cortex).
• Profils personnalisés : sauvegarde de profils de familles, budgets et niveaux pour les réutiliser dans le projet.
• Budget tokens visible : estimation du coût contexte avant application avec une approximation prudente.
• Simulation avant sauvegarde : prévisualisation du plan d’injection sur la policy draft sans persistance disque.
• Followup Cortex : trace décisions, actions, risques, livrables, dérives et audit trail ; synchronisable vers Cortex.

Mécanique d’exécution

Étape	Détail
Manifest Cortex	arka-deck charge l’index des règles, familles et versions depuis Cortex, puis cache par registry_version.
Matrice événementielle	Chaque mapping relie un événement runtime à un moment, une action, un mode de règle, des familles et un plafond.
Snippets ciblés	Le planner demande à Cortex seulement les règles retenues, en label_short ou label_long.
Budget strict	Si le plan dépasse maxRules ou maxChars, des règles sont rejetées et une alerte est exposée.
Followup sync	Les événements chat/tool/memory alimentent un followup local structuré, synchronisable vers Cortex.

Hors scope v1

• Rendu TOON local.
• Vérité de règles locale (Cortex reste autoritaire).
• Mutation autonome de policy (à venir, conditionnée à la livraison Cortex worker).
• Garde-fous mission critiques → couverts par Mission Guardian.

Pré-requis

• Hôte : arka-deck (webapp locale).
• Source des règles : manifest gouvernance Cortex + snippets de règles.
• Runtime : fonctionne dans tous les runtimes chat arka-deck via le mécanisme BeforeTurnAugmenter.

Pour aller plus loin

• Mission Guardian : ./mission-guardian
• Cortex Actions : ./cortex-actions
• Contrat addon : ../extension/contrat-addon (à venir)