Code Atlas · 0.5.0

Un panneau VS Code en français pour suivre les changements, comprendre les liens entre fichiers et discuter du code avec votre modèle. Auteur : Nicolas Hedoire. Version en préparation pour le Marketplace.

Démarrer

1. Utilisez VS Code bureau 1.95 ou ultérieur, avec un dossier local approuvé.
2. Installez le VSIX depuis Extensions → … → Installer à partir d’un VSIX….
3. Lancez Code Atlas : Ouvrir le suivi dans la palette de commandes.
4. Choisissez un modèle sous le champ Conversation, puis posez une question.

Le panneau s’ouvre en mode Lecture. Projet exemple fournit une démonstration distincte de votre projet ; les demandes au modèle restent de vraies requêtes, même dans cette démonstration.

Lire le code

• Code : fichiers observés et vues Avant / Après / Diff, y compris les buffers non enregistrés. Avant correspond au point de départ conservé par Atlas.
• Flow : imports locaux JavaScript/TypeScript détectés dans le code. La carte se rafraîchit avec les changements observés, notamment après les sauvegardes ; elle ne représente pas l’ordre d’exécution.
• Me guider : extraits avec numéros de lignes, navigation Précédent / Suivant synchronisée entre le code et la carte.
• Conversation : questions sur le contexte sélectionné et liens vers les fichiers connus. Une réponse ancienne est signalée lorsque le code a changé.

Le guide est limité à 12 fichiers et 24 étapes. Les alias TypeScript, paquets externes et imports calculés ne sont pas résolus. Atlas n’accède pas au raisonnement interne d’un agent et n’importe pas sa conversation externe.

Modifier le code

Enregistrez vos changements, choisissez Modifier dans Conversation, puis décrivez la modification souhaitée. L’envoi en mode Modifier autorise Atlas à appliquer et enregistrer le lot obtenu.

Le fournisseur sélectionné renvoie un plan JSON. Atlas peut lui fournir des fichiers supplémentaires de l’index, vérifie le contenu initial exact et les chemins, puis applique les fichiers un par un dans VS Code. Le diff et la carte suivent les sauvegardes. Le modèle ne dispose pas d’un terminal pour effectuer ces modifications.

• Un lot contient au maximum 8 fichiers. Les fichiers transmis pour l’édition sont entiers, dans un contexte borné ; un fichier trop grand est refusé.
• Les fichiers cachés, secrets identifiés par leur nom, lockfiles, dépendances et dossiers générés sont exclus de ce mode. Les suppressions et renommages ne sont pas proposés.
• Arrêter interrompt la génération ou la suite du lot. Les fichiers déjà appliqués restent modifiés ; une erreur peut donc laisser un lot partiel.
• Annuler le dernier lot restaure les fichiers encore inchangés depuis leur application et retire les créations correspondantes. Les fichiers retouchés entre-temps sont préservés. Cet historique d’annulation appartient à la session ouverte.

Aucun shell, installation de dépendances ou test n’est lancé automatiquement par Modifier. Vérifiez le diff et exécutez les contrôles adaptés au projet. Les sauvegardes passent par VS Code et peuvent déclencher vos formatteurs ou autres extensions configurées.

Choisir un fournisseur

Actualiser les modèles découvre les modèles VS Code et Ollama accessibles. Atlas ne télécharge aucun modèle et ne crée aucun compte. Les quotas, coûts éventuels et conditions du fournisseur s’appliquent. Un échec ne produit pas de réponse simulée ; si Codex ne révèle pas le modèle effectif, le libellé reste GPT · Codex.

Claude et Codex sont exécutés dans un dossier isolé avec des capacités réduites. Codex utilise un sandbox en lecture seule ; certains outils natifs peuvent rester annoncés, et une demande d’outil observée interrompt la réponse. Les transports VS Code et Ollama ne proposent pas d’outils au modèle. Dans Modifier, c’est Atlas qui applique le plan validé.

Vos messages et le code nécessaire sont transmis au fournisseur choisi. Lecture utilise des extraits et différences ; Modifier peut envoyer le contenu complet de plusieurs fichiers. Le choix Ollama ne garantit pas à lui seul un traitement hors ligne : cela dépend du serveur et du modèle configurés. La notice détaillée est fournie dans PRIVACY.md.

Périmètre et données locales

Atlas suit le premier dossier de l’espace de travail : 300 fichiers par défaut, réglables entre 10 et 1 000, 128 Kio par fichier. JavaScript/TypeScript bénéficient de l’analyse d’imports ; JSON, CSS, SCSS, HTML, Python, Go, Rust et Markdown sont suivis comme fichiers. Les exclusions et limites rendent l’analyse partielle.

Le stockage local VS Code conserve notamment l’état de référence avec son code, les événements, les vérifications et les 40 derniers messages. Nouveau point de départ remplace la référence ; Effacer retire l’historique de Conversation. L’analyse automatique est désactivée par défaut et peut être activée séparément ; elle transmet alors du contexte au fournisseur sélectionné.

Les options complémentaires comprennent un rapport Markdown, des vérifications npm lancées sur demande et un connecteur de métadonnées pour Claude Code. Ce connecteur installe des hooks dans .claude/settings.local.json et des fichiers dans .code-atlas/ ; il ne capture pas la conversation de l’agent. La voix système est disponible sur macOS. Les hooks nécessitent macOS ou Linux et Node.js.

Construire

Avec Node.js 20 ou ultérieur :

npm ci
npm run check
npm test
npm run package

Le package local conserve l’identité local-lab.code-atlas et produit ../code-atlas-0.5.0.vsix. Le processus distinct package:marketplace, décrit dans docs/publication.md, exige un identifiant d’éditeur confirmé et ne publie rien en ligne.

Licence MIT, texte dans LICENSE. Les principes d’analyse documentés dans docs/rea-inspiration.md sont inspirés de REA ; aucun moteur REA n’est embarqué.