Fusion de main (1f, prompts à copier) dans nouvelle-partie-directe

Conflits résolus en gardant les deux apports : la feuille du prompt et la
correction de reviewFinishedGame dans app.ts ; prompts et nouvelle-partie
dans tests/browser.sh.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

app/src/ui/advice-texts.ts

@@ -48,8 +48,6 @@ export const CUBE_GLOSSARY: Readonly<Record<CubeAction, { file: string; term: st
     pass: { file: "passer", term: "Passer" },
 };
 
-/** Un nombre à la française, signé, à trois décimales : « −0,123 ». */
-export function formatEquity(value: number): string {
-    const text = Math.abs(value).toFixed(3).replace(".", ",");
-    return value < -0.0005 ? `−${text}` : value > 0.0005 ? `+${text}` : text;
-}
+/** Un nombre à la française, signé, à trois décimales : « −0,123 » ; la
+ * même écriture que les prompts (domain/analysis/numbers.ts). */
+export { formatEquity } from "../domain/analysis/numbers.js";

app/src/ui/advice-view.ts

@@ -7,6 +7,7 @@
 // Copyright (C) 2026 les auteurs d'Ustagammon.
 // Licence : GPLv3 ou ultérieure (voir LICENSE).
 
+import { rankingRows } from "../domain/analysis/numbers.js";
 import { type MasterPhrases, masterWords } from "../domain/analysis/phrases.js";
 import {
     type Advice,
@@ -17,6 +18,7 @@ import {
 } from "../domain/game/advice.js";
 import type { Game } from "../domain/game/game.js";
 import { ADVICE_TEXTS, CUBE_GLOSSARY, formatEquity } from "./advice-texts.js";
+import { askAiLink, clearSheet } from "./ask-ai.js";
 import { type IconName, icon } from "./icons.js";
 import { boardSvg, createMovePlayer, drawSteps, type MovePlayer } from "./move-board.js";
 import { showWithNotation } from "./notation.js";
@@ -47,6 +49,8 @@ export interface AdviceView {
     /** Ouvre la feuille sur le conseil de l'événement eventId. */
     show(eventId: string): Promise<void>;
     hide(): void;
+    /** La feuille, où la page du prompt prend la place du contenu (1f). */
+    readonly sheet: HTMLElement;
 }
 
 type Shown = "mine" | "best";
@@ -91,7 +95,7 @@ export function createAdviceView(options: AdviceViewOptions): AdviceView {
         const id = ++opened;
         const game = options.game();
         const advice = game?.advice[eventId] ?? null;
-        sheet.replaceChildren();
+        clearSheet(sheet);
         veil.hidden = false;
         const head = element(sheet, "div", { className: "sheet-head" });
         element(head, "span", { className: "grip" }).setAttribute("aria-hidden", "true");
@@ -149,12 +153,21 @@ export function createAdviceView(options: AdviceViewOptions): AdviceView {
             });
             link.href = routeHash({ screen: "glossary", term: entry.file });
         }
-        closeButton();
+        closeButton(advice.eventId);
         close.focus();
     }
 
-    function closeButton(): void {
+    /** « Demander à une IA » (étape 1f), s'il y a un conseil, et
+     * « Fermer ». */
+    function closeButton(eventId: string | null = null): void {
         const actions = element(sheet, "div", { className: "explain-actions" });
+        if (eventId !== null) {
+            askAiLink(
+                actions,
+                "explain-ask-ai",
+                routeHash({ screen: "explanation", event: eventId, ai: true }),
+            );
+        }
         const done = element(actions, "button", {
             id: "explain-done",
             className: "secondary",
@@ -278,18 +291,8 @@ export function createAdviceView(options: AdviceViewOptions): AdviceView {
         if (advice.kind === "move") {
             // Les écarts du classement se lisent par rapport à son premier
             // coup ; votre coup, s'il n'y figure pas, avec l'écart de
-            // l'analyse du coup joué.
-            const first = advice.ranking[0]?.equity ?? advice.best.equity;
-            const listed = advice.ranking.map((move, i) => ({
-                move,
-                rank: i + 1,
-                loss: move.equity - first,
-            }));
-            if (!advice.ranking.some((m) => m.notation === advice.played.notation)) {
-                listed.push({ move: advice.played, rank: advice.rank, loss: advice.equityLoss });
-            }
-            for (const { move, rank, loss } of listed) {
-                const mine = move.notation === advice.played.notation;
+            // l'analyse du coup joué (les mêmes lignes que le prompt).
+            for (const { move, rank, loss, played: mine } of rankingRows(advice)) {
                 row(
                     [
                         String(rank),
@@ -333,12 +336,13 @@ export function createAdviceView(options: AdviceViewOptions): AdviceView {
 
     return {
         show,
+        sheet,
         hide() {
             opened++;
             player?.stop();
             if (!veil.hidden) {
                 veil.hidden = true;
-                sheet.replaceChildren();
+                clearSheet(sheet);
             }
         },
     };

app/src/ui/analysis-view.ts

@@ -31,6 +31,7 @@ import type { GameJournal } from "../domain/game/events.js";
 import type { Game, MoveSteps } from "../domain/game/game.js";
 import { formatHalfMoves } from "../domain/game/position.js";
 import { VERDICT_ICONS } from "./advice-view.js";
+import { askAiLink } from "./ask-ai.js";
 import { icon } from "./icons.js";
 import { MATCH_TEXTS } from "./match-texts.js";
 import { boardSvg, createMovePlayer, drawSteps, type MovePlayer } from "./move-board.js";
@@ -212,9 +213,11 @@ export function createAnalysisView(options: AnalysisViewOptions): AnalysisView {
         text: REVIEW_TEXTS.replayFromHere,
     });
     replayButton.type = "button";
-    // L'emplacement de « Demander à une IA » (étape 1f).
+    // « Demander à une IA » (étape 1f) : le prompt de la décision du joueur
+    // dans ce coup, s'il y en a une.
     const slot = element(viewerActions, "div", { className: "ask-ai-slot" });
     slot.dataset.slot = "ask-ai";
+    const askAi = askAiLink(slot, "analysis-ask-ai", "#/");
     const replayHint = element(viewerText, "p", {
         className: "viewer-legend",
         text: REVIEW_TEXTS.replayHint,
@@ -412,6 +415,8 @@ export function createAnalysisView(options: AnalysisViewOptions): AnalysisView {
             theirs?.eventId ?? "",
             current.phrases !== null,
         ].join("|");
+        askAi.hidden = main === null;
+        askAi.href = routeHash({ screen: "analysis", game: current.id, turn: selected, ai: true });
         replayButton.hidden = replayPoint(current.journal, turn) === null;
         replayHint.hidden = replayButton.hidden;
         replayButton.onclick = () => {

app/src/ui/app.ts

@@ -21,7 +21,13 @@
 // dessine l'écran que désigne l'adresse, au démarrage et à chaque
 // changement. Les actions de jeu restent des boutons.
 
-import { missingAnalyses, readyForSummary } from "../domain/analysis/game-analysis.js";
+import {
+    gameTurns,
+    mainAdvice,
+    missingAnalyses,
+    readyForSummary,
+    summarizeAnalysis,
+} from "../domain/analysis/game-analysis.js";
 import {
     type MasterPhrases,
     masterLine,
@@ -42,6 +48,8 @@ import { ADVICE_TEXTS } from "./advice-texts.js";
 import { type Analyse, createAdviceTracker } from "./advice-tracker.js";
 import { createAdviceView, VERDICT_ICONS } from "./advice-view.js";
 import { createAnalysisView } from "./analysis-view.js";
+import { createPromptView, type PromptResult } from "./ask-ai.js";
+import { ASK_AI_TEXTS } from "./ask-ai-texts.js";
 import {
     boardModel,
     moveTargets,
@@ -78,8 +86,16 @@ import { MATCH_TEXTS } from "./match-texts.js";
 import { replacingLink, startNavigation } from "./navigation.js";
 import { createNewGameView } from "./new-game-view.js";
 import { showWithNotation } from "./notation.js";
+import { createPromptSource, type PromptsAccess } from "./prompt-source.js";
 import { createReviewRunner, type RunAnalysis } from "./review-runner.js";
-import { isHelpScreen, type Route, routeHash } from "./router.js";
+import {
+    type AiRoute,
+    isAiRoute,
+    isHelpScreen,
+    type Route,
+    routeHash,
+    withoutAi,
+} from "./router.js";
 import {
     chosenGame,
     isFirstLaunch,
@@ -142,6 +158,8 @@ export interface AppOptions {
     /** L'analyse d'une partie pour son bilan (étape 1e), une analyse à la
      * fois, sur le même moteur à part. */
     readonly analyseGame: RunAnalysis;
+    /** Les positions que décrivent les prompts pour une IA (étape 1f). */
+    readonly prompts: PromptsAccess;
 }
 
 /** La source des phrases du maître, copiée dans le site (make site). */
@@ -229,6 +247,7 @@ export function startApp(options: AppOptions): void {
         adviceLine: byId<HTMLAnchorElement>("advice-line"),
         explainVeil: byId("explain-veil"),
         summaryVeil: byId("summary-veil"),
+        promptVeil: byId("prompt-veil"),
         analysis: byId("analysis"),
         menuAdvice: byId<HTMLButtonElement>("menu-advice"),
         prompt: byId("prompt"),
@@ -1308,6 +1327,112 @@ export function startApp(options: AppOptions): void {
         back: (link) => leavingLink(link, (route) => route.screen === "analysis"),
     });
 
+    // ------------------------------------------- Demander à une IA (1f)
+
+    // La feuille du prompt, à l'adresse …/ia : à la place de la feuille du
+    // maître ou du bilan, ou dans sa propre feuille au-dessus de l'analyse et
+    // du glossaire. Une seule feuille à la fois.
+    const promptSource = createPromptSource({
+        access: options.prompts,
+        phrases: () => phrasesLoading,
+        glossaryEntry: loadGlossaryEntry,
+    });
+    const promptView = createPromptView({
+        veil: ui.promptVeil,
+        back: () => closePrompt(),
+        close: () => closePromptSheet(),
+    });
+    // L'adresse de la feuille ouverte (null : fermée).
+    let promptShown: string | null = null;
+
+    /** « ‹ Explication », Échap ou le retour du téléphone : retour à l'écran
+     * d'où on l'a ouverte. */
+    function closePrompt(): void {
+        const route = navigation.route;
+        promptView.hide();
+        promptShown = null;
+        navigation.leave(isAiRoute, isAiRoute(route) ? routeHash(withoutAi(route)) : "#/");
+    }
+
+    /** La croix et « Fermer » : la feuille se ferme. Celle du maître ou le
+     * bilan, dont elle avait pris la place, se ferme avec elle. */
+    function closePromptSheet(): void {
+        const route = navigation.route;
+        if (route.screen === "explanation" || route.screen === "summary") {
+            promptView.hide();
+            promptShown = null;
+            leaveSheet();
+            return;
+        }
+        closePrompt();
+    }
+
+    /** Ouvre (ou met à jour) la feuille du prompt de l'adresse route. */
+    function showPrompt(route: AiRoute): void {
+        promptShown = routeHash(route);
+        const host =
+            route.screen === "explanation"
+                ? adviceView.sheet
+                : route.screen === "summary"
+                  ? summaryView.panel
+                  : null;
+        promptView.show(promptOf(route), {
+            host,
+            back: ASK_AI_TEXTS.back[route.screen],
+            backHref: routeHash(withoutAi(route)),
+        });
+    }
+
+    /** Le journal de la partie id, pour son bilan ou son analyse : celui de
+     * la partie à l'écran, ou celui du stockage. */
+    async function journalOf(id: string): Promise<GameJournal | null> {
+        const live = liveGame(id);
+        if (live !== null) {
+            return live.journal;
+        }
+        return reviewed?.id === id ? reviewed.journal : options.games.journal(id);
+    }
+
+    /** Le prompt de l'écran sous la feuille (route sans « /ia »). */
+    async function promptOf(route: AiRoute): Promise<PromptResult> {
+        await options.engineReady;
+        switch (route.screen) {
+            case "explanation": {
+                const advice = game?.advice[route.event];
+                return game === null || advice === undefined
+                    ? { message: ASK_AI_TEXTS.noAdvice }
+                    : promptSource.decision(game.journal, advice);
+            }
+            case "summary": {
+                const journal = await journalOf(route.game);
+                if (journal === null) {
+                    return { message: ASK_AI_TEXTS.missingGame };
+                }
+                return readyForSummary(journal)
+                    ? promptSource.summary(journal)
+                    : { message: ASK_AI_TEXTS.notReady };
+            }
+            case "analysis": {
+                const journal = await journalOf(route.game);
+                if (journal === null) {
+                    return { message: ASK_AI_TEXTS.missingGame };
+                }
+                // Le coup que montre l'analyse : celui de l'adresse, ou le
+                // coup à revoir (analysis-view.ts).
+                const turns = gameTurns(journal);
+                const fallback = summarizeAnalysis(journal).toReview?.turn ?? 1;
+                const n = Math.min(Math.max(1, route.turn ?? fallback), Math.max(1, turns.length));
+                const turn = turns[n - 1];
+                const advice = turn === undefined ? null : mainAdvice(journal, turn);
+                return advice === null
+                    ? { message: ASK_AI_TEXTS.noAdvice }
+                    : promptSource.decision(journal, advice);
+            }
+            case "glossary":
+                return promptSource.concept(route.term ?? "", game?.journal ?? null);
+        }
+    }
+
     /** La partie à l'écran, si c'est la partie id. */
     function liveGame(id: string): Game | null {
         return game !== null && options.games.shownId() === id ? game : null;
@@ -1374,6 +1499,10 @@ export function startApp(options: AppOptions): void {
         if ((route.screen !== "summary" && route.screen !== "analysis") || route.game !== id) {
             return;
         }
+        // La feuille du prompt attendait l'analyse : elle se met à jour.
+        if (isAiRoute(route) && promptView.isOpen && !promptView.ready) {
+            showPrompt(route);
+        }
         const live = liveGame(id);
         const shown =
             missing || reviewed?.id !== id
@@ -1734,6 +1863,8 @@ export function startApp(options: AppOptions): void {
     let menuReturnFocus: HTMLElement | null = null;
     // L'écran sous la feuille d'installation : le dernier écran affiché.
     let underSheet: Route = { screen: "game" };
+    // L'événement de la feuille d'explication ouverte.
+    let explained: string | null = null;
 
     /** Dessine l'écran que désigne l'adresse (ADR 0013, amendement). */
     function applyRoute(route: Route): void {
@@ -1813,8 +1944,14 @@ export function startApp(options: AppOptions): void {
         if (route.screen === "explanation") {
             closeTransient();
             ui.menuVeil.hidden = true;
-            void adviceView.show(route.event);
+            // Ouvrir ou fermer la feuille du prompt ne redessine pas
+            // l'explication dessous.
+            if (ui.explainVeil.hidden || explained !== route.event) {
+                explained = route.event;
+                void adviceView.show(route.event);
+            }
         } else {
+            explained = null;
             adviceView.hide();
         }
         // Le bilan et l'analyse d'une partie : son journal, lu dans le
@@ -1868,6 +2005,18 @@ export function startApp(options: AppOptions): void {
             shownPosition = null;
         }
 
+        // La feuille du prompt pour une IA, au-dessus de son écran.
+        if (isAiRoute(route)) {
+            closeTransient();
+            ui.menuVeil.hidden = true;
+            if (!promptView.isOpen || promptShown !== routeHash(route)) {
+                showPrompt(route);
+            }
+        } else if (promptView.isOpen) {
+            promptView.hide();
+            promptShown = null;
+        }
+
         // Une adresse inconnue : la partie, avec un message, à l'adresse de
         // la partie.
         if (route.screen === "unknown") {
@@ -2307,6 +2456,15 @@ export function startApp(options: AppOptions): void {
         if (event.altKey || event.metaKey || (event.ctrlKey && event.key.toLowerCase() !== "z")) {
             return;
         }
+        // La feuille du prompt ouverte : Échap la ferme, et rien d'autre ne
+        // répond (les flèches font défiler le texte).
+        if (promptView.isOpen) {
+            if (event.key === "Escape") {
+                event.preventDefault();
+                closePrompt();
+            }
+            return;
+        }
         const onButton =
             event.target instanceof HTMLButtonElement || event.target instanceof HTMLAnchorElement;
         // L'écran d'analyse : les flèches passent d'un coup à l'autre.
@@ -2402,6 +2560,9 @@ export function startApp(options: AppOptions): void {
             if (route.screen === "explanation") {
                 void adviceView.show(route.event);
             }
+            if (isAiRoute(route)) {
+                showPrompt(route);
+            }
             if (route.screen === "summary" || route.screen === "analysis") {
                 void openReview(route.game);
             }

app/src/ui/ask-ai-texts.ts

@@ -0,0 +1,30 @@
+// Les textes de l'interface de « Demander à une IA » (étape 1f). Les
+// prompts eux-mêmes sont dans docs/prompts/ (une seule source, ADR 0008).
+//
+// Copyright (C) 2026 les auteurs d'Ustagammon.
+// Licence : GPLv3 ou ultérieure (voir LICENSE).
+
+export const ASK_AI_TEXTS = {
+    button: "Demander à une IA",
+    title: "Demander à une IA",
+    lead: "Une question toute prête, avec la position et les chiffres de GNU Backgammon. Relisez-la, copiez-la, puis collez-la dans l'IA de votre choix : le moteur décide, l'IA explique.",
+    textLabel: "Le prompt, à relire avant de le copier",
+    copy: "Copier le prompt",
+    copied: "Copié",
+    notCopied:
+        "Le navigateur refuse la copie : le texte est sélectionné, copiez-le avec le menu de votre téléphone.",
+    preparing: "Préparation du prompt…",
+    close: "Fermer",
+    /** « ‹ Explication » : l'écran d'où l'on vient, pour y revenir. */
+    back: {
+        explanation: "Explication",
+        summary: "Bilan",
+        analysis: "Analyse",
+        glossary: "Glossaire",
+    },
+    failed: "Le prompt n'a pas pu être préparé.",
+    noAdvice: "Pas de prompt pour cette décision : le maître ne l'a pas encore analysée.",
+    notReady: "Le maître analyse encore la partie : le prompt sera prêt avec le bilan.",
+    missingGame: "Cette partie n'est plus sur ce téléphone.",
+    missingTerm: "Ce terme n'est pas dans le glossaire.",
+} as const;

app/src/ui/ask-ai.ts

@@ -0,0 +1,310 @@
+// « Demander à une IA » (étape 1f ; charte, ecrans-etape-1.md, « 1f ») :
+// le bouton, secondaire, avec l'icône de copie ; et la feuille du prompt
+// (…/ia, ADR 0013), où le texte se relit avant d'être copié.
+//
+// Une seule feuille à la fois (recette de 1f) : ouverte depuis la feuille du
+// maître ou le bilan, la page du prompt prend la place de leur contenu, à la
+// même hauteur, avec « ‹ Explication » (ou « ‹ Bilan ») pour y revenir ;
+// depuis l'analyse ou le glossaire, qui ne sont pas des feuilles, elle monte
+// dans sa propre feuille. La copie passe par navigator.clipboard ; à défaut,
+// le texte est sélectionné dans la feuille et copié par le navigateur, ou
+// laissé sélectionné pour être copié à la main. Le bouton la confirme
+// (« ✓ Copié », 2 s).
+//
+// Copyright (C) 2026 les auteurs d'Ustagammon.
+// Licence : GPLv3 ou ultérieure (voir LICENSE).
+//
+// L'application n'appelle aucune IA et n'envoie rien : elle copie un texte.
+
+import { ASK_AI_TEXTS } from "./ask-ai-texts.js";
+import { icon } from "./icons.js";
+
+/** Durée de « ✓ Copié » sur le bouton (charte : 2 s). */
+export const COPIED_MS = 2000;
+
+/** Ce que montre la feuille : le prompt, ou pourquoi il n'y en a pas. */
+export type PromptResult = { readonly text: string } | { readonly message: string };
+
+/** Classe de la page du prompt, posée dans une autre feuille. */
+const PAGE_CLASS = "prompt-page";
+
+/** Le bouton « Demander à une IA » : un lien vers la feuille du prompt. */
+export function askAiLink(parent: HTMLElement, id: string, href: string): HTMLAnchorElement {
+    const link = document.createElement("a");
+    link.id = id;
+    link.className = "button secondary ask-ai";
+    link.href = href;
+    link.append(icon("copy"), ASK_AI_TEXTS.button);
+    parent.append(link);
+    return link;
+}
+
+/** Vide une feuille qui peut accueillir la page du prompt, sans l'ôter. */
+export function clearSheet(sheet: HTMLElement): void {
+    for (const child of [...sheet.children]) {
+        if (!child.classList.contains(PAGE_CLASS)) {
+            child.remove();
+        }
+    }
+}
+
+/** D'où l'on vient : la feuille dont la page prend la place (null : sa
+ * propre feuille) et le nom de l'écran, pour « ‹ Explication ». */
+export interface PromptPlace {
+    readonly host: HTMLElement | null;
+    readonly back: string;
+    /** L'adresse de l'écran d'où l'on vient (le lien de « ‹ … »). */
+    readonly backHref: string;
+}
+
+export interface PromptViewOptions {
+    /** Le voile de sa propre feuille (index.html) ; elle est construite ici. */
+    readonly veil: HTMLElement;
+    /** « ‹ Explication » : revenir à l'écran d'où l'on vient. */
+    readonly back: () => void;
+    /** La croix et « Fermer » : fermer la feuille. */
+    readonly close: () => void;
+}
+
+export interface PromptView {
+    /** Ouvre la feuille (ou la met à jour) sur un prompt en préparation. */
+    show(prompt: Promise<PromptResult>, place: PromptPlace): void;
+    hide(): void;
+    readonly isOpen: boolean;
+    /** Le prompt est affiché (pas un message). */
+    readonly ready: boolean;
+}
+
+function element<K extends keyof HTMLElementTagNameMap>(
+    parent: HTMLElement,
+    tag: K,
+    options: { id?: string; className?: string; text?: string } = {},
+): HTMLElementTagNameMap[K] {
+    const child = document.createElement(tag);
+    if (options.id !== undefined) {
+        child.id = options.id;
+    }
+    if (options.className !== undefined) {
+        child.className = options.className;
+    }
+    if (options.text !== undefined) {
+        child.textContent = options.text;
+    }
+    parent.append(child);
+    return child;
+}
+
+export function createPromptView(options: PromptViewOptions): PromptView {
+    const { veil } = options;
+    // Sa propre feuille, pour l'analyse et le glossaire.
+    const sheet = element(veil, "div", { id: "prompt-sheet", className: "sheet prompt-sheet" });
+    veil.addEventListener("click", (event) => {
+        if (event.target === veil) {
+            options.close();
+        }
+    });
+    // La page du prompt, posée dans sa feuille ou dans celle d'où l'on vient.
+    const page = element(sheet, "div", { id: "prompt-page", className: PAGE_CLASS });
+    page.setAttribute("role", "dialog");
+    page.setAttribute("aria-modal", "true");
+    page.setAttribute("aria-labelledby", "prompt-title");
+    const head = element(page, "div", { className: "sheet-head prompt-head" });
+    element(head, "span", { className: "grip" }).setAttribute("aria-hidden", "true");
+    const back = element(head, "a", { id: "prompt-back", className: "prompt-back" });
+    back.addEventListener("click", (event) => {
+        if (event.button !== 0 || event.ctrlKey || event.metaKey || event.shiftKey) {
+            return;
+        }
+        event.preventDefault();
+        options.back();
+    });
+    const closeIcon = element(head, "button", { id: "prompt-close", className: "icon-button" });
+    closeIcon.type = "button";
+    closeIcon.append(icon("close"));
+    closeIcon.setAttribute("aria-label", ASK_AI_TEXTS.close);
+    closeIcon.onclick = () => options.close();
+    element(page, "h2", { id: "prompt-title", className: "sheet-title", text: ASK_AI_TEXTS.title });
+    element(page, "p", { className: "prompt-lead", text: ASK_AI_TEXTS.lead });
+    const text = element(page, "pre", { id: "prompt-text", className: "prompt-text" });
+    text.tabIndex = 0;
+    text.setAttribute("aria-label", ASK_AI_TEXTS.textLabel);
+    const status = element(page, "p", { id: "prompt-status", className: "prompt-status" });
+    status.setAttribute("role", "status");
+    const actions = element(page, "div", { className: "prompt-actions" });
+    const done = element(actions, "button", {
+        id: "prompt-done",
+        className: "secondary",
+        text: ASK_AI_TEXTS.close,
+    });
+    done.type = "button";
+    done.onclick = () => options.close();
+    const copy = element(actions, "button", { id: "prompt-copy" });
+    copy.type = "button";
+    // Le libellé du bouton est annoncé quand il passe à « Copié ».
+    const copyLabel = document.createElement("span");
+    copyLabel.setAttribute("aria-live", "polite");
+
+    // Chaque ouverture a son numéro : un prompt qui arrive après une autre
+    // ouverture, ou après la fermeture, n'est pas montré.
+    let opened = 0;
+    let ready = false;
+    let open = false;
+    // La feuille d'où l'on vient, dont la page a pris la place.
+    let host: HTMLElement | null = null;
+    let copiedTimeout: ReturnType<typeof setTimeout> | null = null;
+
+    /** « Copier le prompt », ou « ✓ Copié » pendant 2 s. */
+    function showCopied(copied: boolean): void {
+        if (copiedTimeout !== null) {
+            clearTimeout(copiedTimeout);
+            copiedTimeout = null;
+        }
+        copy.classList.toggle("copied", copied);
+        copyLabel.textContent = copied ? ASK_AI_TEXTS.copied : ASK_AI_TEXTS.copy;
+        copy.replaceChildren(icon(copied ? "verdictGood" : "copy"), copyLabel);
+        if (copied) {
+            copiedTimeout = setTimeout(() => showCopied(false), COPIED_MS);
+        }
+    }
+    showCopied(false);
+
+    /** Pose la page dans la feuille d'où l'on vient, ou dans la sienne. */
+    function place(next: HTMLElement | null): void {
+        if (host !== next) {
+            host?.classList.remove("prompting");
+            host = next;
+        }
+        if (next === null) {
+            if (page.parentElement !== sheet) {
+                sheet.append(page);
+            }
+            veil.hidden = false;
+            return;
+        }
+        veil.hidden = true;
+        // La page couvre la feuille telle qu'elle s'affiche, défilée en haut.
+        next.scrollTop = 0;
+        next.classList.add("prompting");
+        if (page.parentElement !== next) {
+            next.append(page);
+        }
+    }
+
+    /** Le texte de la feuille, sélectionné : le repli quand le
+     * presse-papiers n'est pas accessible. */
+    function selectText(): void {
+        const selection = window.getSelection();
+        if (selection === null) {
+            return;
+        }
+        const range = document.createRange();
+        range.selectNodeContents(text);
+        selection.removeAllRanges();
+        selection.addRange(range);
+    }
+
+    async function copyText(): Promise<boolean> {
+        try {
+            await navigator.clipboard.writeText(text.textContent ?? "");
+            return true;
+        } catch {
+            // Hors contexte sûr (http sur le réseau local), ou refusé :
+            // repli ci-dessous.
+        }
+        selectText();
+        try {
+            return document.execCommand("copy");
+        } catch {
+            return false;
+        }
+    }
+
+    copy.onclick = async () => {
+        if (!ready) {
+            return;
+        }
+        const id = opened;
+        const copied = await copyText();
+        if (id !== opened) {
+            return;
+        }
+        if (copied) {
+            status.textContent = "";
+            showCopied(true);
+        } else {
+            selectText();
+            showCopied(false);
+            status.textContent = ASK_AI_TEXTS.notCopied;
+        }
+    };
+
+    return {
+        show(prompt, where) {
+            const id = ++opened;
+            const opening = !open || host !== where.host;
+            open = true;
+            back.textContent = `‹ ${where.back}`;
+            back.href = where.backHref;
+            place(where.host);
+            if (opening) {
+                ready = false;
+                text.textContent = "";
+                text.hidden = true;
+                copy.disabled = true;
+                showCopied(false);
+                status.textContent = ASK_AI_TEXTS.preparing;
+                delete page.dataset.ready;
+                back.focus();
+            }
+            prompt.then(
+                (result) => {
+                    if (id !== opened) {
+                        return;
+                    }
+                    if ("text" in result) {
+                        ready = true;
+                        text.textContent = result.text;
+                        text.hidden = false;
+                        copy.disabled = false;
+                        status.textContent = "";
+                        page.dataset.ready = "true";
+                    } else {
+                        ready = false;
+                        text.hidden = true;
+                        copy.disabled = true;
+                        status.textContent = result.message;
+                        delete page.dataset.ready;
+                    }
+                },
+                () => {
+                    if (id === opened) {
+                        ready = false;
+                        copy.disabled = true;
+                        status.textContent = ASK_AI_TEXTS.failed;
+                    }
+                },
+            );
+        },
+        hide() {
+            opened++;
+            ready = false;
+            if (!open) {
+                return;
+            }
+            open = false;
+            showCopied(false);
+            host?.classList.remove("prompting");
+            host = null;
+            veil.hidden = true;
+            sheet.append(page);
+            text.textContent = "";
+            delete page.dataset.ready;
+        },
+        get isOpen() {
+            return open;
+        },
+        get ready() {
+            return ready;
+        },
+    };
+}

app/src/ui/help.ts

@@ -13,6 +13,7 @@
 // que dit la réponse, ne s'affichent pas
 // (docs/identite/charte/accueil-tutoriel-aide.md, « Aide »).
 
+import { askAiLink } from "./ask-ai.js";
 import {
     type GlossaryEntry,
     type HelpFeature,
@@ -32,6 +33,7 @@ export const FEATURES = [
     "docs/scenarios/jouer-un-match.feature",
     "docs/scenarios/comprendre-mes-coups.feature",
     "docs/scenarios/revoir-ma-partie.feature",
+    "docs/scenarios/demander-a-une-ia.feature",
     "docs/scenarios/apprendre-les-regles.feature",
     "docs/scenarios/mes-parties.feature",
     "docs/scenarios/partager-une-position.feature",
@@ -124,7 +126,10 @@ export function createHelpView(container: HTMLElement, tabs: HTMLElement): HelpV
     notice.className = "help-notice";
     notice.setAttribute("role", "status");
     const questions: Question[] = [];
-    const terms = new Map<string, { dt: HTMLElement; card: HTMLElement; entry: GlossaryCard }>();
+    const terms = new Map<
+        string,
+        { dt: HTMLElement; card: HTMLElement; entry: GlossaryCard; askAi: HTMLAnchorElement }
+    >();
     let loading: Promise<boolean> | null = null;
     // La question ouverte au dernier affichage : refermée, elle reste en vue.
     let lastOpen: Question | null = null;
@@ -213,7 +218,14 @@ export function createHelpView(container: HTMLElement, tabs: HTMLElement): HelpV
                     a.href = routeHash({ screen: "glossary", term: other.name });
                 });
             }
-            terms.set(entry.name, { dt, card, entry });
+            // « Demander à une IA » (étape 1f), sur la fiche ouverte.
+            const askAi = askAiLink(
+                dd,
+                `glossary-ask-ai-${entry.name}`,
+                routeHash({ screen: "glossary", term: entry.name, ai: true }),
+            );
+            askAi.hidden = true;
+            terms.set(entry.name, { dt, card, entry, askAi });
         }
         search.addEventListener("input", () => {
             let shown = 0;
@@ -307,7 +319,8 @@ export function createHelpView(container: HTMLElement, tabs: HTMLElement): HelpV
                 q.section.classList.toggle("open", open);
             }
             const term = route.screen === "glossary" ? route.term : null;
-            for (const [name, { dt, card }] of terms) {
+            for (const [name, { dt, card, askAi }] of terms) {
+                askAi.hidden = name !== term;
                 dt.classList.toggle("current", name === term);
                 card.classList.toggle("current", name === term);
                 if (name === term) {

app/src/ui/navigation.ts

@@ -26,8 +26,9 @@ export interface Navigation {
     replace(hash: string): void;
     /** Quitte l'écran courant : revient à la dernière adresse de l'onglet
      * qui ne vérifie pas stay, ou, s'il n'y en a pas (lien ouvert dans un
-     * nouvel onglet), remplace l'adresse par celle de la partie. */
-    leave(stay: (route: Route) => boolean): void;
+     * nouvel onglet), remplace l'adresse par fallback (celle de la partie,
+     * par défaut). */
+    leave(stay: (route: Route) => boolean, fallback?: string): void;
 }
 
 interface TrailState {
@@ -123,13 +124,13 @@ export function startNavigation(onChange: (route: Route) => void): Navigation {
         },
         go,
         replace,
-        leave(stay) {
+        leave(stay, fallback = "#/") {
             if (leaving !== null) {
                 return; // déjà en route
             }
             const steps = stepsBack(trail, stay);
             if (steps === null) {
-                replace("#/");
+                replace(fallback);
                 return;
             }
             // Au cas où le navigateur ne reviendrait pas (historique

app/src/ui/prompt-source.ts

@@ -0,0 +1,132 @@
+// Les prompts pour une IA tels que les demande l'interface (étape 1f) :
+// les gabarits, lus dans la copie de docs/prompts/ faite par make site
+// (ADR 0008), les phrases du maître, et les positions que le domaine lit
+// avec le moteur (PromptsAccess, branché par main.ts). Le remplissage
+// lui-même est dans le domaine (domain/prompts/prompts.ts).
+//
+// Copyright (C) 2026 les auteurs d'Ustagammon.
+// Licence : GPLv3 ou ultérieure (voir LICENSE).
+
+import type { MasterPhrases } from "../domain/analysis/phrases.js";
+import type { Advice } from "../domain/game/advice.js";
+import type { GameJournal } from "../domain/game/events.js";
+import type { PromptPosition } from "../domain/prompts/position.js";
+import {
+    type ConceptExample,
+    conceptPrompt,
+    decisionPrompt,
+    summaryPrompt,
+} from "../domain/prompts/prompts.js";
+import {
+    PROMPT_FILES,
+    PROMPT_KINDS,
+    type PromptTemplates,
+    parsePromptTemplate,
+} from "../domain/prompts/templates.js";
+import type { PromptResult } from "./ask-ai.js";
+import { ASK_AI_TEXTS } from "./ask-ai-texts.js";
+import type { GlossaryEntry } from "./help-text.js";
+
+/** La copie des gabarits dans le site (make site). */
+const PROMPTS_DIR = "docs/prompts/";
+
+/** Ce que les prompts demandent au domaine et au moteur : la position à
+ * décrire. */
+export interface PromptsAccess {
+    /** La position d'avant une décision de la partie. */
+    readonly before: (journal: GameJournal, eventId: string) => Promise<PromptPosition>;
+    /** La position que montre le prompt du bilan (coup à revoir, ou
+     * position finale). */
+    readonly summary: (journal: GameJournal) => Promise<PromptPosition>;
+    /** La position d'exemple d'un concept et son évaluation. */
+    readonly concept: (journal: GameJournal | null) => Promise<ConceptExample>;
+}
+
+export interface PromptSourceOptions {
+    readonly access: PromptsAccess;
+    readonly phrases: () => Promise<MasterPhrases>;
+    /** Une fiche du glossaire, par son nom de fichier. */
+    readonly glossaryEntry: (file: string) => Promise<GlossaryEntry | null>;
+}
+
+export interface PromptSource {
+    /** Le prompt d'une décision du joueur (coup ou videau). */
+    decision(journal: GameJournal, advice: Advice): Promise<PromptResult>;
+    /** Le prompt du bilan d'une partie finie et analysée. */
+    summary(journal: GameJournal): Promise<PromptResult>;
+    /** Le prompt d'un terme du glossaire (nom de sa fiche, sans .md). */
+    concept(term: string, journal: GameJournal | null): Promise<PromptResult>;
+}
+
+async function fetchText(url: string): Promise<string> {
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`${url} : ${response.status}`);
+    }
+    return response.text();
+}
+
+export function createPromptSource(options: PromptSourceOptions): PromptSource {
+    let loading: Promise<PromptTemplates> | null = null;
+
+    /** Les gabarits, lus une fois (une nouvelle tentative après un
+     * échec). */
+    function templates(): Promise<PromptTemplates> {
+        loading ??= Promise.all(
+            PROMPT_KINDS.map(async (kind) =>
+                parsePromptTemplate(await fetchText(PROMPTS_DIR + PROMPT_FILES[kind])),
+            ),
+        ).then(
+            ([move, cube, summary, concept, exercises]) => ({
+                move: move ?? "",
+                cube: cube ?? "",
+                summary: summary ?? "",
+                concept: concept ?? "",
+                exercises: exercises ?? "",
+            }),
+            (error: unknown) => {
+                loading = null;
+                throw error;
+            },
+        );
+        return loading;
+    }
+
+    return {
+        async decision(journal, advice) {
+            const [all, phrases, position] = await Promise.all([
+                templates(),
+                options.phrases(),
+                options.access.before(journal, advice.eventId),
+            ]);
+            return { text: decisionPrompt(all, phrases, { journal, advice, position }) };
+        },
+        async summary(journal) {
+            const [all, phrases, position] = await Promise.all([
+                templates(),
+                options.phrases(),
+                options.access.summary(journal),
+            ]);
+            return { text: summaryPrompt(all, phrases, { journal, position }) };
+        },
+        async concept(term, journal) {
+            const [all, entry, example] = await Promise.all([
+                templates(),
+                options.glossaryEntry(`${term}.md`).catch(() => null),
+                options.access.concept(journal),
+            ]);
+            if (entry === null) {
+                return { message: ASK_AI_TEXTS.missingTerm };
+            }
+            return {
+                text: conceptPrompt(all, {
+                    term: entry.term,
+                    english: entry.english,
+                    brief: entry.brief,
+                    journal,
+                    example,
+                }),
+            };
+        },
+    };
+}

app/src/ui/review-texts.ts

@@ -10,16 +10,12 @@ import type { Roll } from "../domain/game/roll.js";
 
 const plural = (n: number, one: string, many: string) => (n > 1 ? many : one);
 
-/** « 41 % ». */
-export function percent(chance: number): string {
-    return `${Math.round(chance * 100)} %`;
-}
-
-/** Un nombre à la française, signé, à trois décimales : « +0,021 ». */
-export function signed(value: number): string {
-    const text = Math.abs(value).toFixed(3).replace(".", ",");
-    return value < -0.0005 ? `−${text}` : value > 0.0005 ? `+${text}` : text;
-}
+/** « 41 % » et « +0,021 » : la même écriture que les prompts
+ * (domain/analysis/numbers.ts). */
+export {
+    formatEquity as signed,
+    formatPercent as percent,
+} from "../domain/analysis/numbers.js";
 
 export const REVIEW_TEXTS = {
     // Bilan

app/src/ui/router.ts

@@ -14,8 +14,9 @@ export type Route =
     | { readonly screen: "home" }
     /** #/aide, et une question ouverte : #/aide/<identifiant>. */
     | { readonly screen: "help"; readonly question: string | null }
-    /** #/glossaire, et un terme : #/glossaire/<fiche sans .md>. */
-    | { readonly screen: "glossary"; readonly term: string | null }
+    /** #/glossaire, et un terme : #/glossaire/<fiche sans .md> ; son
+     * prompt pour une IA : #/glossaire/<fiche>/ia. */
+    | { readonly screen: "glossary"; readonly term: string | null; readonly ai?: boolean }
     /** #/a-propos. */
     | { readonly screen: "about" }
     /** #/tutoriel, une étape : #/tutoriel/<n>, et son écran « à vous » :
@@ -27,19 +28,27 @@ export type Route =
     | { readonly screen: "install" }
     /** #/parties, et une partie : #/parties/<identifiant>. */
     | { readonly screen: "games"; readonly game: string | null }
-    /** #/parties/<identifiant>/bilan : le bilan de fin de partie (1e). */
-    | { readonly screen: "summary"; readonly game: string }
+    /** #/parties/<identifiant>/bilan : le bilan de fin de partie (1e) ;
+     * son prompt pour une IA : #/parties/<identifiant>/bilan/ia (1f). */
+    | { readonly screen: "summary"; readonly game: string; readonly ai?: boolean }
     /** #/parties/<identifiant>/analyse/<coup> : l'écran d'analyse, placé
      * sur un coup (un tour de la partie, à partir de 1) ; sans coup :
-     * #/parties/<identifiant>/analyse. */
-    | { readonly screen: "analysis"; readonly game: string; readonly turn: number | null }
+     * #/parties/<identifiant>/analyse ; le prompt du coup pour une IA :
+     * #/parties/<identifiant>/analyse/<coup>/ia (1f). */
+    | {
+          readonly screen: "analysis";
+          readonly game: string;
+          readonly turn: number | null;
+          readonly ai?: boolean;
+      }
     /** #/menu. */
     | { readonly screen: "menu" }
     /** #/nouvelle-partie : le choix de la partie (type, niveau, conseil). */
     | { readonly screen: "newGame" }
     /** #/explication/<événement> : la feuille d'explication du maître sur
-     * une décision de la partie en cours (étape 1d). */
-    | { readonly screen: "explanation"; readonly event: string }
+     * une décision de la partie en cours (étape 1d) ; son prompt pour une
+     * IA : #/explication/<événement>/ia (1f). */
+    | { readonly screen: "explanation"; readonly event: string; readonly ai?: boolean }
     /** #/position/<Position ID>/<Match ID> (Match ID facultatif). */
     | { readonly screen: "position"; readonly position: string; readonly match: string | null }
     /** Une adresse que l'application ne connaît pas. */
@@ -71,6 +80,11 @@ export function parseRoute(hash: string): Route {
     if (rest.at(-1) === "") {
         rest.pop();
     }
+    // La feuille du prompt pour une IA (étape 1f) : « /ia » au bout de
+    // l'adresse de l'écran d'où on la demande.
+    if (rest.length > 1 && rest.at(-1) === "ia") {
+        return aiRoute(parseRoute(`#/${[head, ...rest.slice(0, -1)].join("/")}`)) ?? unknown;
+    }
     if (head === "position") {
         return positionRoute(rest.join("/")) ?? unknown;
     }
@@ -113,6 +127,37 @@ export function parseRoute(hash: string): Route {
     }
 }
 
+/** Les écrans qui ont une feuille de prompt pour une IA. */
+export type AiRoute = Extract<
+    Route,
+    { screen: "explanation" | "summary" | "analysis" | "glossary" }
+>;
+
+/** L'écran, avec sa feuille de prompt ouverte (null : écran sans prompt). */
+function aiRoute(route: Route): AiRoute | null {
+    switch (route.screen) {
+        case "explanation":
+        case "summary":
+        case "analysis":
+            return route.ai === true ? null : { ...route, ai: true };
+        case "glossary":
+            return route.term === null || route.ai === true ? null : { ...route, ai: true };
+        default:
+            return null;
+    }
+}
+
+/** La feuille du prompt pour une IA est-elle ouverte ? */
+export function isAiRoute(route: Route): route is AiRoute {
+    return "ai" in route && route.ai === true;
+}
+
+/** L'écran sous la feuille du prompt. */
+export function withoutAi(route: AiRoute): AiRoute {
+    const { ai: _, ...below } = route;
+    return below;
+}
+
 /** #/parties/<id>/bilan, #/parties/<id>/analyse, #/parties/<id>/analyse/<n>. */
 function gameReviewRoute(rest: readonly string[]): Route | null {
     const [game = "", part, turn, ...more] = rest;
@@ -179,6 +224,11 @@ function positionRoute(text: string): Route | null {
 
 /** Le fragment d'un écran, # compris. */
 export function routeHash(route: Route): string {
+    const hash = screenHash(route);
+    return isAiRoute(route) ? `${hash}/ia` : hash;
+}
+
+function screenHash(route: Route): string {
     switch (route.screen) {
         case "game":
             return "#/";

app/src/ui/summary-view.ts

@@ -28,6 +28,7 @@ import type { GameJournal } from "../domain/game/events.js";
 import type { Game } from "../domain/game/game.js";
 import { COMPUTER_LEVELS } from "../domain/game/level.js";
 import { VERDICT_ICONS } from "./advice-view.js";
+import { askAiLink, clearSheet } from "./ask-ai.js";
 import { icon } from "./icons.js";
 import { MATCH_TEXTS } from "./match-texts.js";
 import { boardSvg, drawSteps } from "./move-board.js";
@@ -64,6 +65,8 @@ export interface SummaryView {
     show(data: SummaryData | null): void;
     hide(): void;
     readonly isOpen: boolean;
+    /** Le panneau, où la page du prompt prend la place du bilan (1f). */
+    readonly panel: HTMLElement;
 }
 
 function element<K extends keyof HTMLElementTagNameMap>(
@@ -141,7 +144,7 @@ export function createSummaryView(options: SummaryViewOptions): SummaryView {
             return;
         }
         drawn = key;
-        panel.replaceChildren();
+        clearSheet(panel);
         delete panel.dataset.ready;
         const head = element(panel, "div", { className: "summary-head" });
         element(head, "p", { className: "overline", text: TEXTS.endOverline });
@@ -299,9 +302,14 @@ export function createSummaryView(options: SummaryViewOptions): SummaryView {
             text: REVIEW_TEXTS.reviewMove,
         });
         revisit.href = routeHash({ screen: "analysis", game: data.id, turn: reviewed.turn });
-        // L'emplacement de « Demander à une IA » (étape 1f).
+        // « Demander à une IA » (étape 1f) : le prompt du bilan.
         const slot = element(links, "div", { className: "ask-ai-slot" });
         slot.dataset.slot = "ask-ai";
+        askAiLink(
+            slot,
+            "summary-ask-ai",
+            routeHash({ screen: "summary", game: data.id, ai: true }),
+        );
     }
 
     function actions(data: SummaryData): void {
@@ -350,7 +358,7 @@ export function createSummaryView(options: SummaryViewOptions): SummaryView {
         hide() {
             if (!veil.hidden) {
                 veil.hidden = true;
-                panel.replaceChildren();
+                clearSheet(panel);
                 delete panel.dataset.ready;
                 drawn = "";
             }
@@ -358,5 +366,6 @@ export function createSummaryView(options: SummaryViewOptions): SummaryView {
         get isOpen() {
             return !veil.hidden;
         },
+        panel,
     };
 }