@imenam/mcp-feature-analyzer 1.0.19 → 1.0.20

package/README.md

@@ -197,7 +197,7 @@ Chaque nœud a un `id`, un `label`, une forme `shape` (`box` par défaut, `pill`
 | Outil | Effet |
 |---|---|
 | `get_review_feedback` | Une fois la revue soumise : décision (`approve`, `request_changes`, `reject`), état du traitement (à traiter, ou traité avec sa date et sa note), constats et remarques retenus avec leur détail, et le prompt généré, recopié tel quel. Après une nouvelle soumission, il liste aussi ce qui a changé depuis la version soumise précédente (décision, constats et remarques ajoutés, modifiés ou retirés) et rappelle comment celle-ci avait été traitée. Avant la soumission, ou pendant que le relecteur modifie une revue soumise : l'avancement seul (fichiers revus, constats ignorés, remarques). Lecture seule. |
-| `mark_feedback_processed` | Marque traité le retour soumis, avec la date et une `note` facultative (« corrigé par 12785d6e3 et 1ff5baaad », « réponses données en conversation »). Sert quand `refresh_analysis` ne convient pas : analyse d'un commit précis corrigée dans d'autres commits, remarques auxquelles l'agent a répondu dans la conversation. Le retour reste lisible avec `get_review_feedback`. Refusé tant que la revue n'est pas soumise ; un nouveau marquage remplace le précédent. |
+| `mark_feedback_processed` | Marque traité le retour soumis, avec la date et une `note` facultative (« corrigé par 12785d6e3 et 1ff5baaad », « réponses données en conversation »). Sert quand `refresh_analysis` ne convient pas : analyse d'un commit précis corrigée dans d'autres commits, remarques auxquelles l'agent a répondu dans la conversation. Le retour reste lisible avec `get_review_feedback`. Refusé tant que la revue n'est pas soumise ; un nouveau marquage remplace le précédent. Le relecteur peut aussi marquer un retour traité depuis l'accueil de la GUI ; le traitement enregistre son auteur, et `get_review_feedback` l'indique (« by the agent » ou « by the reviewer »). |
 
 Le retour se lit **avant** `refresh_analysis`, qui le remplace par une revue vierge : le recalcul vaut traitement, puisqu'il relance la revue.
 
@@ -242,7 +242,7 @@ Thème sombre. La barre supérieure porte la marque (un clic ramène à l'accuei
 
 ### Accueil (`#/`)
 
-Les analyses sont rangées par projet, dans des sections repliables. L'en-tête d'un projet compte ses analyses par état de revue. Chaque analyse est une carte séparée des autres. Son titre s'affiche en entier sur toute la largeur et passe à la ligne s'il le faut. Dessous, sur une seconde ligne : ses refs, la date de sa dernière modification, la progression des fichiers revus, ses constats ouverts par gravité (exigences manquantes comprises, ce que dit l'infobulle) et son état de revue : « Non commencée », « En cours », « Fichiers revus » ou « Soumise », suivi de la décision, puis « Traitée » une fois que l'agent a marqué le retour traité (date et note en infobulle) ; la pastille disparaît dès que le relecteur modifie la revue, qui repasse en cours. Quand l'agent a marqué le retour traité, une ligne sous les références donne sa note et la date du traitement. Une colonne à gauche filtre la liste, chaque filtre avec son icône et son nombre d'analyses : « À relire » (par défaut, revues pas encore soumises), « Traitées par l'agent » (retour traité, corrections à vérifier ; ce filtre ressort en sarcelle tant qu'il n'est pas vide), « À traiter par l'agent » (retour soumis que l'agent n'a pas encore traité), « Approuvées », et « Toutes ». Les quatre premiers se partagent les analyses sans se recouvrir. Sous 900 px de large, les filtres passent au-dessus de la liste. L'accueil n'ouvre aucune analyse d'office ; sans analyse, il explique que l'agent les crée avec `create_analysis`.
+Les analyses sont rangées par projet, dans des sections repliables. L'en-tête d'un projet compte ses analyses par état de revue. Chaque analyse est une carte séparée des autres. Son titre s'affiche en entier sur toute la largeur et passe à la ligne s'il le faut. Dessous, sur une seconde ligne : ses refs, la date de sa dernière modification, la progression des fichiers revus, ses constats ouverts par gravité (exigences manquantes comprises, ce que dit l'infobulle) et son état de revue : « Non commencée », « En cours », « Fichiers revus » ou « Soumise », suivi de la décision, puis « Traitée » une fois que l'agent a marqué le retour traité (date et note en infobulle) ; la pastille disparaît dès que le relecteur modifie la revue, qui repasse en cours. Quand le retour est marqué traité, une ligne sous les références donne la note, l'auteur du marquage (l'agent, ou le relecteur) et la date. Dans le filtre « À traiter par l'agent », chaque carte porte à droite du titre un bouton « Marquer comme traité » : il ouvre une petite fenêtre avec une note facultative (Entrée confirme, Échap referme), et la revue passe dans « Traitées par l'agent », comme avec `mark_feedback_processed`. Le reste de la carte mène à l'analyse. Une colonne à gauche filtre la liste, chaque filtre avec son icône et son nombre d'analyses : « À relire » (par défaut, revues pas encore soumises), « À traiter par l'agent » (retour soumis que l'agent n'a pas encore traité), « Traitées par l'agent » (retour traité, corrections à vérifier ; ce filtre ressort en sarcelle tant qu'il n'est pas vide), « Approuvées », et « Toutes ». Les quatre premiers se partagent les analyses sans se recouvrir. Sous 900 px de large, les filtres passent au-dessus de la liste. L'accueil n'ouvre aucune analyse d'office ; sans analyse, il explique que l'agent les crée avec `create_analysis`.
 
 ### Écran Feature (`#/<id>`)
 
@@ -259,7 +259,8 @@ L'ajustement à la fenêtre ne descend jamais sous l'échelle **0,85** : en dess
 
 ### Écran Revue (`#/<id>/review/<chemin>`)
 
-- **Panneau des fichiers** — progression, fichiers groupés par dossier, état revu, pastilles des constats ouverts par gravité et, en bout de ligne, la lettre du statut git à la manière de VS Code : `M` modifié, `A` ajouté, `D` supprimé, `R` renommé, `U` non suivi (libellé complet en infobulle). Un nom trop long est tronqué au milieu (`reminder-sch…uler.ts`), l'extension reste visible et le chemin complet est en infobulle. Chaque pastille est un lien : elle ouvre le fichier sur son premier constat ouvert de cette gravité (`?line=N`) ; son infobulle le dit (« 3 constats mineurs ouverts — aller au premier »). Sa largeur se règle en glissant son bord droit (entre 200 et 600 px ; flèches gauche et droite quand la poignée a le focus, double-clic pour revenir à 280 px) et se conserve dans le navigateur d'un rechargement à l'autre. Le bouton en tête de l'en-tête du fichier masque ou réaffiche le panneau, pour toute la session : le diff s'élargit vers la gauche, la colonne de droite garde sa largeur. Il reste affiché quand le chemin demandé ne fait pas partie de l'analyse.
+- **Progression** — dans la barre supérieure, à gauche de « Terminer la revue » : « 3/7 revus » et une barre étroite, visibles quel que soit le défilement et même panneau des fichiers masqué.
+- **Panneau des fichiers** — nombre de fichiers, fichiers groupés par dossier, état revu, pastilles des constats ouverts par gravité et, en bout de ligne, la lettre du statut git à la manière de VS Code : `M` modifié, `A` ajouté, `D` supprimé, `R` renommé, `U` non suivi (libellé complet en infobulle). Un nom trop long est tronqué au milieu (`reminder-sch…uler.ts`), l'extension reste visible et le chemin complet est en infobulle. Chaque pastille est un lien : elle ouvre le fichier sur son premier constat ouvert de cette gravité (`?line=N`) ; son infobulle le dit (« 3 constats mineurs ouverts — aller au premier »). Sa largeur se règle en glissant son bord droit (entre 200 et 600 px ; flèches gauche et droite quand la poignée a le focus, double-clic pour revenir à 280 px) et se conserve dans le navigateur d'un rechargement à l'autre. Le bouton en tête de l'en-tête du fichier masque ou réaffiche le panneau, pour toute la session : le diff s'élargit vers la gauche, la colonne de droite garde sa largeur. Il reste affiché quand le chemin demandé ne fait pas partie de l'analyse.
 - **En-tête du fichier** — bascule du panneau des fichiers, chemin, `+`/`−`, statut, fichier précédent et suivant, « Remarque sur le fichier », « Marquer comme revu ».
 - **Diff** — code coloré selon le langage du fichier, déduit de son extension ou de son nom (grammaires de [Shiki](https://shiki.style), chargées à la demande) : le côté nouveau à partir du contenu complet du fichier quand le snapshot le conserve, sinon bloc par bloc ; les lignes supprimées bloc par bloc ; chaque correctif proposé séparément ; les lignes barrées par un correctif restent sans couleur. Un fichier dont le langage n'est pas reconnu s'affiche sans coloration ; une grammaire qui ne se charge pas est signalée dans la barre du diff. Numéros du côté nouveau et repère vertical à la couleur de la gravité le long des lignes visées par un constat. La barre du diff porte trois réglages, communs à tous les fichiers et conservés dans le navigateur d'un rechargement à l'autre : chacun est un bouton compact qui affiche sa valeur courante, et un clic ouvre la liste de ses choix, chacun avec son icône et une description d'une ligne (un clic dehors, Échap ou un défilement la referme). « Afficher » choisit entre « Modifications » (les blocs du diff git, entourés de leurs lignes de contexte) et « Fichier entier » (tout le fichier en un seul bloc : les lignes inchangées, tirées du contenu conservé, s'intercalent entre les modifications, ce qui donne à lire en entier une fonction modifiée en son milieu ; les deux autres sélecteurs s'y appliquent de la même façon, un correctif dont les lignes chevauchaient deux blocs s'y affiche, et « Copier une demande d'explication » porte alors sur tout le fichier). En « Fichier entier », une mini-carte de 22 px longe le bord droit du diff et reste à l'écran pendant le défilement : toute sa hauteur représente tout le fichier affiché. Sa piste de gauche place les lignes ajoutées (vert), supprimées (rouge), supprimées et ajoutées en vis-à-vis en vue « Côte à côte » (moitié rouge, moitié verte) ou seulement réindentées (violet) ; sa piste de droite porte un point par constat, à la couleur de sa gravité (atténué s'il n'est plus ouvert), et un point par ligne portant une remarque. Un cadre bleuté suit la portion visible. Le survol d'un repère en donne la description (« 12 lignes ajoutées · lignes 120 à 131 », « Constat 3 · Majeur » et son titre) ; un clic ou un glissé sur la carte fait défiler le diff jusqu'à l'endroit visé. « Fichier entier » est inactif pour un fichier dont le contenu n'est pas conservé ; la liste en donne la raison à la place de sa description. « Code » choisit entre « Unifié » (une seule colonne : lignes supprimées sur fond rouge au-dessus des lignes ajoutées sur fond vert), « Côte à côte » (ancien code à gauche avec ses numéros du côté ancien, nouveau code à droite : lignes de contexte des deux côtés, lignes supprimées et ajoutées appariées ligne à ligne, case hachurée en face d'une ligne sans vis-à-vis ; remarques, repères et lignes proposées par un correctif sont du côté droit, le bandeau d'un correctif sur toute la largeur) et « Nouveau code » (le code du côté nouveau seul, dans les mêmes blocs : les lignes supprimées ne sont pas affichées et les lignes ajoutées portent un fin filet vert à la place de leur fond et de leur marque ; une explication de code supprimé s'aligne alors sur la ligne voisine du bloc). « Correctifs » choisit entre « Sans correctif », « Avant / après » et « Code corrigé ». Le correctif proposé s'affiche à l'endroit où il s'applique : bandeau « Correctif proposé par l'agent — remplace les lignes X à Y » avec le numéro du constat et « Masquer le correctif », lignes visées barrées sur fond ambre, lignes proposées juste en dessous sur fond violet (marque « › », sans numéro). Le correctif est affiché d'office pour un constat ouvert ; masqué, ou pour un constat sans correctif, une pastille numérotée marque la première ligne visée. Un filet sarcelle longe les lignes décrites par une explication. En « Modifications », quand le contenu du fichier est conservé, l'en-tête de chaque bloc porte un réglage « −5 · N lignes · +5 » : « +5 » ajoute cinq lignes de contexte au-dessus et cinq en dessous du bloc, « −5 » les retire, et le compteur donne le nombre de lignes de contexte au-dessus de la première modification. Les lignes ajoutées s'insèrent sous l'en-tête et après le bloc, si bien que le réglage ne bouge pas à l'écran ; elles se distinguent par un fond plus sombre et un filet gris (« Contexte ajouté » dans la légende). Les lignes entre deux blocs vont d'abord au bloc du dessus ; quand plus aucune ligne masquée ne les sépare, les deux blocs n'en forment plus qu'un, sous un seul en-tête dont « +5 » et « −5 » s'appliquent à chacun des blocs réunis. « +5 » s'éteint quand le bloc atteint les bords du fichier. Le contexte choisi est propre à chaque fichier et dure le temps de la session. L'en-tête de chaque bloc porte aussi « Copier une demande d'explication » (icône du robot) : le bouton copie un prompt à coller dans la conversation de l'agent, qui situe le bloc (analyse, dépôt et refs, fichier, lignes des deux côtés, code tel que figé) et lui demande de l'expliquer en enregistrant ses explications avec `add_explanations`, ou `update_explanation` si une explication couvre déjà ces lignes. Deux correctifs dont les lignes se recouvrent ne s'affichent pas ensemble. Le fond ambre des lignes visées se distingue du rouge des lignes `−` supprimées par la feature. Une légende suit le diff, limitée aux fonds que la vue et le mode affichent : « Ajouté par la feature » (fond ou filet selon la vue), « Supprimé par la feature » (Unifié et Côte à côte), « Lignes remplacées par le correctif » (Avant / après), « Correctif proposé » ou « Correctif appliqué », « Code décrit par une explication ». Quand une ligne supprimée et la ligne ajoutée qui la remplace se ressemblent (la moitié de leurs mots au moins en commun), seules leurs parties modifiées sont surlignées, en rouge sur l'ancienne ligne et en vert sur la nouvelle, sans fond sur le reste de la ligne ; dans chaque suite de lignes supprimées puis ajoutées, la i-ème ligne supprimée est comparée à la i-ème ligne ajoutée, mot à mot. Une ligne sans correspondante proche garde son fond entier (« Partie modifiée de la ligne » dans la légende). Un clic sur un numéro de ligne ouvre la saisie d'une remarque sur cette ligne. Les exigences manquantes sans emplacement s'affichent en bandeau au-dessus du diff de chaque fichier ; le bandeau « N exigences manquantes » se replie, et reste replié pour la session.
 - **Affichage des correctifs** — le sélecteur « Correctifs », au-dessus du diff, propose trois modes, conservés d'un fichier à l'autre et d'un rechargement à l'autre :

package/dist/shared/schemas/analysis.schema.d.ts

@@ -191,10 +191,17 @@ export declare const DiagramSchema: z.ZodObject<{
     }, z.core.$strip>>;
     updatedAt: z.ZodString;
 }, z.core.$strip>;
-/** Traitement d'un retour par l'agent : date et note facultative (commits, réponses données…). */
+/**
+ * Traitement d'un retour : date, note facultative (commits, réponses données…) et
+ * auteur du marquage — l'agent, ou le relecteur depuis la GUI.
+ */
 export declare const ProcessingSchema: z.ZodObject<{
     at: z.ZodString;
     note: z.ZodNullable<z.ZodString>;
+    by: z.ZodEnum<{
+        agent: "agent";
+        user: "user";
+    }>;
 }, z.core.$strip>;
 /**
  * Dernière version soumise d'une revue, conservée quand le relecteur la modifie
@@ -211,6 +218,10 @@ export declare const SubmissionRecordSchema: z.ZodObject<{
     processed: z.ZodNullable<z.ZodObject<{
         at: z.ZodString;
         note: z.ZodNullable<z.ZodString>;
+        by: z.ZodEnum<{
+            agent: "agent";
+            user: "user";
+        }>;
     }, z.core.$strip>>;
     findings: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -244,6 +255,10 @@ export declare const ReviewSchema: z.ZodObject<{
     processed: z.ZodNullable<z.ZodObject<{
         at: z.ZodString;
         note: z.ZodNullable<z.ZodString>;
+        by: z.ZodEnum<{
+            agent: "agent";
+            user: "user";
+        }>;
     }, z.core.$strip>>;
     previousSubmission: z.ZodNullable<z.ZodObject<{
         decision: z.ZodEnum<{
@@ -255,6 +270,10 @@ export declare const ReviewSchema: z.ZodObject<{
         processed: z.ZodNullable<z.ZodObject<{
             at: z.ZodString;
             note: z.ZodNullable<z.ZodString>;
+            by: z.ZodEnum<{
+                agent: "agent";
+                user: "user";
+            }>;
         }, z.core.$strip>>;
         findings: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -440,6 +459,10 @@ export declare const AnalysisSchema: z.ZodObject<{
         processed: z.ZodNullable<z.ZodObject<{
             at: z.ZodString;
             note: z.ZodNullable<z.ZodString>;
+            by: z.ZodEnum<{
+                agent: "agent";
+                user: "user";
+            }>;
         }, z.core.$strip>>;
         previousSubmission: z.ZodNullable<z.ZodObject<{
             decision: z.ZodEnum<{
@@ -451,6 +474,10 @@ export declare const AnalysisSchema: z.ZodObject<{
             processed: z.ZodNullable<z.ZodObject<{
                 at: z.ZodString;
                 note: z.ZodNullable<z.ZodString>;
+                by: z.ZodEnum<{
+                    agent: "agent";
+                    user: "user";
+                }>;
             }, z.core.$strip>>;
             findings: z.ZodArray<z.ZodObject<{
                 id: z.ZodString;

package/dist/shared/schemas/analysis.schema.js

@@ -122,10 +122,14 @@ export const DiagramSchema = z.object({
     links: z.array(DiagramLinkSchema),
     updatedAt: IsoDateSchema,
 });
-/** Traitement d'un retour par l'agent : date et note facultative (commits, réponses données…). */
+/**
+ * Traitement d'un retour : date, note facultative (commits, réponses données…) et
+ * auteur du marquage — l'agent, ou le relecteur depuis la GUI.
+ */
 export const ProcessingSchema = z.object({
     at: IsoDateSchema,
     note: z.string().min(1).nullable(),
+    by: z.enum(EDITORS),
 });
 /**
  * Dernière version soumise d'une revue, conservée quand le relecteur la modifie

package/dist/shared/schemas/api.schema.d.ts

@@ -40,7 +40,13 @@ export declare const SubmitReviewBodySchema: z.ZodObject<{
     noteIds: z.ZodArray<z.ZodString>;
     baseRevision: z.ZodNumber;
 }, z.core.$strict>;
+/** Marquage du retour soumis comme traité par le relecteur, avec une note facultative. */
+export declare const MarkProcessedBodySchema: z.ZodObject<{
+    note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    baseRevision: z.ZodNumber;
+}, z.core.$strict>;
 export type SetFileReviewedBody = z.infer<typeof SetFileReviewedBodySchema>;
+export type MarkProcessedBody = z.infer<typeof MarkProcessedBodySchema>;
 export type SetFindingStatusBody = z.infer<typeof SetFindingStatusBodySchema>;
 export type AddNoteBody = z.infer<typeof AddNoteBodySchema>;
 export type UpdateNoteBody = z.infer<typeof UpdateNoteBodySchema>;
@@ -108,3 +114,10 @@ export declare const SubmitReviewRequestSchema: z.ZodObject<{
         baseRevision: z.ZodNumber;
     }, z.core.$strict>;
 }, z.core.$strict>;
+export declare const MarkProcessedRequestSchema: z.ZodObject<{
+    analysisId: z.ZodString;
+    body: z.ZodObject<{
+        note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        baseRevision: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>;

package/dist/shared/schemas/api.schema.js

@@ -39,6 +39,11 @@ export const SubmitReviewBodySchema = z.strictObject({
     noteIds: z.array(z.string().min(1)),
     baseRevision: BaseRevisionSchema,
 });
+/** Marquage du retour soumis comme traité par le relecteur, avec une note facultative. */
+export const MarkProcessedBodySchema = z.strictObject({
+    note: z.string().trim().min(1, "the note is empty").nullable().optional(),
+    baseRevision: BaseRevisionSchema,
+});
 /** Données IPC des requêtes de la GUI qui visent une analyse. */
 export const AnalysisRequestSchema = z.strictObject({ analysisId: z.string().min(1) });
 export const SetFileReviewedRequestSchema = AnalysisRequestSchema.extend({ body: SetFileReviewedBodySchema });
@@ -56,3 +61,4 @@ export const DeleteNoteRequestSchema = AnalysisRequestSchema.extend({
     body: DeleteNoteBodySchema,
 });
 export const SubmitReviewRequestSchema = AnalysisRequestSchema.extend({ body: SubmitReviewBodySchema });
+export const MarkProcessedRequestSchema = AnalysisRequestSchema.extend({ body: MarkProcessedBodySchema });

package/dist/shared/schemas/ipc.schema.d.ts

@@ -40,5 +40,5 @@ export type ChangesResponse = {
     events: IPCMessage[];
 };
 /** Requêtes du GUI worker au maître ; chacune reçoit une réponse de même `correlationId`. */
-export declare const GUI_REQUEST_TYPES: readonly ["GET_CONFIG", "LIST_ANALYSES", "GET_ANALYSIS", "GET_DIFF", "SET_FILE_REVIEWED", "SET_FINDING_STATUS", "ADD_NOTE", "UPDATE_NOTE", "DELETE_NOTE", "SUBMIT_REVIEW"];
+export declare const GUI_REQUEST_TYPES: readonly ["GET_CONFIG", "LIST_ANALYSES", "GET_ANALYSIS", "GET_DIFF", "SET_FILE_REVIEWED", "SET_FINDING_STATUS", "ADD_NOTE", "UPDATE_NOTE", "DELETE_NOTE", "SUBMIT_REVIEW", "MARK_PROCESSED"];
 export type GuiRequestType = (typeof GUI_REQUEST_TYPES)[number];

package/dist/shared/schemas/ipc.schema.js

@@ -28,4 +28,5 @@ export const GUI_REQUEST_TYPES = [
     "UPDATE_NOTE",
     "DELETE_NOTE",
     "SUBMIT_REVIEW",
+    "MARK_PROCESSED",
 ];

package/dist/src/core/migrate.d.ts

@@ -21,6 +21,11 @@ export declare const addNoteFindingIds: MigrationStep;
  * avant ce format est à traiter, sans version précédente.
  */
 export declare const addReviewProcessing: MigrationStep;
+/**
+ * Ajoute `by: "agent"` aux traitements enregistrés sans auteur, dans la revue et
+ * dans sa version soumise précédente : seul l'agent pouvait alors les poser.
+ */
+export declare const addProcessingAuthor: MigrationStep;
 /** Étapes appliquées aux analyses (`analyses/<id>.json`), dans l'ordre. */
 export declare const ANALYSIS_MIGRATIONS: readonly MigrationStep[];
 /** Étapes appliquées aux snapshots de diff (`diffs/<id>.json`), dans l'ordre. */

package/dist/src/core/migrate.js

@@ -49,8 +49,45 @@ export const addReviewProcessing = (doc) => {
         return null;
     return { ...doc, review: { ...raw, processed: raw.processed ?? null, previousSubmission: raw.previousSubmission ?? null } };
 };
+/** `processed` augmenté de `by: "agent"` quand il n'a pas d'auteur ; null quand il n'y a rien à changer. */
+function withProcessingAuthor(processed) {
+    if (!processed || typeof processed !== "object" || Array.isArray(processed))
+        return null;
+    const raw = processed;
+    return raw.by !== undefined ? null : { ...raw, by: "agent" };
+}
+/**
+ * Ajoute `by: "agent"` aux traitements enregistrés sans auteur, dans la revue et
+ * dans sa version soumise précédente : seul l'agent pouvait alors les poser.
+ */
+export const addProcessingAuthor = (doc) => {
+    const review = doc.review;
+    if (!review || typeof review !== "object" || Array.isArray(review))
+        return null;
+    const raw = review;
+    const processed = withProcessingAuthor(raw.processed);
+    const previous = raw.previousSubmission;
+    const previousProcessed = previous && typeof previous === "object" ? withProcessingAuthor(previous.processed) : null;
+    if (processed === null && previousProcessed === null)
+        return null;
+    return {
+        ...doc,
+        review: {
+            ...raw,
+            ...(processed === null ? {} : { processed }),
+            ...(previousProcessed === null ? {} : { previousSubmission: { ...previous, processed: previousProcessed } }),
+        },
+    };
+};
 /** Étapes appliquées aux analyses (`analyses/<id>.json`), dans l'ordre. */
-export const ANALYSIS_MIGRATIONS = [addProject, addOverview, addExplanations, addNoteFindingIds, addReviewProcessing];
+export const ANALYSIS_MIGRATIONS = [
+    addProject,
+    addOverview,
+    addExplanations,
+    addNoteFindingIds,
+    addReviewProcessing,
+    addProcessingAuthor,
+];
 /** Étapes appliquées aux snapshots de diff (`diffs/<id>.json`), dans l'ordre. */
 export const SNAPSHOT_MIGRATIONS = [];
 /** Applique `steps` à la suite. Renvoie null si aucune étape n'a modifié le document. */

package/dist/src/core/review-actions.d.ts

@@ -1,6 +1,6 @@
-import type { Analysis } from "../../shared/schemas/analysis.schema.js";
-import type { AddNoteBody, DeleteNoteBody, SetFileReviewedBody, SetFindingStatusBody, SubmitReviewBody, UpdateNoteBody } from "../../shared/schemas/api.schema.js";
-import type { AnalysisStore } from "./analysis-store.js";
+import type { Analysis, Editor } from "../../shared/schemas/analysis.schema.js";
+import type { AddNoteBody, DeleteNoteBody, MarkProcessedBody, SetFileReviewedBody, SetFindingStatusBody, SubmitReviewBody, UpdateNoteBody } from "../../shared/schemas/api.schema.js";
+import type { AnalysisStore, MutateOptions } from "./analysis-store.js";
 /**
  * Modifications faites par le relecteur depuis la GUI. Chacune passe par
  * `store.mutate(id, "user", …, { baseRevision })` et renvoie l'analyse écrite.
@@ -25,6 +25,19 @@ export declare function addNote(store: AnalysisStore, analysisId: string, body:
 export declare function updateNote(store: AnalysisStore, analysisId: string, noteId: string, body: UpdateNoteBody): Analysis;
 /** Supprime une remarque et la retire de la sélection de la revue. */
 export declare function deleteNote(store: AnalysisStore, analysisId: string, noteId: string, body: DeleteNoteBody): Analysis;
+/** Analyse marquée traitée, et date du marquage qu'elle remplace s'il y en avait un. */
+export interface MarkProcessedResult {
+    analysis: Analysis;
+    replaced: string | null;
+}
+/**
+ * Marque traité le retour soumis d'une analyse : date, note facultative et
+ * auteur (`agent` par l'outil MCP, `user` depuis la GUI). Refusé tant que la
+ * revue n'est pas soumise ; un nouveau marquage remplace le précédent.
+ */
+export declare function markFeedbackProcessed(store: AnalysisStore, analysisId: string, editor: Editor, note: string | null, options?: MutateOptions): MarkProcessedResult;
+/** Marque traité, depuis la GUI, le retour soumis d'une analyse. */
+export declare function markProcessedByReviewer(store: AnalysisStore, analysisId: string, body: MarkProcessedBody): Analysis;
 /**
  * Soumet la revue : décision, points retenus et prompt calculé ici. La revue
  * soumise est à traiter par l'agent. Une nouvelle soumission remplace la

package/dist/src/core/review-actions.js

@@ -86,6 +86,31 @@ export function deleteNote(store, analysisId, noteId, body) {
         draft.review.selectedNoteIds = draft.review.selectedNoteIds.filter((id) => id !== noteId);
     }, { baseRevision: body.baseRevision });
 }
+/**
+ * Marque traité le retour soumis d'une analyse : date, note facultative et
+ * auteur (`agent` par l'outil MCP, `user` depuis la GUI). Refusé tant que la
+ * revue n'est pas soumise ; un nouveau marquage remplace le précédent.
+ */
+export function markFeedbackProcessed(store, analysisId, editor, note, options = {}) {
+    let replaced = null;
+    const analysis = store.mutate(analysisId, editor, (draft) => {
+        const review = draft.review;
+        if (review.state !== "submitted") {
+            const reopened = review.previousSubmission;
+            throw new AnalysisError(reopened
+                ? `The review of analysis "${analysisId}" is not submitted: the reviewer reopened the feedback submitted at ${reopened.submittedAt} and is changing it. ` +
+                    `Wait until it is submitted again, then read it with get_review_feedback.`
+                : `The review of analysis "${analysisId}" is not submitted yet: there is no feedback to mark processed.`);
+        }
+        replaced = review.processed?.at ?? null;
+        review.processed = { at: new Date().toISOString(), note, by: editor };
+    }, options);
+    return { analysis, replaced };
+}
+/** Marque traité, depuis la GUI, le retour soumis d'une analyse. */
+export function markProcessedByReviewer(store, analysisId, body) {
+    return markFeedbackProcessed(store, analysisId, "user", body.note ?? null, { baseRevision: body.baseRevision }).analysis;
+}
 function assertKnownIds(label, ids, known) {
     const knownSet = new Set(known);
     const unknown = ids.filter((id) => !knownSet.has(id));

package/dist/src/gui-worker.js

@@ -7,7 +7,7 @@ import fs from "fs";
 import { fileURLToPath } from "url";
 import { randomUUID } from "crypto";
 import { IPCMessageSchema, PUSHED_EVENT_TYPES } from "../shared/schemas/ipc.schema.js";
-import { AddNoteBodySchema, DeleteNoteBodySchema, SetFileReviewedBodySchema, SetFindingStatusBodySchema, SubmitReviewBodySchema, UpdateNoteBodySchema, } from "../shared/schemas/api.schema.js";
+import { AddNoteBodySchema, DeleteNoteBodySchema, MarkProcessedBodySchema, SetFileReviewedBodySchema, SetFindingStatusBodySchema, SubmitReviewBodySchema, UpdateNoteBodySchema, } from "../shared/schemas/api.schema.js";
 import { resolveLogDir } from "./core/log-dir.js";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 function findProjectRoot(startDir) {
@@ -276,6 +276,12 @@ app.post("/api/analyses/:id/review", async (c) => {
         return read.response;
     return forward(c, "SUBMIT_REVIEW", { analysisId: c.req.param("id"), body: read.body });
 });
+app.post("/api/analyses/:id/review/processed", async (c) => {
+    const read = await readBody(c, MarkProcessedBodySchema);
+    if ("response" in read)
+        return read.response;
+    return forward(c, "MARK_PROCESSED", { analysisId: c.req.param("id"), body: read.body });
+});
 /** Route d'API inconnue : 404 explicite plutôt que la page de la SPA. */
 app.all("/api/*", (c) => c.json({ error: `Unknown API route: ${c.req.method} ${c.req.path}` }, 404));
 // Fichiers statiques de la SPA

package/dist/src/index.js

@@ -16,9 +16,9 @@ import { DEFAULT_HEAD_REF, localRepo } from "./core/git.js";
 import { agentRepo } from "./core/agent-repo.js";
 import { EXEC_ARG, handleAgentExec } from "./core/gateway-exec.js";
 import { resolveRole } from "./core/role.js";
-import { addNote, deleteNote, setFileReviewed, setFindingStatus, submitReview, updateNote } from "./core/review-actions.js";
+import { addNote, deleteNote, markProcessedByReviewer, setFileReviewed, setFindingStatus, submitReview, updateNote, } from "./core/review-actions.js";
 import { GUI_REQUEST_TYPES, IPCMessageSchema } from "../shared/schemas/ipc.schema.js";
-import { AddNoteRequestSchema, AnalysisRequestSchema, DeleteNoteRequestSchema, SetFileReviewedRequestSchema, SetFindingStatusRequestSchema, SubmitReviewRequestSchema, UpdateNoteRequestSchema, } from "../shared/schemas/api.schema.js";
+import { AddNoteRequestSchema, AnalysisRequestSchema, DeleteNoteRequestSchema, SetFileReviewedRequestSchema, SetFindingStatusRequestSchema, SubmitReviewRequestSchema, MarkProcessedRequestSchema, UpdateNoteRequestSchema, } from "../shared/schemas/api.schema.js";
 import { ANALYSIS_MODES, DIAGRAM_KINDS, EXPLANATION_SIDES, FINDING_KINDS, NODE_SHAPES, NODE_STATUSES, SEVERITIES, } from "../shared/schemas/analysis.schema.js";
 import { errorResult, textResult } from "./tools/types.js";
 import { createAnalysis } from "./tools/create-analysis.js";
@@ -223,6 +223,12 @@ function handleGuiRequest(msg) {
             afterUserMutation(analysis.id);
             return { analysis };
         }
+        case "MARK_PROCESSED": {
+            const request = parseRequest(MarkProcessedRequestSchema, msg.data);
+            const analysis = markProcessedByReviewer(store, request.analysisId, request.body);
+            afterUserMutation(analysis.id);
+            return { analysis };
+        }
         default:
             throw new Error(`GUI request ${msg.type} has no handler.`);
     }

package/dist/src/tools/format.js

@@ -83,7 +83,7 @@ export function progressLabel(progress) {
         ? "pending processing"
         : progress.processed === null
             ? "nothing to process"
-            : `processed at ${progress.processed.at}`;
+            : `processed at ${progress.processed.at}${progress.processed.by === "user" ? " by the reviewer" : ""}`;
     const decision = progress.state === "submitted" ? `, decision ${progress.decision}, ${processing}` : "";
     return `${REVIEW_PROGRESS_TEXT[progress.state]}${decision} (${progress.reviewedFiles}/${progress.totalFiles} files reviewed)`;
 }

package/dist/src/tools/get-review-feedback.js

@@ -2,10 +2,12 @@ import { hasNoChanges, needsProcessing, recordSubmission, reviewProgress, submis
 import { sortBySeverity } from "../../shared/severity.js";
 import { findingLine, indentBlock, noteLocationLabel, overviewLines, progressLabel } from "./format.js";
 import { rejectUnknownFields, requireString, textResult } from "./types.js";
-/** `processed at <date> (note: …)`, `nothing to process (approved)` ou `not processed`. */
+/** `processed at <date> by the agent (note: …)`, `nothing to process (approved)` ou `not processed`. */
 function processingLabel(decision, processed) {
-    if (processed !== null)
-        return `processed at ${processed.at}${processed.note === null ? "" : ` (note: ${processed.note})`}`;
+    if (processed !== null) {
+        const by = processed.by === "user" ? "the reviewer" : "the agent";
+        return `processed at ${processed.at} by ${by}${processed.note === null ? "" : ` (note: ${processed.note})`}`;
+    }
     return decision === "approve" ? "nothing to process (approved)" : "not processed";
 }
 /** `submitted at <date>, decision <d>, processed at <date>…` : rappel d'une version soumise. */

package/dist/src/tools/mark-feedback-processed.d.ts

@@ -1,8 +1,7 @@
 import type { AnalysisStore } from "../core/analysis-store.js";
 import { type Args, type MutationResult } from "./types.js";
 /**
- * Marque traité le retour soumis d'une analyse, avec la date et une note
- * facultative. Le retour reste lisible avec get_review_feedback. Refusé tant
- * que la revue n'est pas soumise ; un nouveau marquage remplace le précédent.
+ * Marque traité, au nom de l'agent, le retour soumis d'une analyse, avec la date
+ * et une note facultative. Le retour reste lisible avec get_review_feedback.
  */
 export declare function markFeedbackProcessed(store: AnalysisStore, args: Args): MutationResult;

package/dist/src/tools/mark-feedback-processed.js

@@ -1,27 +1,14 @@
-import { AnalysisError } from "../core/errors.js";
+import { markFeedbackProcessed as markProcessed } from "../core/review-actions.js";
 import { optionalString, rejectUnknownFields, requireString, textResult } from "./types.js";
 /**
- * Marque traité le retour soumis d'une analyse, avec la date et une note
- * facultative. Le retour reste lisible avec get_review_feedback. Refusé tant
- * que la revue n'est pas soumise ; un nouveau marquage remplace le précédent.
+ * Marque traité, au nom de l'agent, le retour soumis d'une analyse, avec la date
+ * et une note facultative. Le retour reste lisible avec get_review_feedback.
  */
 export function markFeedbackProcessed(store, args) {
     rejectUnknownFields(args, ["analysis_id", "note"]);
     const id = requireString(args, "analysis_id");
     const note = optionalString(args, "note") ?? null;
-    let replaced = null;
-    const updated = store.mutate(id, "agent", (draft) => {
-        const review = draft.review;
-        if (review.state !== "submitted") {
-            const reopened = review.previousSubmission;
-            throw new AnalysisError(reopened
-                ? `The review of analysis "${id}" is not submitted: the reviewer reopened the feedback submitted at ${reopened.submittedAt} and is changing it. ` +
-                    `Wait until it is submitted again, then read it with get_review_feedback.`
-                : `The review of analysis "${id}" is not submitted yet: there is no feedback to mark processed.`);
-        }
-        replaced = review.processed?.at ?? null;
-        review.processed = { at: new Date().toISOString(), note };
-    });
+    const { analysis: updated, replaced } = markProcessed(store, id, "agent", note);
     const processed = updated.review.processed;
     const lines = [
         `Marked the feedback of "${updated.title}" (${updated.id}), submitted at ${updated.review.submittedAt}, as processed at ${processed.at}.`,