Aller au contenu

Open source · semctx

Ce qu'un diff met en risque, et si c'est prouvé.

Un analyseur d'impact open source, déterministe et local : pour chaque diff, ce qu'il touche, ce qu'il met en risque, et un verdict avant la fusion.

En bref

Nature
analyseur d'impact des changements, déterministe et local
Statut
open source (Apache-2.0), npm 0.3.6, provenance de build signée
Où il tourne
en ligne de commande, dans Claude Code et Codex, en CI
Exécution
locale : aucun LLM, aucun appel réseau, aucune base vectorielle
01 · Le problème

01 Le problème

01 Le problème

La question utile a changé.

Un agent peut modifier des dizaines de fichiers en quelques minutes. La question utile n'est plus « quels fichiers regarder ? », mais « qu'est-ce que ce changement a mis en risque, et est-ce prouvé ? ».

semctx répond à cette question-là, et seulement à elle.

02 Ce qu'il rend

02 Ce qu'il rend

Ce qui est touché, ce qui est à risque, un verdict.

À partir d'un diff et d'un graphe déterministe du dépôt, pour chaque changement.

Schéma — Chaque diff est relié à ce qu'il touche et à ce que l'analyse ne peut pas prouver, puis reçoit un verdict avant la fusion.
  • Symboles touchés

    Chaque déclaration dont les lignes sont modifiées par le diff.

  • Contrats à risque

    Les interfaces et les types exportés que le changement altère.

  • Invariants à risque

    Les contraintes annotées sur le code touché.

  • Tests à lancer

    Reliés au code par leurs imports : une sélection, pas une couverture mesurée.

  • Inconnues

    Ce que l'analyse statique ne peut pas prouver, écrit en clair plutôt que passé sous silence.

  • Verdict

    PASS, WARN ou BLOCK. BLOCK sort en erreur : il peut arrêter un commit ou une CI.

Même dépôt, même diff : même verdict. La sortie ne dépend que de l'état du dépôt et d'une date injectée.

03 Ce qu'il ne prétend pas

03 Ce qu'il ne prétend pas

Ses limites font partie du produit.

Elles sont écrites dans le README de l'outil, pas seulement ici.

  • Il ne remplace pas la recherche de code. Il répond à « qu'a mis en risque ce changement, et est-ce prouvé ? », pas à « quels fichiers regarder ? ».

  • C'est une analyse statique : elle choisit quoi retester, elle ne prouve pas le comportement à l'exécution.

  • TypeScript est la base de compatibilité. Python est couvert de façon bornée, Markdown et SQL de façon structurelle.

  • Un rejeu de trente changements publics est publié sans étiquette : aucune précision, adoption ou temps gagné n'est revendiqué.

04 Livraison

04 Livraison

Une étiquette, trois canaux.

Une seule étiquette de version, posée sur un commit immuable, publie le paquet npm, le canal de plugins stable et la release GitHub. La provenance du build est signée.

Schéma — Une seule étiquette de version, sur un commit immuable, publie les trois canaux.

La démo montre trois cas : une modification bénigne, un contrat en alerte, et un bug d'exécution que l'analyse statique ne peut pas déclarer correct.

bunx semctx@latest install

Nécessite Bun 1.4 ou plus récent.

Démo(nouvel onglet) GitHub(nouvel onglet) npm(nouvel onglet)

05 Contact

05 Contact

Ce type de porte dans votre CI ?

Le Diagnostic Agents pose une première porte dans votre CI en cinq jours, avec l'outil qui convient à votre dépôt, semctx ou un autre.

[email protected]

Toutes les réalisations