📦 Mini Me
946a384 parent: aef6e17 modified
release-notes/README.md +1 -0 | @@ -4,6 +4,7 @@ One note per tag, in English (`.en.md`) and French (`.fr.md`). Rebuilt on 2026-1 | ||
| 4 | 4 | |
| 5 | 5 | | Version | Date | Summary | | |
| 6 | 6 | |---|---|---|---| |
| 7 | +| [v0.8.0](v0.8.0.en.md) | not tagged yet | Search what was said before and what is written down: recall your earlier questions in the window, search the stored sessions, and search a documentation folder. | [FR](v0.8.0.fr.md) | | |
| 7 | 8 | | [v0.7.0](v0.7.0.en.md) | 2026-10-18 | Free a model's memory, see which hooks ran, pick up an earlier session from your editor, and screen questions with guard models. | [FR](v0.7.0.fr.md) | |
| 8 | 9 | | [v0.6.0](v0.6.0.en.md) | 2026-10-17 | Your own tools declared in the agent file, and answers saved to a file without being written again. | [FR](v0.6.0.fr.md) | |
| 9 | 10 | | [v0.5.0](v0.5.0.en.md) | 2026-10-16 | Hooks: your own scripts around generations, tool calls and calls to other agents. | [FR](v0.5.0.fr.md) | |
| @@ -4,6 +4,7 @@ One note per tag, in English (`.en.md`) and French (`.fr.md`). Rebuilt on 2026-1 | |||
| 4 | 4 | ||
| 5 | | Version | Date | Summary | | | 5 | | Version | Date | Summary | | |
| 6 | |---|---|---|---| | 6 | |---|---|---|---| |
| 7 | +| [v0.8.0](v0.8.0.en.md) | not tagged yet | Search what was said before and what is written down: recall your earlier questions in the window, search the stored sessions, and search a documentation folder. | [FR](v0.8.0.fr.md) | | ||
| 7 | | [v0.7.0](v0.7.0.en.md) | 2026-10-18 | Free a model's memory, see which hooks ran, pick up an earlier session from your editor, and screen questions with guard models. | [FR](v0.7.0.fr.md) | | 8 | | [v0.7.0](v0.7.0.en.md) | 2026-10-18 | Free a model's memory, see which hooks ran, pick up an earlier session from your editor, and screen questions with guard models. | [FR](v0.7.0.fr.md) | |
| 8 | | [v0.6.0](v0.6.0.en.md) | 2026-10-17 | Your own tools declared in the agent file, and answers saved to a file without being written again. | [FR](v0.6.0.fr.md) | | 9 | | [v0.6.0](v0.6.0.en.md) | 2026-10-17 | Your own tools declared in the agent file, and answers saved to a file without being written again. | [FR](v0.6.0.fr.md) | |
| 9 | | [v0.5.0](v0.5.0.en.md) | 2026-10-16 | Hooks: your own scripts around generations, tool calls and calls to other agents. | [FR](v0.5.0.fr.md) | | 10 | | [v0.5.0](v0.5.0.en.md) | 2026-10-16 | Hooks: your own scripts around generations, tool calls and calls to other agents. | [FR](v0.5.0.fr.md) | |
added
release-notes/v0.8.0.en.md +71 -0 | new file mode 100644 | ||
| @@ -0,0 +1,71 @@ | ||
| 1 | +# mini-me v0.8.0 | |
| 2 | + | |
| 3 | +*[Version française](v0.8.0.fr.md)* | |
| 4 | + | |
| 5 | +Search what was said before and what is written down: recall your earlier questions in the window, search the stored sessions, and search a documentation folder — by hand or by the agent itself. | |
| 6 | + | |
| 7 | +## New | |
| 8 | + | |
| 9 | +### Recall earlier questions in the window (#68) | |
| 10 | + | |
| 11 | +- With `sessions.enabled: true`, **↑** on the first row of the input box brings back your last question; ↑ again goes further back, through this session and then the project's earlier ones, newest first. **↓** on the last row goes forward again; past the newest question it gives back what you were typing. | |
| 12 | +- A recalled question is plain text: edit it and press Enter, or press **Esc** to clear the box. | |
| 13 | +- **Esc now clears the box when no turn is running** and the box holds something. During a turn Esc still cancels it; on an empty box it still says `No generation in progress`. | |
| 14 | +- A question whose turn failed or was cancelled can be recalled until you ask the next one, so it is easy to retry. | |
| 15 | +- Nothing to recall (sessions off, or no question yet): ↑ scrolls the conversation as before. | |
| 16 | + | |
| 17 | +### Search the stored sessions — `/memory` and `search_memory` (#48) | |
| 18 | + | |
| 19 | +- **`/memory <words>`** searches the project's stored sessions and lists the hits: session id, date, turn, who said it, and the text around the words. A matching question comes with the answer its turn ended on (`→ …`). The model is not called. | |
| 20 | +- **`search_memory`** is a new built-in tool: the same search, called by the agent when a question refers to something decided before ("the port we chose", "like last time"). It never asks for permission. | |
| 21 | +- **Two new keys under `sessions`**, both off by default and independent: | |
| 22 | + - `searchMemory: true` turns on `/memory`; | |
| 23 | + - `autoSearchMemory: true` declares `search_memory`. | |
| 24 | + | |
| 25 | + Both need `sessions.enabled: true`; set without it, the start-up banner says so. | |
| 26 | +- Case and accents do not count. Questions, answers and `/compact` summaries are searched; tool calls, mm's own notes and the conversation in progress are not. | |
| 27 | +- **The search matches words, not meanings**: a question asked in another language than the session, or with other words, finds nothing. | |
| 28 | + | |
| 29 | +### Search a documentation folder — `/docs` and `search_docs` (#104, #106) | |
| 30 | + | |
| 31 | +- **`/docs <words>`** searches the text files of one or more folders and shows the best passages, each with its `path:line` link and its section headings. Passages are sections of the files, ranked with BM25 — no index and no model: mm's own `docs/` (137 files) is searched in about 45 ms. | |
| 32 | +- **`search_docs`** is a new built-in tool: the agent searches the documentation before it answers, and can `read_file` a whole page from a link. It never asks for permission. | |
| 33 | +- **New block `docSearch`**, off by default: | |
| 34 | + | |
| 35 | + ```yaml | |
| 36 | + docSearch: | |
| 37 | + searchDocs: true # /docs, for you | |
| 38 | + autoSearchDocs: true # search_docs, for the agent | |
| 39 | + dirs: [docs] # relative to the working directory | |
| 40 | + extensions: [.md] # only these files are read | |
| 41 | + maxFileSize: 1MB | |
| 42 | + ``` | |
| 43 | + | |
| 44 | + Default extensions: `.md .markdown .txt .adoc .asciidoc .rst`. Markdown and AsciiDoc files are cut at their headings (not inside code blocks), other files at blank lines. | |
| 45 | +- Case and accents do not count; words of four letters or more also match longer words and plurals (`list` finds `ListState`, `widgets` finds `widget`). Here too, the search matches words, not meanings. | |
| 46 | + | |
| 47 | +## Fixed | |
| 48 | + | |
| 49 | +- **Line mode: only the first of several piped lines was read** (#103). `printf '/sessions\n/help\n' | mm agent.yaml` or `mm agent.yaml < commands.txt` ran the first line and silently dropped the others. All of them now run, and a last line without a newline is no longer lost. Typing at the keyboard was not affected. | |
| 50 | + | |
| 51 | +## Demos | |
| 52 | + | |
| 53 | +- **`demos/memory-search/`** (new): an assistant for a small Go project that remembers what was decided in four earlier sessions (the API port, the storage, the logs — in French —, the deployment as a `/compact` summary). Qwen3.5 4B on llmman. Measured: every question whose words are in a session found and answered right (3/3 each, a French question on an English session included); a question with other words for the same thing honestly not found; no search on a greeting or a general question. | |
| 54 | +- **`demos/docs-search/`** (new): Rata, an assistant that answers Ratatui (Rust terminal UI) questions from nine short tutorials, citing the passage it used. Every program of the tutorials is compiled against ratatui 0.30 by `check-tutorials.sh` (Docker only). Qwen3.5 4B on llmman. Measured: right answers 3/3 on every question, French questions turned into English searches by the model, the program it was asked to write compiles; two answers cite a different passage than the one that explains, or none — the README says which. | |
| 55 | + | |
| 56 | +## Documentation | |
| 57 | + | |
| 58 | +- **New how-to guides** (EN + FR): | |
| 59 | + - [Search earlier sessions](../docs/en/how-to/search-earlier-sessions.md) | |
| 60 | + - [Search a documentation folder](../docs/en/how-to/search-the-docs.md) | |
| 61 | +- **New explanation**: [Documentation search](../docs/en/explanation/document-search.md) — why BM25 and no model, why no index, passages as sections. | |
| 62 | +- **Updated**: | |
| 63 | + - the window mode how-to: a new section "Recall an earlier question"; | |
| 64 | + - persistent sessions (explanation): why recall and `/memory` read the stored questions, how the search was refined; | |
| 65 | + - reference: configuration (the new keys, their validation errors), slash commands (`/memory`, `/docs`, ↑/↓ and Esc), tools (`search_memory`, `search_docs`), ACP (tool kind `search`). | |
| 66 | + | |
| 67 | +## Upgrading | |
| 68 | + | |
| 69 | +- **No breaking change in the configuration.** New keys: `sessions.searchMemory`, `sessions.autoSearchMemory` and the `docSearch` block — all off by default, so **no existing agent gets a new tool**. | |
| 70 | +- **Esc in the window**: when nothing runs, it now clears the input box instead of printing `No generation in progress`. That message is still shown on an empty box. | |
| 71 | +- **Scripts that pipe several lines into the line mode** now run all of them, not only the first. Check such a script does not contain lines that were silently ignored until now. | |
| new file mode 100644 | |||
| @@ -0,0 +1,71 @@ | |||
| 1 | +# mini-me v0.8.0 | ||
| 2 | + | ||
| 3 | +*[Version française](v0.8.0.fr.md)* | ||
| 4 | + | ||
| 5 | +Search what was said before and what is written down: recall your earlier questions in the window, search the stored sessions, and search a documentation folder — by hand or by the agent itself. | ||
| 6 | + | ||
| 7 | +## New | ||
| 8 | + | ||
| 9 | +### Recall earlier questions in the window (#68) | ||
| 10 | + | ||
| 11 | +- With `sessions.enabled: true`, **↑** on the first row of the input box brings back your last question; ↑ again goes further back, through this session and then the project's earlier ones, newest first. **↓** on the last row goes forward again; past the newest question it gives back what you were typing. | ||
| 12 | +- A recalled question is plain text: edit it and press Enter, or press **Esc** to clear the box. | ||
| 13 | +- **Esc now clears the box when no turn is running** and the box holds something. During a turn Esc still cancels it; on an empty box it still says `No generation in progress`. | ||
| 14 | +- A question whose turn failed or was cancelled can be recalled until you ask the next one, so it is easy to retry. | ||
| 15 | +- Nothing to recall (sessions off, or no question yet): ↑ scrolls the conversation as before. | ||
| 16 | + | ||
| 17 | +### Search the stored sessions — `/memory` and `search_memory` (#48) | ||
| 18 | + | ||
| 19 | +- **`/memory <words>`** searches the project's stored sessions and lists the hits: session id, date, turn, who said it, and the text around the words. A matching question comes with the answer its turn ended on (`→ …`). The model is not called. | ||
| 20 | +- **`search_memory`** is a new built-in tool: the same search, called by the agent when a question refers to something decided before ("the port we chose", "like last time"). It never asks for permission. | ||
| 21 | +- **Two new keys under `sessions`**, both off by default and independent: | ||
| 22 | + - `searchMemory: true` turns on `/memory`; | ||
| 23 | + - `autoSearchMemory: true` declares `search_memory`. | ||
| 24 | + | ||
| 25 | + Both need `sessions.enabled: true`; set without it, the start-up banner says so. | ||
| 26 | +- Case and accents do not count. Questions, answers and `/compact` summaries are searched; tool calls, mm's own notes and the conversation in progress are not. | ||
| 27 | +- **The search matches words, not meanings**: a question asked in another language than the session, or with other words, finds nothing. | ||
| 28 | + | ||
| 29 | +### Search a documentation folder — `/docs` and `search_docs` (#104, #106) | ||
| 30 | + | ||
| 31 | +- **`/docs <words>`** searches the text files of one or more folders and shows the best passages, each with its `path:line` link and its section headings. Passages are sections of the files, ranked with BM25 — no index and no model: mm's own `docs/` (137 files) is searched in about 45 ms. | ||
| 32 | +- **`search_docs`** is a new built-in tool: the agent searches the documentation before it answers, and can `read_file` a whole page from a link. It never asks for permission. | ||
| 33 | +- **New block `docSearch`**, off by default: | ||
| 34 | + | ||
| 35 | + ```yaml | ||
| 36 | + docSearch: | ||
| 37 | + searchDocs: true # /docs, for you | ||
| 38 | + autoSearchDocs: true # search_docs, for the agent | ||
| 39 | + dirs: [docs] # relative to the working directory | ||
| 40 | + extensions: [.md] # only these files are read | ||
| 41 | + maxFileSize: 1MB | ||
| 42 | + ``` | ||
| 43 | + | ||
| 44 | + Default extensions: `.md .markdown .txt .adoc .asciidoc .rst`. Markdown and AsciiDoc files are cut at their headings (not inside code blocks), other files at blank lines. | ||
| 45 | +- Case and accents do not count; words of four letters or more also match longer words and plurals (`list` finds `ListState`, `widgets` finds `widget`). Here too, the search matches words, not meanings. | ||
| 46 | + | ||
| 47 | +## Fixed | ||
| 48 | + | ||
| 49 | +- **Line mode: only the first of several piped lines was read** (#103). `printf '/sessions\n/help\n' | mm agent.yaml` or `mm agent.yaml < commands.txt` ran the first line and silently dropped the others. All of them now run, and a last line without a newline is no longer lost. Typing at the keyboard was not affected. | ||
| 50 | + | ||
| 51 | +## Demos | ||
| 52 | + | ||
| 53 | +- **`demos/memory-search/`** (new): an assistant for a small Go project that remembers what was decided in four earlier sessions (the API port, the storage, the logs — in French —, the deployment as a `/compact` summary). Qwen3.5 4B on llmman. Measured: every question whose words are in a session found and answered right (3/3 each, a French question on an English session included); a question with other words for the same thing honestly not found; no search on a greeting or a general question. | ||
| 54 | +- **`demos/docs-search/`** (new): Rata, an assistant that answers Ratatui (Rust terminal UI) questions from nine short tutorials, citing the passage it used. Every program of the tutorials is compiled against ratatui 0.30 by `check-tutorials.sh` (Docker only). Qwen3.5 4B on llmman. Measured: right answers 3/3 on every question, French questions turned into English searches by the model, the program it was asked to write compiles; two answers cite a different passage than the one that explains, or none — the README says which. | ||
| 55 | + | ||
| 56 | +## Documentation | ||
| 57 | + | ||
| 58 | +- **New how-to guides** (EN + FR): | ||
| 59 | + - [Search earlier sessions](../docs/en/how-to/search-earlier-sessions.md) | ||
| 60 | + - [Search a documentation folder](../docs/en/how-to/search-the-docs.md) | ||
| 61 | +- **New explanation**: [Documentation search](../docs/en/explanation/document-search.md) — why BM25 and no model, why no index, passages as sections. | ||
| 62 | +- **Updated**: | ||
| 63 | + - the window mode how-to: a new section "Recall an earlier question"; | ||
| 64 | + - persistent sessions (explanation): why recall and `/memory` read the stored questions, how the search was refined; | ||
| 65 | + - reference: configuration (the new keys, their validation errors), slash commands (`/memory`, `/docs`, ↑/↓ and Esc), tools (`search_memory`, `search_docs`), ACP (tool kind `search`). | ||
| 66 | + | ||
| 67 | +## Upgrading | ||
| 68 | + | ||
| 69 | +- **No breaking change in the configuration.** New keys: `sessions.searchMemory`, `sessions.autoSearchMemory` and the `docSearch` block — all off by default, so **no existing agent gets a new tool**. | ||
| 70 | +- **Esc in the window**: when nothing runs, it now clears the input box instead of printing `No generation in progress`. That message is still shown on an empty box. | ||
| 71 | +- **Scripts that pipe several lines into the line mode** now run all of them, not only the first. Check such a script does not contain lines that were silently ignored until now. | ||
added
release-notes/v0.8.0.fr.md +71 -0 | new file mode 100644 | ||
| @@ -0,0 +1,71 @@ | ||
| 1 | +# mini-me v0.8.0 | |
| 2 | + | |
| 3 | +*[English version](v0.8.0.en.md)* | |
| 4 | + | |
| 5 | +Retrouver ce qui a été dit et ce qui est écrit : rappeler ses questions précédentes dans la fenêtre, chercher dans les sessions enregistrées, et chercher dans un dossier de documentation — à la main ou par l'agent lui-même. | |
| 6 | + | |
| 7 | +## Nouveautés | |
| 8 | + | |
| 9 | +### Rappeler les questions précédentes dans la fenêtre (#68) | |
| 10 | + | |
| 11 | +- Avec `sessions.enabled: true`, **↑** sur la première rangée de la zone de saisie ramène votre dernière question ; ↑ à nouveau remonte plus loin, dans cette session puis dans les précédentes du projet, de la plus récente à la plus ancienne. **↓** sur la dernière rangée redescend ; après la plus récente, il rend ce que vous étiez en train de taper. | |
| 12 | +- Une question rappelée est du texte ordinaire : modifiez-la puis Entrée, ou **Échap** pour vider la zone. | |
| 13 | +- **Échap vide désormais la zone quand aucun tour ne tourne** et qu'elle contient quelque chose. Pendant un tour, Échap l'annule toujours ; sur une zone vide, il affiche toujours `No generation in progress`. | |
| 14 | +- La question d'un tour qui a échoué ou a été annulé reste rappelable jusqu'à la question suivante : elle est facile à relancer. | |
| 15 | +- Rien à rappeler (sessions désactivées, ou aucune question encore) : ↑ fait défiler la conversation comme avant. | |
| 16 | + | |
| 17 | +### Chercher dans les sessions enregistrées — `/memory` et `search_memory` (#48) | |
| 18 | + | |
| 19 | +- **`/memory <mots>`** cherche dans les sessions enregistrées du projet et liste les résultats : id de session, date, tour, qui parle, et le texte autour des mots. Une question qui correspond vient avec la réponse sur laquelle son tour s'est terminé (`→ …`). Le modèle n'est pas appelé. | |
| 20 | +- **`search_memory`** est un nouvel outil intégré : la même recherche, appelée par l'agent quand une question renvoie à une décision passée (« le port qu'on a choisi », « comme la dernière fois »). Il ne demande jamais de permission. | |
| 21 | +- **Deux nouvelles clés sous `sessions`**, désactivées par défaut et indépendantes : | |
| 22 | + - `searchMemory: true` active `/memory` ; | |
| 23 | + - `autoSearchMemory: true` déclare `search_memory`. | |
| 24 | + | |
| 25 | + Les deux demandent `sessions.enabled: true` ; activées sans, la bannière de démarrage le signale. | |
| 26 | +- La casse et les accents ne comptent pas. Les questions, les réponses et les résumés de `/compact` sont cherchés ; les appels d'outils, les notes de mm et la conversation en cours ne le sont pas. | |
| 27 | +- **La recherche porte sur les mots, pas sur le sens** : une question posée dans une autre langue que la session, ou avec d'autres mots, ne trouve rien. | |
| 28 | + | |
| 29 | +### Chercher dans un dossier de documentation — `/docs` et `search_docs` (#104, #106) | |
| 30 | + | |
| 31 | +- **`/docs <mots>`** cherche dans les fichiers texte d'un ou plusieurs dossiers et affiche les meilleurs passages, chacun avec son lien `chemin:ligne` et ses titres de section. Les passages sont les sections des fichiers, classées avec BM25 — sans index ni modèle : le `docs/` de mm (137 fichiers) est parcouru en 45 ms environ. | |
| 32 | +- **`search_docs`** est un nouvel outil intégré : l'agent cherche dans la documentation avant de répondre, et peut lire une page entière avec `read_file` à partir d'un lien. Il ne demande jamais de permission. | |
| 33 | +- **Nouveau bloc `docSearch`**, désactivé par défaut : | |
| 34 | + | |
| 35 | + ```yaml | |
| 36 | + docSearch: | |
| 37 | + searchDocs: true # /docs, pour vous | |
| 38 | + autoSearchDocs: true # search_docs, pour l'agent | |
| 39 | + dirs: [docs] # relatif au répertoire de travail | |
| 40 | + extensions: [.md] # seuls ces fichiers sont lus | |
| 41 | + maxFileSize: 1MB | |
| 42 | + ``` | |
| 43 | + | |
| 44 | + Extensions par défaut : `.md .markdown .txt .adoc .asciidoc .rst`. Les fichiers Markdown et AsciiDoc sont découpés à leurs titres (pas dans les blocs de code), les autres aux lignes vides. | |
| 45 | +- La casse et les accents ne comptent pas ; les mots de quatre lettres ou plus trouvent aussi les mots plus longs et les pluriels (`list` trouve `ListState`, `widgets` trouve `widget`). Ici aussi, la recherche porte sur les mots, pas sur le sens. | |
| 46 | + | |
| 47 | +## Corrigé | |
| 48 | + | |
| 49 | +- **Mode ligne : seule la première de plusieurs lignes reçues par un pipe était lue** (#103). `printf '/sessions\n/help\n' | mm agent.yaml` ou `mm agent.yaml < commandes.txt` exécutait la première ligne et ignorait les autres sans rien dire. Elles s'exécutent maintenant toutes, et une dernière ligne sans retour à la ligne n'est plus perdue. La saisie au clavier n'était pas touchée. | |
| 50 | + | |
| 51 | +## Démos | |
| 52 | + | |
| 53 | +- **`demos/memory-search/`** (nouvelle) : un assistant pour un petit projet Go qui se souvient de ce qui a été décidé dans quatre sessions précédentes (le port de l'API, le stockage, les logs — en français —, le déploiement sous forme de résumé `/compact`). Qwen3.5 4B sur llmman. Mesuré : chaque question dont les mots sont dans une session trouvée et bien répondue (3/3 chacune, y compris une question en français sur une session en anglais) ; une question avec d'autres mots pour la même chose honnêtement non trouvée ; aucune recherche sur une salutation ou une question générale. | |
| 54 | +- **`demos/docs-search/`** (nouvelle) : Rata, un assistant qui répond aux questions sur Ratatui (interfaces terminal en Rust) à partir de neuf tutoriels courts, en citant le passage utilisé. Chaque programme des tutoriels est compilé avec ratatui 0.30 par `check-tutorials.sh` (Docker seulement). Qwen3.5 4B sur llmman. Mesuré : réponses justes 3/3 sur chaque question, questions en français transformées en recherches en anglais par le modèle, le programme qu'on lui demande d'écrire compile ; deux réponses citent un autre passage que celui qui explique, ou aucun — le README dit lesquelles. | |
| 55 | + | |
| 56 | +## Documentation | |
| 57 | + | |
| 58 | +- **Nouveaux guides pratiques** (EN + FR) : | |
| 59 | + - [Chercher dans les sessions précédentes](../docs/fr/how-to/search-earlier-sessions.md) | |
| 60 | + - [Chercher dans un dossier de documentation](../docs/fr/how-to/search-the-docs.md) | |
| 61 | +- **Nouvelle explication** : [La recherche dans la documentation](../docs/fr/explanation/document-search.md) — pourquoi BM25 et aucun modèle, pourquoi pas d'index, des passages qui sont des sections. | |
| 62 | +- **Mis à jour** : | |
| 63 | + - le guide du mode fenêtre : une nouvelle section « Rappeler une question précédente » ; | |
| 64 | + - les sessions persistantes (explication) : pourquoi le rappel et `/memory` lisent les questions enregistrées, comment la recherche a été affinée ; | |
| 65 | + - la référence : configuration (les nouvelles clés, leurs erreurs de validation), commandes (`/memory`, `/docs`, ↑/↓ et Échap), outils (`search_memory`, `search_docs`), ACP (type d'outil `search`). | |
| 66 | + | |
| 67 | +## Mise à jour | |
| 68 | + | |
| 69 | +- **Aucun changement cassant dans la configuration.** Nouvelles clés : `sessions.searchMemory`, `sessions.autoSearchMemory` et le bloc `docSearch` — toutes désactivées par défaut, donc **aucun agent existant ne reçoit d'outil supplémentaire**. | |
| 70 | +- **Échap dans la fenêtre** : quand rien ne tourne, il vide maintenant la zone de saisie au lieu d'afficher `No generation in progress`. Ce message reste affiché sur une zone vide. | |
| 71 | +- **Les scripts qui envoient plusieurs lignes au mode ligne par un pipe** les exécutent maintenant toutes, et plus seulement la première. Vérifiez qu'un tel script ne contient pas de lignes qui étaient ignorées sans bruit jusqu'ici. | |
| new file mode 100644 | |||
| @@ -0,0 +1,71 @@ | |||
| 1 | +# mini-me v0.8.0 | ||
| 2 | + | ||
| 3 | +*[English version](v0.8.0.en.md)* | ||
| 4 | + | ||
| 5 | +Retrouver ce qui a été dit et ce qui est écrit : rappeler ses questions précédentes dans la fenêtre, chercher dans les sessions enregistrées, et chercher dans un dossier de documentation — à la main ou par l'agent lui-même. | ||
| 6 | + | ||
| 7 | +## Nouveautés | ||
| 8 | + | ||
| 9 | +### Rappeler les questions précédentes dans la fenêtre (#68) | ||
| 10 | + | ||
| 11 | +- Avec `sessions.enabled: true`, **↑** sur la première rangée de la zone de saisie ramène votre dernière question ; ↑ à nouveau remonte plus loin, dans cette session puis dans les précédentes du projet, de la plus récente à la plus ancienne. **↓** sur la dernière rangée redescend ; après la plus récente, il rend ce que vous étiez en train de taper. | ||
| 12 | +- Une question rappelée est du texte ordinaire : modifiez-la puis Entrée, ou **Échap** pour vider la zone. | ||
| 13 | +- **Échap vide désormais la zone quand aucun tour ne tourne** et qu'elle contient quelque chose. Pendant un tour, Échap l'annule toujours ; sur une zone vide, il affiche toujours `No generation in progress`. | ||
| 14 | +- La question d'un tour qui a échoué ou a été annulé reste rappelable jusqu'à la question suivante : elle est facile à relancer. | ||
| 15 | +- Rien à rappeler (sessions désactivées, ou aucune question encore) : ↑ fait défiler la conversation comme avant. | ||
| 16 | + | ||
| 17 | +### Chercher dans les sessions enregistrées — `/memory` et `search_memory` (#48) | ||
| 18 | + | ||
| 19 | +- **`/memory <mots>`** cherche dans les sessions enregistrées du projet et liste les résultats : id de session, date, tour, qui parle, et le texte autour des mots. Une question qui correspond vient avec la réponse sur laquelle son tour s'est terminé (`→ …`). Le modèle n'est pas appelé. | ||
| 20 | +- **`search_memory`** est un nouvel outil intégré : la même recherche, appelée par l'agent quand une question renvoie à une décision passée (« le port qu'on a choisi », « comme la dernière fois »). Il ne demande jamais de permission. | ||
| 21 | +- **Deux nouvelles clés sous `sessions`**, désactivées par défaut et indépendantes : | ||
| 22 | + - `searchMemory: true` active `/memory` ; | ||
| 23 | + - `autoSearchMemory: true` déclare `search_memory`. | ||
| 24 | + | ||
| 25 | + Les deux demandent `sessions.enabled: true` ; activées sans, la bannière de démarrage le signale. | ||
| 26 | +- La casse et les accents ne comptent pas. Les questions, les réponses et les résumés de `/compact` sont cherchés ; les appels d'outils, les notes de mm et la conversation en cours ne le sont pas. | ||
| 27 | +- **La recherche porte sur les mots, pas sur le sens** : une question posée dans une autre langue que la session, ou avec d'autres mots, ne trouve rien. | ||
| 28 | + | ||
| 29 | +### Chercher dans un dossier de documentation — `/docs` et `search_docs` (#104, #106) | ||
| 30 | + | ||
| 31 | +- **`/docs <mots>`** cherche dans les fichiers texte d'un ou plusieurs dossiers et affiche les meilleurs passages, chacun avec son lien `chemin:ligne` et ses titres de section. Les passages sont les sections des fichiers, classées avec BM25 — sans index ni modèle : le `docs/` de mm (137 fichiers) est parcouru en 45 ms environ. | ||
| 32 | +- **`search_docs`** est un nouvel outil intégré : l'agent cherche dans la documentation avant de répondre, et peut lire une page entière avec `read_file` à partir d'un lien. Il ne demande jamais de permission. | ||
| 33 | +- **Nouveau bloc `docSearch`**, désactivé par défaut : | ||
| 34 | + | ||
| 35 | + ```yaml | ||
| 36 | + docSearch: | ||
| 37 | + searchDocs: true # /docs, pour vous | ||
| 38 | + autoSearchDocs: true # search_docs, pour l'agent | ||
| 39 | + dirs: [docs] # relatif au répertoire de travail | ||
| 40 | + extensions: [.md] # seuls ces fichiers sont lus | ||
| 41 | + maxFileSize: 1MB | ||
| 42 | + ``` | ||
| 43 | + | ||
| 44 | + Extensions par défaut : `.md .markdown .txt .adoc .asciidoc .rst`. Les fichiers Markdown et AsciiDoc sont découpés à leurs titres (pas dans les blocs de code), les autres aux lignes vides. | ||
| 45 | +- La casse et les accents ne comptent pas ; les mots de quatre lettres ou plus trouvent aussi les mots plus longs et les pluriels (`list` trouve `ListState`, `widgets` trouve `widget`). Ici aussi, la recherche porte sur les mots, pas sur le sens. | ||
| 46 | + | ||
| 47 | +## Corrigé | ||
| 48 | + | ||
| 49 | +- **Mode ligne : seule la première de plusieurs lignes reçues par un pipe était lue** (#103). `printf '/sessions\n/help\n' | mm agent.yaml` ou `mm agent.yaml < commandes.txt` exécutait la première ligne et ignorait les autres sans rien dire. Elles s'exécutent maintenant toutes, et une dernière ligne sans retour à la ligne n'est plus perdue. La saisie au clavier n'était pas touchée. | ||
| 50 | + | ||
| 51 | +## Démos | ||
| 52 | + | ||
| 53 | +- **`demos/memory-search/`** (nouvelle) : un assistant pour un petit projet Go qui se souvient de ce qui a été décidé dans quatre sessions précédentes (le port de l'API, le stockage, les logs — en français —, le déploiement sous forme de résumé `/compact`). Qwen3.5 4B sur llmman. Mesuré : chaque question dont les mots sont dans une session trouvée et bien répondue (3/3 chacune, y compris une question en français sur une session en anglais) ; une question avec d'autres mots pour la même chose honnêtement non trouvée ; aucune recherche sur une salutation ou une question générale. | ||
| 54 | +- **`demos/docs-search/`** (nouvelle) : Rata, un assistant qui répond aux questions sur Ratatui (interfaces terminal en Rust) à partir de neuf tutoriels courts, en citant le passage utilisé. Chaque programme des tutoriels est compilé avec ratatui 0.30 par `check-tutorials.sh` (Docker seulement). Qwen3.5 4B sur llmman. Mesuré : réponses justes 3/3 sur chaque question, questions en français transformées en recherches en anglais par le modèle, le programme qu'on lui demande d'écrire compile ; deux réponses citent un autre passage que celui qui explique, ou aucun — le README dit lesquelles. | ||
| 55 | + | ||
| 56 | +## Documentation | ||
| 57 | + | ||
| 58 | +- **Nouveaux guides pratiques** (EN + FR) : | ||
| 59 | + - [Chercher dans les sessions précédentes](../docs/fr/how-to/search-earlier-sessions.md) | ||
| 60 | + - [Chercher dans un dossier de documentation](../docs/fr/how-to/search-the-docs.md) | ||
| 61 | +- **Nouvelle explication** : [La recherche dans la documentation](../docs/fr/explanation/document-search.md) — pourquoi BM25 et aucun modèle, pourquoi pas d'index, des passages qui sont des sections. | ||
| 62 | +- **Mis à jour** : | ||
| 63 | + - le guide du mode fenêtre : une nouvelle section « Rappeler une question précédente » ; | ||
| 64 | + - les sessions persistantes (explication) : pourquoi le rappel et `/memory` lisent les questions enregistrées, comment la recherche a été affinée ; | ||
| 65 | + - la référence : configuration (les nouvelles clés, leurs erreurs de validation), commandes (`/memory`, `/docs`, ↑/↓ et Échap), outils (`search_memory`, `search_docs`), ACP (type d'outil `search`). | ||
| 66 | + | ||
| 67 | +## Mise à jour | ||
| 68 | + | ||
| 69 | +- **Aucun changement cassant dans la configuration.** Nouvelles clés : `sessions.searchMemory`, `sessions.autoSearchMemory` et le bloc `docSearch` — toutes désactivées par défaut, donc **aucun agent existant ne reçoit d'outil supplémentaire**. | ||
| 70 | +- **Échap dans la fenêtre** : quand rien ne tourne, il vide maintenant la zone de saisie au lieu d'afficher `No generation in progress`. Ce message reste affiché sur une zone vide. | ||
| 71 | +- **Les scripts qui envoient plusieurs lignes au mode ligne par un pipe** les exécutent maintenant toutes, et plus seulement la première. Vérifiez qu'un tel script ne contient pas de lignes qui étaient ignorées sans bruit jusqu'ici. | ||