chesspal 0.3.4 → 0.3.6

package/README.md

@@ -87,6 +87,7 @@ Chesspal works with any agent that can use Chesspal's tools (MCP) and the files
 - **To play in a folder of your own**, as with the Claude desktop app, type `chesspal init chess`, then open your agent in the folder `chess` and say hello: the AI answers with the link to the board page. Any name will do; your games are kept [elsewhere](#where-your-games-are).
 - **A move written in the chat** counts too: `e4`, `Nf3`, in the international notation (K Q R B N in every language), or in words.
 - **To update**, when a new version is out the table's page shows an arrow at the top: press it between games, and the table installs it and starts again, with its chat. By hand: close the AI's terminal, run `npm install -g chesspal` again, then `chesspal`. In a folder of your own, run `chesspal init` there too: it updates its own lines and keeps what you wrote there. In Codex, allow the hooks again when it says so.
+- **To uninstall**, run `chesspal icon --remove` first, which takes the icon off your desktop and menu, then `npm uninstall -g chesspal`. Your games stay [where they are](#where-your-games-are).
 
 ## Where your games are
 

package/dist/cli/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { runCommandLine } from "./command-line.js";
 const args = process.argv.slice(2);
-// The table's own words (D-104): alone or open, its page; table, icon, play <host>. The host's: mcp, its server; listen, its doorbell; chat, how the chat
+// The table's own words (D-104): alone or open, its page; table, icon (--remove), play <host>. The host's: mcp, its server; listen, its doorbell; chat, how the chat
 // started. Everything else is a command.
 if (args.length === 0) {
     await openTableHere(true);
@@ -16,7 +16,15 @@ else if (args.length === 1 && args[0] === "table") {
 else if (args.length === 1 && args[0] === "icon") {
     await putIconHere();
 }
-else if (args.length === 2 && args[0] === "play" && !args[1].startsWith("-")) {
+else if (args.length === 2 && args[0] === "icon" && args[1] === "--remove") {
+    const [{ defaultContext }, { iconsRemoved }] = await Promise.all([import("../commands/index.js"), import("./icon.js")]);
+    console.log(iconsRemoved(defaultContext()));
+}
+else if (args[0] === "play" && (args.length === 2 || (args.length === 4 && args[2] === "--home")) && !args[1].startsWith("-")) {
+    // The data folder of a table started with CHESSPAL_HOME, which a terminal the table opens may not pass on (Terminal.app): the chat and its server read it.
+    if (args[3] !== undefined) {
+        process.env.CHESSPAL_HOME = args[3];
+    }
     await playHere(args[1]);
 }
 else if (args.length === 1 && args[0] === "mcp") {

package/dist/cli/command-line.js

@@ -10,8 +10,11 @@ const listenDescription = "Wait for the player's move on the board page and wake
 const chatDescription = "Note how the chat started: new, cleared, resumed or compacted. Claude Code and Codex run it when a chat starts, as init sets them up.";
 const tableDescription = "Serve the board page with no chat, until no browser has had it open for five minutes. `chesspal` alone starts it apart and opens the page.";
 const openDescription = "Open the board page as `chesspal` alone does, without asking about the icon: what the icon runs.";
-const iconDescription = "Put Chesspal's icon on the desktop and in the menu: it opens the board page as `chesspal` alone does, with no terminal.";
-const playDescription = "Play at the table in Claude Code or Codex, in this terminal: what the page's buttons open, with the model and effort chosen there; New game on the page starts the chat again, clean.";
+const iconDescription = "Put Chesspal's icon on the desktop and in the menu: it opens the board page as `chesspal` alone does, with no terminal. `chesspal icon --remove` takes it away.";
+const playDescription = "Start the AI in this terminal, in Claude Code or Codex, as the page's buttons do. It plays with the model and effort chosen on the page; New game there starts the chat again, clean.";
+// What init and the icon's removal are to a player, in the general help: the command's own help says the files.
+const initForPlayer = "Set up a folder of your own to play in, from Claude Code, Codex or the Claude desktop app.";
+const iconRemoveForPlayer = "Take Chesspal's icon away, before you uninstall it.";
 // Those of them that take no options, by name.
 const plainCommands = new Map([["mcp", mcpDescription], ["chat", chatDescription], ["table", tableDescription], ["open", openDescription], ["icon", iconDescription]]);
 /** The `chesspal` command line: finds the command, validates its input, runs it and renders the result. */
@@ -149,21 +152,26 @@ function checkRepeatedOptions(command, tokens, options) {
 function inputFields(command) {
     return Object.entries(command.input.shape);
 }
-/** The commands, each with the first sentence of its description. */
+/** The commands, each with the first sentence of its description: the player's first, then those of the AI and of whoever develops Chesspal. */
 function generalHelp(list) {
-    const width = Math.max("listen".length, ...list.map((command) => command.name.length));
+    const width = Math.max("icon --remove".length, ...list.map((command) => command.name.length));
     const line = (name, description) => `  ${name.padEnd(width)} ${firstSentence(description)}`;
+    const init = list.find((command) => command.name === "init");
     return [
         `chesspal ${version}`,
         "",
-        "Run `chesspal` alone to open the board page in your browser.",
+        "To play, type `chesspal` alone: the board opens in your browser, and from there you start the AI.",
         "",
-        "Commands:",
-        ...list.map((command) => line(command.name, command.description)),
+        "For the player:",
+        line("play", playDescription),
+        ...(init === undefined ? [] : [line(init.name, initForPlayer)]),
+        line("icon", iconDescription),
+        line("icon --remove", iconRemoveForPlayer),
+        "",
+        "For the AI, and for whoever develops Chesspal:",
+        ...list.filter((command) => command !== init).map((command) => line(command.name, command.description)),
         line("table", tableDescription),
         line("open", openDescription),
-        line("icon", iconDescription),
-        line("play", playDescription),
         line("mcp", mcpDescription),
         line("listen", listenDescription),
         line("chat", chatDescription),

package/dist/cli/icon.d.ts

@@ -23,3 +23,5 @@ export declare function iconsMade(context: Context, places?: IconPlaces): Promis
     said: string;
     failed: boolean;
 }>;
+/** Takes the icon off the desktop and the menu, before Chesspal is uninstalled: what to tell the player. */
+export declare function iconsRemoved(context: Context): string;

package/dist/cli/icon.js

@@ -3,7 +3,7 @@
 import { createInterface } from "node:readline/promises";
 import { styleText } from "node:util";
 import { speaksItalian } from "../commands/index.js";
-import { iconAsked, iconCommand, iconToRemake, makeIcons, noteIconAsked, noteIconMade } from "../server/table/index.js";
+import { iconAsked, iconCommand, iconToRemake, makeIcons, noteIconAsked, noteIconMade, removeIcons } from "../server/table/index.js";
 /**
  * Asks once a machine, in a terminal on a screen, whether to put the icon on the desktop and in the menu, and puts it there on a yes: what to tell the
  * player, if anything. Once asked, an icon made by another Node or script is made again, without a word; a playtest's data folder is never asked about.
@@ -46,6 +46,12 @@ export async function iconsMade(context, places) {
         return { said: words.failed(error.message), failed: true };
     }
 }
+/** Takes the icon off the desktop and the menu, before Chesspal is uninstalled: what to tell the player. */
+export function iconsRemoved(context) {
+    const words = wordsFor(context);
+    const removed = removeIcons(context.home());
+    return removed.length === 0 ? words.noneRemoved : `${words.removed}\n${styleText("dim", removed.map((file) => `  ${file}`).join("\n"))}`;
+}
 function processTerminal() {
     return { input: process.stdin, output: process.stdout, env: process.env };
 }
@@ -68,6 +74,8 @@ function wordsFor(context) {
             made: `Fatto: Chesspal è sul desktop e ${where}.`,
             later: "Va bene, niente icona. Se la vuoi più avanti, scrivi chesspal icon.",
             failed: (reason) => `Chesspal non è riuscito a mettere l'icona (${reason}). Riprova con chesspal icon.`,
+            removed: `Fatto: l'icona di Chesspal non è più sul desktop né ${where}. Per togliere Chesspal: npm uninstall -g chesspal. Le tue partite restano dove sono.`,
+            noneRemoved: "Chesspal non ha trovato sue icone su questo computer.",
         };
     }
     const where = { windows: "your Start menu", mac: "Applications", linux: "your applications menu" }[system];
@@ -76,5 +84,7 @@ function wordsFor(context) {
         made: `Done: Chesspal is on your desktop and in ${where}.`,
         later: "All right, no icon. To add it later, type chesspal icon.",
         failed: (reason) => `Chesspal could not add its icon (${reason}). Try again with chesspal icon.`,
+        removed: `Done: Chesspal's icon is gone from your desktop and ${where}. To remove Chesspal: npm uninstall -g chesspal. Your games stay where they are.`,
+        noneRemoved: "Chesspal found no icon of its own on this computer.",
     };
 }

package/dist/commands/analysis/analyse.d.ts

@@ -2,14 +2,14 @@ import { z } from "zod";
 import { type AiLevel, type MoveReview, type PieceLetter, type Side } from "../../core/index.ts";
 /** A move as the analysis gives it: what happened, never how good it was (D-6). */
 interface MoveFacts {
-    /** The move, numbered: 12...Nxe5. */
+    /** The move, numbered, with the pieces' figurines as the other tools write moves (D-86), since the analyst copies them into its notes: 12...♞xe5. */
     move: string;
     /** The piece it took. */
     took?: PieceLetter;
     /** The time it took and the time left after it, in milliseconds, where the record has the clock. */
     spent?: number;
     left?: number;
-    /** Who is ahead in material after it, when it changed: White +1. */
+    /** Who is ahead in material after it, when it changed: White +1 in pawns. */
     material?: string;
     /** After it, the pieces at risk of either side when they changed from the line before ("none" once no piece is), and the mates the side to move has; none once the board ends the game. */
     atRisk?: string;

package/dist/commands/analysis/analyse.js

@@ -5,7 +5,7 @@ import { gameInAnalysis, isGameName, keepToStudy, lastChatStart, planOf, rewrite
 import { analystAgent, instructionsFile } from "../../host-files/index.js";
 import { activeProfile, gameFolder } from "../../profiles/index.js";
 import { pointsAtSite, siteGameName, siteOfGameName } from "../../sites/index.js";
-import { analystOf, anotherAnalyst, balanceText, bookOpening, bookReaches, colourName, gameToStudy, knownTag, moveNumbers, namedGame, noGameGoingOn, riskLine, speechLine, speechOf, tacticsText } from "../answers/index.js";
+import { analystOf, anotherAnalyst, balanceText, bookOpening, bookReaches, colourName, gameToStudy, knownTag, moveNumbers, namedGame, noGameGoingOn, riskLine, shownMove, speechLine, speechOf, tacticsText, } from "../answers/index.js";
 import { playerLine, siteText } from "../profiles/index.js";
 import { defineCommand } from "../registry/index.js";
 import { profileSiteGames } from "./site-games.js";
@@ -221,7 +221,7 @@ function movesOf(record, ai) {
         const previous = left[side];
         const risks = riskLine(facts);
         const move = {
-            move: `${numbers[ply]}${san}`,
+            move: shownMove(`${numbers[ply]}${san}`),
             took: before.pieces.find((piece) => piece.square === played.move.to)?.piece ?? (san.includes("x") ? "P" : undefined),
             spent: clock === undefined || previous === undefined || increment === undefined ? undefined : Math.max(0, previous - clock + increment),
             left: clock,
@@ -266,7 +266,7 @@ function analysisHead(analysis) {
     const review = analysis.review === undefined ? [] : [`Your review: ${analysis.review}`];
     return [head, ...opening, ...review, `${name}.`, ...start];
 }
-/** 12...Nxe5: took P; spent 0:12, 4:32 left; material White +1; at risk: undefended Black Nf6; mate in one: Qh7#; tactics: fork Nc7+ (Ke8 Ra8); out of book; you said "…"; your plan: …; ahead -1.5 */
+/** 12...♞xe5: took P; spent 0:12, 4:32 left; material White +1 in pawns; at risk: undefended Black Nf6; mate in one: Qh7#; tactics: fork Nc7+ (Ke8 Ra8); out of book; you said "…"; your plan: …; ahead -1.5 */
 function moveLine(move) {
     const left = move.left === undefined ? undefined : `${clockText(move.left)} left`;
     const parts = [

package/dist/commands/answers/agents.d.ts

@@ -8,8 +8,16 @@ export declare function analystRuns(context: Context): boolean;
  * its end: once reviewed, or taken by the agent, the chat goes over that review and doesn't start the agent for it (Stefano).
  */
 export declare function withAnalyst(summary: GameSummary, context: Context, over?: CurrentGame): GameSummary;
-/** How the chat has a game over gone over by the analyst agent, on the player's yes or for the game they brought (D-89). */
-export declare function analystLine(game?: string): string;
+/**
+ * How the chat has a game over gone over by the analyst agent, on the player's yes or for the game they brought (D-89); in Codex with spawn_agent by name,
+ * since a chat there called analyse_game itself instead (Priya).
+ */
+export declare function analystLine(game?: string, codex?: boolean): string;
+/**
+ * The analyst's line for the chat that looks at the game in analysis with no review and no analyst at it, as after «Delete the analysis», which rings no
+ * doorbell (Priya): once a change of the analysis, where the server keeps what it told.
+ */
+export declare function analystOnView(context: Context, game: string | undefined): string | undefined;
 /** How the chat goes over a game the analyst agent has reviewed, or is reviewing: from that review, never with another agent (Stefano). */
 export declare function reviewedLine(game?: string): string;
 /** Whether a coach judges the player's moves when the helps are on: in Claude Code or Codex, with its agent in the player's folder (D-80, D-88, D-98). */

package/dist/commands/answers/agents.js

@@ -1,7 +1,7 @@
 // The agents that work beside the chat in Claude Code and Codex (D-98): the analyst that goes over a game over (D-89) and the coach that judges the player's moves (D-88).
 import { isReviewed } from "../../core/index.js";
 import { archivedName, coachStarted, gameInAnalysis, lastChatStart } from "../../games/index.js";
-import { agentHosts, analystAgent, coachAgent, hasAgent } from "../../host-files/index.js";
+import { agentHosts, analystAgent, coachAgent, hasAgent, isCodex } from "../../host-files/index.js";
 import { gameFolder, helpsIn } from "../../profiles/index.js";
 import { namedGame } from "./study.js";
 import { unplayed } from "./summary.js";
@@ -20,13 +20,36 @@ export function withAnalyst(summary, context, over) {
         return summary;
     }
     const archived = over === undefined ? undefined : archivedName(gameFolder(context.home()), over);
-    return { ...summary, end: { ...end, analyst: archived !== undefined && goneOver(context, archived) ? "done" : "offer" } };
+    const analyst = archived !== undefined && goneOver(context, archived) ? "done" : "offer";
+    return { ...summary, end: { ...end, analyst, ...(isCodex(context.host?.()) ? { codex: true } : {}) } };
 }
-/** How the chat has a game over gone over by the analyst agent, on the player's yes or for the game they brought (D-89). */
-export function analystLine(game) {
-    return `start the chesspal-analyst agent in the background with the prompt "Analyse${game === undefined ? "" : ` ${game}`}. The player speaks <their language>.": it writes its review on the board `
-        + "page, which shows it at work; tell the player in a word, talk the game over with them meanwhile whenever they ask, and when it ends go over it with them "
-        + "from what it tells you.";
+/**
+ * How the chat has a game over gone over by the analyst agent, on the player's yes or for the game they brought (D-89); in Codex with spawn_agent by name,
+ * since a chat there called analyse_game itself instead (Priya).
+ */
+export function analystLine(game, codex = false) {
+    const prompt = `Analyse${game === undefined ? "" : ` ${game}`}. The player speaks <their language>.`;
+    const start = codex
+        ? `start the ${analystAgent} agent with spawn_agent {"agent_type": "${analystAgent}", "message": "${prompt}", "fork_turns": "none"}`
+        : `start the ${analystAgent} agent in the background with the prompt "${prompt}"`;
+    return `${start}: it writes its review on the board page, which shows it at work; tell the player in a word, talk the game over with them meanwhile whenever `
+        + "they ask, and when it ends go over it with them from what it tells you.";
+}
+/**
+ * The analyst's line for the chat that looks at the game in analysis with no review and no analyst at it, as after «Delete the analysis», which rings no
+ * doorbell (Priya): once a change of the analysis, where the server keeps what it told.
+ */
+export function analystOnView(context, game) {
+    if (game === undefined || context.agent !== undefined || !analystRuns(context)) {
+        return undefined;
+    }
+    const analysis = gameInAnalysis(gameFolder(context.home()));
+    const key = `analyst on view ${game} ${analysis?.at ?? ""}`;
+    if (analysis?.game !== game || context.told?.has(key) === true || goneOver(context, game)) {
+        return undefined;
+    }
+    context.told?.add(key);
+    return `${game} has no review. When the player wants it gone over, ${analystLine(game, isCodex(context.host?.()))}`;
 }
 /** How the chat goes over a game the analyst agent has reviewed, or is reviewing: from that review, never with another agent (Stefano). */
 export function reviewedLine(game) {

package/dist/commands/answers/index.d.ts

@@ -1,4 +1,4 @@
-export { agentRuns, agentsLine, analystLine, analystOf, analystRuns, anotherAnalyst, coachOnEnd, coachOnEndLine, coachRuns, goneOver, reviewedLine, withAnalyst } from "./agents.ts";
+export { agentRuns, agentsLine, analystLine, analystOf, analystOnView, analystRuns, anotherAnalyst, coachOnEnd, coachOnEndLine, coachRuns, goneOver, reviewedLine, withAnalyst } from "./agents.ts";
 export { clockLine, clockSummaryOf, gameAt } from "./clock.ts";
 export { arrowsInput, drawingsOf, noteInput, squaresInput } from "./drawings.ts";
 export { aheadWords, leadFrom, leadInput } from "./lead-input.ts";

package/dist/commands/answers/index.js

@@ -1,6 +1,6 @@
 // What the commands share to answer the AI: the lines it reads, the game's summary and view, the clock, the talk, the moves played, the games to study.
 // Above the registry only, below every other command folder.
-export { agentRuns, agentsLine, analystLine, analystOf, analystRuns, anotherAnalyst, coachOnEnd, coachOnEndLine, coachRuns, goneOver, reviewedLine, withAnalyst } from "./agents.js";
+export { agentRuns, agentsLine, analystLine, analystOf, analystOnView, analystRuns, anotherAnalyst, coachOnEnd, coachOnEndLine, coachRuns, goneOver, reviewedLine, withAnalyst } from "./agents.js";
 export { clockLine, clockSummaryOf, gameAt } from "./clock.js";
 export { arrowsInput, drawingsOf, noteInput, squaresInput } from "./drawings.js";
 export { aheadWords, leadFrom, leadInput } from "./lead-input.js";

package/dist/commands/answers/lines.js

@@ -104,7 +104,7 @@ export function nextStep(game, words = [], pageClosed = false) {
     }
     if (game.end !== undefined) {
         const analysis = game.end.analyst === "offer"
-            ? ` To go over it, on their yes, ${analystLine(game.end.archive)}`
+            ? ` To go over it, on their yes, ${analystLine(game.end.archive, game.end.codex === true)}`
             : game.end.analyst === "done"
                 ? ` ${reviewedLine(game.end.archive)}`
                 : "";
@@ -163,7 +163,8 @@ function clockLines(game) {
 }
 function whereLine(game) {
     if (game.end !== undefined) {
-        const archived = game.end.archive === undefined ? "" : ` Archived in ${game.end.archive}.`;
+        // Saved where the player's games are: the AI says so, never the file, which past_games names when it is needed.
+        const archived = game.end.archive === undefined ? "" : " Saved with the player's games.";
         return `Game over: ${endText(game.end)}.${archived}`;
     }
     return `${game.turn === game.ai ? "You" : "Player"} (${colourName(game.turn)}) to move, move ${game.moveNumber}.`;

package/dist/commands/answers/summary.d.ts

@@ -38,13 +38,14 @@ export interface GameSummary {
     mood?: MoodNow;
     /**
      * When the game is over: how it ended, its name in the archive once it is there, and, where an analyst agent runs (D-89), whether the chat offers it or
-     * goes over the review it did.
+     * goes over the review it did, and whether the host is Codex, which starts it with spawn_agent.
      */
     end?: {
         result: string;
         termination?: string;
         archive?: string;
         analyst?: "offer" | "done";
+        codex?: true;
     };
 }
 /** A move numbered as in the game (4.Ng5, 4...d5), with the squares it went from and to. */

package/dist/commands/answers/view.d.ts

@@ -22,5 +22,5 @@ export declare function riskLine(facts: Facts): string | undefined;
 export declare function colourName(side: Side): string;
 /** The material as the player sees it beside the board (D-59): who is ahead and by how much, and the pieces each side took. */
 export declare function materialText(material: Material): string;
-/** Who is ahead in material, and by how many pawns: White +2, or even. */
+/** Who is ahead in material, and by how many pawns, with the unit, so that no AI reads it as pieces: White +2 in pawns, or even. */
 export declare function balanceText(balance: number): string;

package/dist/commands/answers/view.js

@@ -51,9 +51,9 @@ export function materialText(material) {
     }
     return `${ahead} (White took ${takenText(material.taken.white)}, Black took ${takenText(material.taken.black)})`;
 }
-/** Who is ahead in material, and by how many pawns: White +2, or even. */
+/** Who is ahead in material, and by how many pawns, with the unit, so that no AI reads it as pieces: White +2 in pawns, or even. */
 export function balanceText(balance) {
-    return balance === 0 ? "even" : `${balance > 0 ? "White" : "Black"} +${Math.abs(balance)}`;
+    return balance === 0 ? "even" : `${balance > 0 ? "White" : "Black"} +${Math.abs(balance)} in pawns`;
 }
 /** The pieces taken, counted by kind: Q 2R 7P. */
 function takenText(taken) {

package/dist/commands/game/look.d.ts

@@ -24,11 +24,15 @@ export declare const look: import("../registry/registry.ts").Command<z.ZodObject
     }>>;
 }, z.core.$strip>, {
     board: string;
-} | {
+} | ({
     game: Viewed;
     words: Written[];
-} | {
+} & {
+    analyst?: string;
+}) | ({
     study: StudyView;
     words: Written[];
-}>;
+} & {
+    analyst?: string;
+})>;
 export {};

package/dist/commands/game/look.js

@@ -1,8 +1,9 @@
 import { z } from "zod";
 import { boardText, materialOf, sees } from "../../core/index.js";
+import { archivedName, endOf } from "../../games/index.js";
 import { analystAgent } from "../../host-files/index.js";
 import { gameFolder } from "../../profiles/index.js";
-import { fullView, gameAt, gameShown, headLines, materialText, newWords, positionAfter, positionLine, studyInput, summaryOf, wordLines } from "../answers/index.js";
+import { analystOnView, fullView, gameAt, gameShown, headLines, materialText, newWords, positionAfter, positionLine, studyInput, summaryOf, wordLines } from "../answers/index.js";
 import { defineCommand } from "../registry/index.js";
 import { refuseUnseen } from "./levels.js";
 /** The whole view (D-26), when the compact one after the player's move is not enough; or the board for the player, where the host does not show it (D-36). */
@@ -34,13 +35,14 @@ export const look = defineCommand({
         }
         const { threats } = current.game;
         const viewed = { ...summaryOf(current, context.now()), facts: current.game.facts, possibilities: current.game.possibilities };
-        return { game: threats === undefined ? viewed : { ...viewed, threats }, words: newWords(context) };
+        const over = endOf(current.game) === undefined ? undefined : archivedName(gameFolder(context.home()), current);
+        return withAnalystLine({ game: threats === undefined ? viewed : { ...viewed, threats }, words: newWords(context) }, analystOnView(context, over));
     },
     format: (look) => {
         if ("board" in look) {
             return look.board;
         }
-        return [...("game" in look ? gameLines(look.game) : studyLines(look.study)), ...wordLines(look.words)].join("\n");
+        return [...("game" in look ? gameLines(look.game) : studyLines(look.study)), ...wordLines(look.words), ...(look.analyst === undefined ? [] : [look.analyst])].join("\n");
     },
 });
 /** A position of a game over, as the view of the game going on gives it. */
@@ -52,7 +54,10 @@ function studyLook(context, only, name, move) {
         return { board: boardText(position.fen) };
     }
     const view = { where: positionLine(at, studied.name), turn: position.turn, fen: position.fen, facts: at.game.facts, possibilities: at.game.possibilities, threats: at.game.threats };
-    return { study: view, words: newWords(context) };
+    return withAnalystLine({ study: view, words: newWords(context) }, analystOnView(context, studied.name));
+}
+function withAnalystLine(look, analyst) {
+    return analyst === undefined ? look : { ...look, analyst };
 }
 /** The game going on: its head and the whole view, with the other side's chances from the strong level (D-100). */
 function gameLines(game) {

package/dist/commands/game/new.js

@@ -97,7 +97,7 @@ function startedLines({ game, archived, past, player, speech, closedPage: closed
         `New game: ${sidesLine(game.ai)}, ${levelText(game.level)}.`,
         ...(player === undefined ? [] : [player]),
         ...(speech === undefined ? [] : [speechLine(speech)]),
-        ...(archived === undefined ? [] : [`The game before is in ${archived.name}${archived.finished ? "" : ", unfinished"}.`]),
+        ...(archived === undefined ? [] : [`The game before is saved with the player's games${archived.finished ? "" : ", unfinished"}.`]),
         ...(past.length === 0 ? [] : ["Last games with this player (past_games gives more, and their moves):", ...past]),
         ...positionLines(game),
         ...(closed === undefined ? [] : [pageLine(closed, true)]),

package/dist/commands/game/ponder.js

@@ -36,7 +36,7 @@ export const ponder = defineCommand({
             if (reply !== undefined || move !== undefined || why !== undefined || say !== undefined || done) {
                 throw new Error("Give the position's number with it: call ponder {} first, which gives it. Nothing changed.");
             }
-            notePondering(folder, thoughtKey(current), true);
+            notePondering(folder, thoughtKey(current), true, context.now());
             return { start: startOf(current) };
         }
         if ((say !== undefined || done) && (reply !== undefined || move !== undefined || why !== undefined || (say !== undefined && done))) {
@@ -47,7 +47,7 @@ export const ponder = defineCommand({
             return { said: position };
         }
         if (done) {
-            notePondering(folder, thoughtKey(current), false);
+            notePondering(folder, thoughtKey(current), false, context.now());
             return await waitForMove(folder, context, current);
         }
         if (reply === undefined) {
@@ -71,7 +71,7 @@ export const ponder = defineCommand({
         if (!answer.played) {
             throw new Error(`${answer.message} Your legal moves after ${played.move.san}: ${answer.legal.join(" ")}. Nothing changed.`);
         }
-        return { kept: keepThought(folder, thoughtKey(current), { reply: played.move.san, move: answer.move.san, why }), position };
+        return { kept: keepThought(folder, thoughtKey(current), { reply: played.move.san, move: answer.move.san, why }, context.now()), position };
     },
     format: (pondered) => {
         if ("stop" in pondered) {

package/dist/commands/game/position.d.ts

@@ -1,8 +1,9 @@
 import { z } from "zod";
 import { type Profile } from "../../core/index.ts";
-/** The positional profile of a position: of a game studied, with where it stands. */
+/** The positional profile of a position: of a game studied, with where it stands; with the analyst's line for a game in analysis without its review. */
 type Described = Profile & {
     where?: string;
+    analyst?: string;
 };
 /** The positional profile of the game in progress (D-19), or of any position of a game over (D-68): separate facts, never a score. */
 export declare const position: import("../registry/registry.ts").Command<z.ZodObject<{

package/dist/commands/game/position.js

@@ -1,8 +1,9 @@
 import { z } from "zod";
 import {} from "../../core/index.js";
+import { archivedName, endOf } from "../../games/index.js";
 import { analystAgent } from "../../host-files/index.js";
 import { gameFolder } from "../../profiles/index.js";
-import { colourName, gameAt, gameShown, materialText, positionAfter, positionLine, studyInput } from "../answers/index.js";
+import { analystOnView, colourName, gameAt, gameShown, materialText, positionAfter, positionLine, studyInput } from "../answers/index.js";
 import { defineCommand } from "../registry/index.js";
 import { refuseUnseen } from "./levels.js";
 /** The positional profile of the game in progress (D-19), or of any position of a game over (D-68): separate facts, never a score. */
@@ -21,17 +22,21 @@ export const position = defineCommand({
         if (game !== undefined || move !== undefined) {
             const studied = gameShown(context, game);
             const at = positionAfter(studied.record, move);
-            return { ...at.game.profile, where: positionLine(at, studied.name) };
+            return withAnalystLine({ ...at.game.profile, where: positionLine(at, studied.name) }, analystOnView(context, studied.name));
         }
         const current = gameAt(gameFolder(context.home()), context.now());
         if (current === undefined) {
             throw new Error("There is no game to describe: start one with new_game.");
         }
         refuseUnseen(current, "strategy", "position");
-        return current.game.profile;
+        const over = endOf(current.game) === undefined ? undefined : archivedName(gameFolder(context.home()), current);
+        return withAnalystLine(current.game.profile, analystOnView(context, over));
     },
-    format: (described) => [...(described.where === undefined ? [] : [described.where]), ...profileLines(described)].join("\n"),
+    format: (described) => [...(described.where === undefined ? [] : [described.where]), ...profileLines(described), ...(described.analyst === undefined ? [] : [described.analyst])].join("\n"),
 });
+function withAnalystLine(described, analyst) {
+    return analyst === undefined ? described : { ...described, analyst };
+}
 /** The profile as lines for the AI, White's facts before Black's; a line with nothing to say is left out. */
 export function profileLines(profile) {
     const sides = [["white", profile.white], ["black", profile.black]];

package/dist/commands/game/status.d.ts

@@ -16,11 +16,13 @@ interface Status {
     problem?: string;
     /** What the player wrote on the board page that the AI has not answered yet, all of it. */
     words?: Written[];
-    /** The game in analysis on the board page once none goes on (D-69), which the player may have brought there. */
+    /** The game in analysis on the board page once none goes on (D-69), which the player may have brought there, for a new review too. */
     analysis?: {
         game: string;
         brought?: true;
+        redo?: true;
         analyst?: "done" | "offer";
+        codex?: true;
         review?: string;
     };
     /** A game going on from before this chat, told once a chat: the player says whether to go on with it. */

package/dist/commands/game/status.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
-import { gameReviewOf, leadOf, reviewOf } from "../../core/index.js";
+import { Game, gameReviewOf, leadOf, reviewOf } from "../../core/index.js";
 import { archivedName, cleanSince, endOf, gameInAnalysis, lastChatStart } from "../../games/index.js";
-import { outdatedHostFiles } from "../../host-files/index.js";
+import { isCodex, outdatedHostFiles } from "../../host-files/index.js";
 import { gameFolder } from "../../profiles/index.js";
 import { version } from "../../version.js";
 import { analystLine, analystRuns, closingLines, coachOnEnd, coachOnEndLine, coachRuns, gameAt, goneOver, namedGame, newGameStep, positionLines, reviewedLine, shownMoves, sidesLine, speechLine, speechOf, summaryOf, unansweredWords, withAnalyst, withThought, wordLines, } from "../answers/index.js";
@@ -68,7 +68,9 @@ export const status = defineCommand({
                 status.analysis = {
                     game: analysis.game,
                     ...(analysis.brought === true ? { brought: true } : {}),
+                    ...(analysis.redo === true ? { redo: true } : {}),
                     ...(analystRuns(context) ? { analyst: goneOver(context, analysis.game) ? "done" : "offer" } : {}),
+                    ...(analystRuns(context) && isCodex(context.host?.()) ? { codex: true } : {}),
                     ...(review === undefined ? {} : { review }),
                 };
             }
@@ -113,30 +115,38 @@ function firstInChat(context, chatStart) {
 }
 /**
  * The game in analysis, with how far its review has got; the next step when the player has just brought it on the board page, unless an analyst is at it
- * already; the analyst agent for a game whose review was deleted, where it runs (Stefano).
+ * already, at once when they asked for a new review (Priya); the analyst agent for a game whose review was deleted, where it runs (Stefano).
  */
-function analysisLine({ game, brought, analyst, review }) {
+function analysisLine({ game, brought, redo, analyst, codex, review }) {
+    // A chat that remembered the old review put its notes back with annotate_game, and its corrections stand over every review after (Priya).
+    if (redo === true && analyst === "offer") {
+        return `The player asked on the board page for a new review of ${game}. Next, at once, even if an analyst was stopped before: ${analystLine(game, codex === true)} `
+            + "The new review replaces the old one: correct a note with annotate_game only when the player shows it wrong.";
+    }
     if (brought === true && analyst !== "done") {
         return analyst === "offer"
-            ? `The player brought ${game} on the board page to analyse it. Next: ${analystLine(game)}`
+            ? `The player brought ${game} on the board page to analyse it. Next: ${analystLine(game, codex === true)}`
             : `The player brought ${game} on the board page to analyse it. Next: call analyse_game {"game": "${game}"}, then keep your review on that page with annotate_game, and go over it with them.`;
     }
     const shown = `In analysis on the board page: ${game}${review === undefined ? "" : ` (${review})`}`;
     if (analyst === "done") {
         return `${shown}. ${reviewedLine(game)}`;
     }
-    return analyst === "offer" ? `${shown}. When the player wants it gone over, ${analystLine(game)}` : `${shown}; analyse_game {"game": "${game}"} goes over it with the player.`;
+    return analyst === "offer" ? `${shown}. When the player wants it gone over, ${analystLine(game, codex === true)}` : `${shown}; analyse_game {"game": "${game}"} goes over it with the player.`;
 }
 /**
- * How far the review of a game has got, as the board page shows it (Priya): done once it holds the word on the whole game and who is ahead after every move
- * but the last; the analyst may still write notes after its word, so that alone is not the end.
+ * How far the review of a game has got, as the board page shows it (Priya): done once it holds the word on the whole game and who is ahead after every move,
+ * but the last when the board ended the game there, which says it; the analyst may still write notes after its word, so that alone is not the end.
  */
 function reviewProgress(context, game) {
     try {
         const { record } = namedGame(context, game);
         const worded = gameReviewOf(record) !== undefined;
         const estimated = record.moves.filter(({ comment }) => leadOf(comment) !== undefined).length;
-        if (worded && estimated >= record.moves.length - 1) {
+        // A game resigned or lost on time needs who is ahead after its last move too; the game is played over only when that is the one estimate missing.
+        const all = record.moves.length;
+        const done = estimated >= all || (estimated === all - 1 && new Game(record).outcome.over);
+        if (worded && done) {
             return "its review is done";
         }
         const noted = record.moves.filter(({ comment }) => {

package/dist/commands/profiles/past-games.d.ts

@@ -1,11 +1,16 @@
 import { z } from "zod";
 /** The AI's memory of the games played (D-57): how the latest went, one line each, or one game whole from the archive. */
 export declare const pastGames: import("../registry/registry.ts").Command<z.ZodObject<{
+    search: z.ZodOptional<z.ZodString>;
     game: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, {
     games: string[];
+    searched: true | undefined;
 } | {
     pgn: string;
 }>;
-/** The latest games of the archive, one line each as the AI reads them: none when there is no archive. A game closed before any move is no game played. */
-export declare function pastGameLines(folder: string, count: number): string[];
+/**
+ * The latest games of the archive, one line each as the AI reads them, those holding every word searched: none when there is no archive. A game closed
+ * before any move is no game played.
+ */
+export declare function pastGameLines(folder: string, count: number, search?: string): string[];