Retour au blog
ArchitectureApril 3, 20265 min de lecture

Un endpoint. Toutes les surfaces.

Une définition par fonctionnalité. Formulaire web, commande CLI, outil MCP, écran natif, tâche cron : tout d'un coup. Zéro duplication.

Chaque fonctionnalité demandait un formulaire web, une commande CLI, un outil MCP pour les agents IA, parfois un écran mobile. Même validation Zod, même i18n, même gestion d'erreurs, juste un habillage différent. J'ai donc construit next-vibe : un framework où vous écrivez un seul definition.ts par fonctionnalité, et il s'affiche sur toutes ces surfaces à la fois.

C'est aussi le moteur de unbottled.ai : 126 modèles d'IA, une censure que l'utilisateur contrôle. Le même code tourne comme application web Next.js, serveur de dev TanStack/Vite, application mobile React Native, CLI, serveur MCP, système cron et bus d'événements WebSocket. Une seule définition d'endpoint. Zéro duplication.

Les types doivent s'aligner. Sans exception.

Ce ne sont pas des préférences de style. Ce sont des règles d'architecture gravées dans le framework.

La règle est stricte : les types doivent s'aligner complètement. Si vos types sont faux, votre architecture est fausse. Nous avons créé vibe check pour l'imposer : Oxlint + ESLint + TypeScript en parallèle, avec des plugins maison pour les règles propres au projet.

pas de any

Remplacez-le par une vraie interface typée. Si vous sortez any, votre architecture a un trou.

pas de unknown

Même règle. unknown, c'est any avec des étapes en plus. Définissez le type.

pas de object nu

Un object nu ne veut rien dire. Écrivez la forme que vous attendez vraiment.

pas de as X

Les assertions de type sont des mensonges au compilateur. Corrigez plutôt l'architecture.

pas de throw

Utilisez ResponseType<T> avec success(data) ou fail({message, errorType}). Les erreurs sont des données, pas des exceptions.

pas de chaînes en dur dans le JSX

Le vérificateur repère les chaînes littérales non traduites. Chaque chaîne a besoin d'une clé de traduction.

Le moteur de graphes né par accident

Un bot de trading qui ne sait pas trader

Vibe Sense a commencé comme bot de trading. Il n'a jamais passé d'ordre : il surveillait les prix et émettait des signaux. Quand je l'ai abandonné, l'architecture en pipeline a survécu : les sources de données alimentent des indicateurs, les indicateurs nourrissent des évaluateurs, les évaluateurs émettent des signaux, les signaux déclenchent des actions. Chaque nœud est un endpoint HTTP.

Chaque nœud du graphe n'est qu'un endpoint HTTP : vous pouvez faire un curl sur n'importe quelle étape du pipeline, la tester isolément ou l'appeler depuis un agent IA. Le moteur de graphes est un planificateur, pas un DSL.

Comme chaque nœud est un endpoint standard, il se teste seul via la CLI, reste accessible aux agents IA via MCP et se met en cache avec la même infra que tout le reste. Le moteur de graphes n'invente pas son propre langage. Il planifie des endpoints.

bash
git clone https://github.com/techfreaque/next-vibe

Lisez le code. Lancez-le vous-même.

next-vibe est open source. Clonez-le, lancez vibe dev et déployez votre premier endpoint sur toutes les surfaces en un après-midi.

Retour au blog