Créer la crate `fractal-ext` : trait Extension + EventBus #2

New issue

Closed

opened 2026-04-06 01:32:51 +00:00 by charles · 0 comments

charles commented

2026-04-06 01:32:51 +00:00

Owner

Contexte

La crate fractal-ext est la colonne vertébrale d'extensibilité du projet. Tous les modules (M1–M5) l'implémentent. Elle doit être conçue pour être wrappable par un futur runtime de plugins (Lua via mlua feature send).

Critères d'acceptation

Trait Extension défini avec #[async_trait] : id(), name(), on_init(), on_sync_event() (opt-in), on_command() (opt-in), message_decorations()
Struct EventBus avec Vec<Box<dyn Extension>> et méthode dispatch()
Types communs exportés : AppContext, EventContext, CommandContext, Command, CommandResult, MessageDecoration
CommandRegistry dynamique pour les commandes slash
Tests unitaires : dispatch vers plusieurs extensions, gestion d'erreur isolée (une extension en erreur ne bloque pas les autres)
README.md dans crates/fractal-ext/

Notes techniques

Tous les traits utilisent #[async_trait] + Send + Sync
EventBus::dispatch log via tracing::warn! en cas d'erreur d'extension, sans propager
Point d'ancrage pour le futur plugin Lua : enregistrement dynamique à l'exécution

## Contexte La crate `fractal-ext` est la colonne vertébrale d'extensibilité du projet. Tous les modules (M1–M5) l'implémentent. Elle doit être conçue pour être wrappable par un futur runtime de plugins (Lua via `mlua` feature `send`). ## Critères d'acceptation - [ ] Trait `Extension` défini avec `#[async_trait]` : `id()`, `name()`, `on_init()`, `on_sync_event()` (opt-in), `on_command()` (opt-in), `message_decorations()` - [ ] Struct `EventBus` avec `Vec<Box<dyn Extension>>` et méthode `dispatch()` - [ ] Types communs exportés : `AppContext`, `EventContext`, `CommandContext`, `Command`, `CommandResult`, `MessageDecoration` - [ ] `CommandRegistry` dynamique pour les commandes slash - [ ] Tests unitaires : dispatch vers plusieurs extensions, gestion d'erreur isolée (une extension en erreur ne bloque pas les autres) - [ ] README.md dans `crates/fractal-ext/` ## Notes techniques - Tous les traits utilisent `#[async_trait]` + `Send + Sync` - `EventBus::dispatch` log via `tracing::warn!` en cas d'erreur d'extension, sans propager - Point d'ancrage pour le futur plugin Lua : enregistrement dynamique à l'exécution

charles added this to the Phase 0 — Setup milestone

2026-04-06 01:32:51 +00:00

charles added the

priority:high

type:chore

labels

2026-04-06 01:32:51 +00:00

charles referenced this issue

2026-04-06 01:33:05 +00:00

[M1] Définir le trait SttEngine et les types communs STT #4

charles referenced this issue

2026-04-06 01:33:48 +00:00