syncanix init
Découvrez votre API, construisez le catalogue de capacités et téléversez-le — avec un enrichissement par IA soumis à consentement.
init est la commande que vous lancerez le plus. Elle analyse votre projet, transforme votre API en catalogue de capacités et le téléverse dans votre espace de travail.
npx syncanix initOptions
- -f, --framework <name>
- Force un framework précis au lieu de la détection automatique. Accepte tout framework pris en charge par Syncanix — par exemple nestjs, express, fastapi, django ou laravel.
- --env <env>
- Cible l’environnement development (par défaut) ou production lors du téléversement du catalogue.
- --offline
- Écrit le catalogue localement sans le téléverser.
- -y, --yes
- Accepte les valeurs par défaut et ignore les invites — l’enrichissement utilise vos clés de fournisseur locales lorsqu’elles sont définies, et est ignoré sinon.
- --byok-key <key>
- Utilise votre propre clé de fournisseur LLM pour l’enrichissement, au lieu des clés de votre environnement.
- --byok-provider <provider>
- Le fournisseur BYOK — anthropic ou openai. Déduit du format de la clé s’il est omis.
- --force
- Poursuit au-delà du plafond de coût de l’enrichissement, en acceptant la dépense estimée.
- --reset-consent
- Efface le consentement d’enrichissement enregistré pour que init redemande.
- --init-config
- Régénère les fichiers de départ .syncanix.yaml et .syncanixignore (écrase les fichiers existants).
- --graphql-endpoint <url>
- Introspecte un point de terminaison GraphQL en cours d’exécution pour typer les mutations code-first.
- --telemetry
- Active la télémétrie d’usage anonyme (désactivée par défaut).
Ce qu’elle fait
- Détecte vos frameworksAnalyse le projet et signale chaque framework reconnu — pas seulement le principal.
- Extrait les capacitésLit vos routes et construit une liste structurée de capacités, avec leurs entrées et leurs effets.
- Applique .syncanixignoreÉcarte tout ce qui correspond à vos règles d’exclusion avant écriture, enrichissement ou téléversement.
- Interroge sur l’enrichissement IAAffiche une estimation de coût et demande comment procéder avant d’envoyer du texte de code à un fournisseur.
- Écrit le catalogueEnregistre un fichier .syncanix/catalog.json déterministe que vous pouvez relire et versionner.
- Le téléverseEnvoie le catalogue à votre espace de travail, sauf si vous avez passé --offline ou n’avez pas encore de clé d’API.
Statique par défaut
La découverte lit votre code ; elle ne l’exécute jamais, et aucune donnée de production ne quitte votre machine. La seule chose qui puisse être envoyée est le catalogue structuré — et l’enrichissement IA n’a lieu qu’avec votre consentement explicite.
Consentement pour l’enrichissement IA
L’enrichissement IA rédige des titres et des descriptions plus clairs pour vos capacités. Avant d’envoyer quoi que ce soit, la CLI montre exactement ce qui serait envoyé (identifiants de capacité, méthodes et chemins, noms d’arguments, et un court extrait du gestionnaire avec les secrets masqués) et ce qui ne le serait pas (fichiers source, vos données, secrets, tout ce qui est ignoré). Vous choisissez ensuite un mode :
- Clés locales
- Utilise les clés Anthropic et OpenAI déjà présentes dans votre environnement local, avec la rétention zéro des données appliquée. L’enrichissement s’exécute depuis votre machine — il n’existe aucun service d’enrichissement hébergé par Syncanix.
- BYOK
- Utilise votre propre clé de fournisseur ; le texte du gestionnaire va directement de votre machine au fournisseur, et Syncanix ne le voit jamais.
- Ignorer
- Aucun enrichissement — livrez uniquement les métadonnées de l’extracteur et enrichissez plus tard depuis le tableau de bord.