Redsen RedLine Review

Extension VS Code redsentechnology.redsen-redline-review.

Lire, commenter et versionner les artefacts BMAD (PRD, architecture, UX, spécifications, epics/stories) d'un dépôt Git, sans quitter VS Code. C'est le même visualiseur que la version web, intégré à l'interface de l'éditeur.

Disposition

Un clic sur un document de la vue Documents l'ouvre dans l'éditeur ; les trois zones restent synchronisées (document, fil actif, identifiant sélectionné). La commande RedLine Review : Ouvrir le visualiseur affiche les trois. Si la barre latérale secondaire n'est pas visible, elle s'ouvre une première fois automatiquement ; vous pouvez ensuite la masquer ou y déplacer d'autres vues comme d'habitude.

Installation

1. Depuis le Marketplace : dans VS Code, vue Extensions, chercher « Redsen RedLine Review » et Installer, ou en ligne de commande :

   code --install-extension redsentechnology.redsen-redline-review
   

   Les mises à jour suivantes sont automatiques.

   Sans accès au Marketplace (poste isolé, VSCodium, Cursor) : récupérer le fichier redsen-redline-review-<version>.vsix, puis Extensions → menu … → Installer à partir d'un VSIX…, ou code --install-extension redsen-redline-review-<version>.vsix.

2. Ouvrir un dossier qui est un dépôt Git : il est ajouté automatiquement comme copie locale (suivi de la branche courante, édition directe, revues locales). D'autres dépôts s'ajoutent avec Gérer les dépôts… (URL https ou dépôts détectés sur le poste).

Prérequis : VS Code 1.144 ou plus récent, Git dans le PATH. L'extension exige un dossier de confiance (elle exécute Git dans le dépôt) et un disque local (pas d'espace de travail virtuel).

Construire depuis les sources

npm install
npm run package:vscode      # build web + extension, puis dist/redsen-redline-review-<version>.vsix
npm run build:vscode        # sans empaqueter

Développement : ouvrir le dépôt dans VS Code et lancer Lancer l'extension (RedLine Review) (F5) ; la fenêtre d'extension reconstruit l'interface et l'hôte au lancement. npm run watch --workspace vscode reconstruit l'hôte à chaque changement. Test de bout en bout (lance le VS Code du poste, VSCODE_EXECUTABLE pour en désigner un autre) : npm run test:e2e --workspace vscode.

Fonctionnement

L'extension embarque le serveur du visualiseur : il écoute sur 127.0.0.1 (port libre) et chaque URL contient un jeton aléatoire généré à chaque session. Sans ce jeton, le serveur répond 403 ; seules les webviews de VS Code sont autorisées (CORS). Aucun serveur ni fichier .env à gérer. Les données (clones des dépôts distants, repos.json) sont dans le stockage global de l'extension. En session distante (SSH, WSL, Codespaces), le port est redirigé par VS Code.

Réglages

Les secrets ne sont jamais dans les réglages : commandes Renseigner le jeton Azure DevOps (PAT)… (droits Code : lecture et écriture, envoyé aux seuls remotes Azure DevOps) et Renseigner la clé Azure OpenAI…, stockés dans le coffre de VS Code. Sans clé Azure OpenAI, l'authentification passe par Microsoft Entra ID (az login). Modifier un réglage de dépôt redémarre le serveur intégré (même port et même jeton : l'interface reste ouverte).

Classification par IA (✨ Analyser avec l'IA)

Le bouton de l'éditeur de configuration (⚙) envoie à un modèle la structure du dépôt, un extrait du README et des titres de documents, et propose dossiers et sections. Avec bmadDocReview.llm.provider = auto, le premier fournisseur disponible est utilisé, dans cet ordre :

1. GitHub Copilot (ou tout fournisseur de modèles de VS Code) : aucun réglage, VS Code demande l'autorisation la première fois.
2. Claude Code : l'extension Anthropic Claude Code installée, ou la commande claude du PATH. Utilise votre abonnement Claude Code.
3. Azure OpenAI : déploiement configuré dans les réglages (modèle compatible « structured outputs »).

Un fournisseur disponible mais en échec laisse la main au suivant ; un fournisseur imposé par le réglage ne se replie jamais sur un autre. Le modèle qui a répondu est indiqué avec la proposition. Rien n'est écrit tant que vous n'enregistrez pas.

Expliquer un passage (✨ Expliquer avec l'IA)

Sélectionnez un passage dans le document ou dans le panneau de droite, puis clic droit → « Expliquer avec l'IA… ». Le panneau de droite s'ouvre sur l'onglet ✨ Explications :

• le passage, avec son fichier et sa section ;
• le prompt, réduit sur une ligne (un clic le déplie pour le lire et le modifier) : celui du dépôt (⚙ → Général, champ « Expliquer avec l'IA — prompt initial », enregistré dans .bmad-doc-review.yaml), prêt à l'emploi (explication détaillée et facile à comprendre). Modifiez-le si besoin, puis ▶ Lancer (Ctrl+Entrée) : la réponse s'affiche dans l'onglet, avec le modèle qui l'a rédigée. Vos modifications ne valent que pour cette demande ; Prompt du dépôt reprend celui de la configuration ;
• le chemin du fichier concerné, la section et un peu de texte autour sont joints au prompt envoyé au modèle ;
• 💬 Continuer dans Copilot Chat / 🤖 Continuer dans Claude Code : ouvre une nouvelle conversation dans le panneau de chat standard, avec le prompt, le passage et l'explication déjà obtenue ; il ne reste qu'à écrire la question de suivi (le texte est préparé dans la zone de saisie, pas envoyé). Ces boutons n'apparaissent que si le chat est disponible ;
• Demandes précédentes : chaque explication menée à son terme est conservée pour le dépôt (jusqu'à 100). Cliquez sur une ligne pour la rouvrir (passage, prompt, réponse) et la relancer, ✕ pour la supprimer, Tout effacer pour vider la liste.

Modèle utilisé

Le fournisseur est choisi comme pour la classification : GitHub Copilot, puis Claude Code, puis Azure OpenAI (réglage bmadDocReview.llm.provider). Le passage sélectionné et son contexte sont envoyés à ce fournisseur ; rien n'est envoyé avant « Lancer ».

Pour limiter le coût, le modèle est choisi ainsi, sans jamais prendre le haut de gamme ni un modèle trop sommaire :

1. Le modèle imposé par le dépôt, séparément pour Copilot et pour Claude Code : ⚙ → Général, « Modèles de l'explication par l'IA pour ce dépôt » (clé explain.models de .bmad-doc-review.yaml). Il prime sur les réglages de VS Code.
2. À défaut, le réglage bmadDocReview.llm.copilot.model ou bmadDocReview.llm.claudeCode.model.
3. À défaut, un choix économique automatique :
   • Copilot : un modèle de milieu de gamme (Sonnet, GPT-4.1, GPT-5 mini, Gemini Flash…) plutôt que du haut de gamme (Opus, GPT-5, modèles Pro ou à raisonnement), avec un contexte d'au moins 255 000 jetons si possible — le plus petit qui convient, pas le plus gros. Les modèles trop petits (Haiku, nano, lite) ne sont retenus qu'imposés ;
   • Claude Code : sonnet.

Le modèle qui a répondu est indiqué sous chaque explication et dans la liste des demandes.

Dépannage

• « Le serveur intégré n'a pas démarré » : commande Afficher le journal (canal « RedLine Review »), puis Redémarrer le serveur intégré.
• Interface vide ou « Interface non construite » : l'extension a été lancée sans npm run build:vscode ; reconstruire puis recharger la fenêtre.
• Le dossier ouvert n'apparaît pas dans les dépôts : il doit être un dépôt Git et se trouver sous un dossier de bmadDocReview.repoScanDirs (par défaut : le dossier parent de celui qui est ouvert).
• Aucun modèle disponible pour l'IA : installer GitHub Copilot ou Claude Code, ou renseigner Azure OpenAI ; le journal indique pourquoi chaque fournisseur a été écarté.
• PDF : selon la version de VS Code, le lecteur PDF intégré peut ne pas s'afficher dans une webview ; ouvrir le fichier depuis l'explorateur.

Licence

Logiciel propriétaire de Redsen, tous droits réservés. L'extension peut être utilisée gratuitement, à vos propres risques et sans garantie ; elle ne peut être ni modifiée ni redistribuée. Voir LICENSE.txt. Les composants tiers embarqués restent sous leurs licences : THIRD_PARTY_NOTICES.txt.