MinorBaek/wiki-synthesize

Que fait wiki-synthesize ?

Avant la première exécution, lisez docs/GOTCHAS.md dans le kit (imprévus opérationnels pour l'ingestion, la synthèse et le lint) et docs/SEALS.md (le format des scellés).

Le « chirurgien » de la couche de synthèse vivante. Il réorganise le stock de résultats déjà vérifiés d'une note (## Key Findings dans une note de concept ; les sections porteuses d'affirmations d'une note de méthode) en un bloc État-des-Connaissances qui capture le flux des preuves : résolu, contesté, supplanté, émergent. Il n'invente JAMAIS d'affirmations. Chaque entrée remonte à un résultat existant, et chaque nouvelle entrée ou modification est vérifiée par rapport au PDF de chaque travail qu'elle cite avant que l'utilisateur ne la ratifie (vérification des preuves, niveau 2).

Modes

• par défaut : /wiki-synthesize <NomNote> synthétise une note de concept ou de méthode.
• liste de travail : /wiki-synthesize (sans argument) exécute wiki-lint Vérification 15, puis présente check15_missing priorisé (champs listés dans synthesis.priority_fields en premier, puis par nombre de travaux sources, décroissant) plus check15_stale (candidats à la re-synthèse), et demande quelle note traiter. La liste de travail est un backlog, pas une obligation de tout faire maintenant. L'ensemble éligible est ce que la Vérification 15 rapporte en direct ; un nombre figé écrit dans un document devient obsolète.
• batch : /wiki-synthesize --batch [N] est un mode de campagne de gestion par exception (vague par défaut de 8). Il exécute la Vérification 15, forme une vague prioritaire, répartit des sous-agents parallèles (chacun suit SYNTHESIS-WORKFLOW.md et renvoie un bloc plus un auto-rapport, sans jamais écrire), verrouille chaque écriture avec la vérification des preuves et scripts/synth_validate.py, écrit les notes propres, et escalade sur 4 déclencheurs (T1 nombre clé non vérifiable, T2 perte d'information, T3 anomalie structurelle, T4 faible confiance du sous-agent) et sur tout défaut que la vérification trouve. Voir references/BATCH-WORKFLOW.md. Proposez d'abord les sous-agents d'une vague à l'utilisateur (ce qu'ils font, combien, quel modèle) et attendez le feu vert.

Rôle et limites

Fait : lire le stock de résultats d'une note, pondérer par evidence_level plus mesure inline, rédiger le bloc, vérifier chaque nouvelle entrée ou modification par rapport au PDF, présenter pour ratification, puis écrire (insérer le bloc et absorber ## Controversies or Gaps), sceller les notes sources, exécuter la porte, journaliser.

Ne fait PAS : inventer des nombres ou des affirmations, créer des notes debates/ (signaler les candidats dans le rapport à la place), toucher aux notes en dessous du seuil de synthèse, ou écrire quoi que ce soit avant la ratification par l'utilisateur.

Où se trouvent les choses

Les chemins proviennent de wiki.config.json. Notes : <wiki_root>/concepts/, methods/, papers/, books/. Lisez toujours WIKI_SCHEMA.md (Couche de Synthèse Vivante) avant de commencer.

Seuil (doit être vérifié avant la synthèse)

status: final ET (synthesis.min_sources ou plus de travaux sources distincts (3 par défaut) OU au moins une source citée avec evidence_level dans synthesis.sr_levels (par défaut SR-MA, SR)). C'est exactement le test de qualification de la Vérification 15 de wiki-lint. S'il n'est pas vérifié : rapporter et ARRÊTER.

Flux de travail

Procédure complète dans references/SYNTHESIS-WORKFLOW.md. Résumé : lire les contrats, résoudre la note (exact test -f/recherche de contenu, jamais un glob seul), porte de seuil, garde pré-texte intégral, regrouper les résultats en sous-questions, vérifier les nouvelles entrées ou modifications par rapport au PDF, proposer le bloc dans le chat avec citations et pages, ratifier, écrire (scripts/synth_write.py : insérer après ## Definition, absorber Controversies, timbrer), sceller les notes sources (<kit>/tools/seal.py), diff de re-synthèse si un bloc existe déjà, puis journaliser, réexécuter la porte et réexécuter la Vérification 15.

Règles de sécurité

• Ne jamais inventer. Chaque entrée remonte à un résultat existant ; pas de nouveaux nombres de mémoire ou de la note source.
• Vérification des preuves, niveau 2 : pas de nouvelle entrée ou modification sans vérification PDF. Jusqu'à 3 travaux distincts, l'orchestrateur les vérifie ; au-delà, il propose un sous-agent avec un briefing restreint au diff et attend l'accord de l'utilisateur. Tout défaut est relu dans le PDF avant tout changement, et les notes sources sont scellées avec le nom de la note. Un scellé de texte intégral sur une note source ne protège pas ce qu'une note dit de ce travail : dans un audit passé de cette méthode, environ 4 paires note-source échantillonnées sur 10 présentaient un défaut.
• Humain dans la boucle. Modes interactifs : proposer, ratifier, écrire (pas d'écriture avant l'accord de l'utilisateur). Mode batch : synth_validate.py verrouille chaque écriture et les 4 déclencheurs escaladent ; jamais entièrement autonome.
• Zéro perte d'information. Chaque puce ## Controversies or Gaps doit correspondre à une entrée du bloc avant que cette section ne soit absorbée.
• Garde pré-texte intégral. Un article cité dans la cohorte pré-texte intégral (une note d'article datée avant synthesis.prefulltext_cutoff et non scellée en texte intégral, ou scellée seulement au niveau du résumé) abaisse la confiance de l'entrée affectée et reçoit un drapeau ⚠ inline ; mettre en pause l'entrée uniquement si le nombre sur lequel elle repose est lui-même non vérifiable. Les chapitres de livre sont des ancres de confiance sauf si leur propre status: est draft ou stub, ce qui signifie que la note indique qu'elle a été ingérée sans le texte intégral (une source_verification au niveau du texte intégral remplace le statut). synth_validate.py V4 applique cela mécaniquement.
• Les affirmations ont besoin de sources. Chaque entrée cite des [[wikilinks]].
• Priorité au système de fichiers. Utilisez les outils de fichiers de l'hôte ; aucun plugin Obsidian ou MCP n'est requis.

Compétences associées

• wiki-lint : La Vérification 15 produit la liste de travail de cette compétence ; la Vérification 32 signale une paire (note, travail) sans scellé. Exécutez-la après la synthèse pour confirmer l'absence de dérive (liens propres, Vérification 15 retire la note de missing).
• wiki-ingest : en amont. Les résultats que cette compétence réorganise ont été écrits par l'ingestion.

Références

• references/SYNTHESIS-WORKFLOW.md : la procédure détaillée, le modèle de bloc, la logique de garde, la gestion de la re-synthèse.
• references/BATCH-WORKFLOW.md : mode batch, la boucle d'orchestration, le briefing du sous-agent, la porte d'écriture V1-V5, les déclencheurs d'escalade.
• scripts/synth_validate.py : la porte d'écriture et un balayage complet du wiki. scripts/synth_write.py : insertion de bloc. <kit>/tools/seal.py : scellement.