mcp-recipes 3.0.0 → 4.0.0

package/CHANGELOG.md

@@ -1,5 +1,75 @@
 # Changelog
 
+## 4.0.0
+
+- **The published client entry renames a field on `SourceProfile` and
+  `SourceReport`.** A program importing `mcp-recipes/client` reads
+  `rowsThatAreNotRecipes` where it read `mixesReferencePages`: a sentence in the
+  source's own words saying what else one of its rows can be, and null where
+  every row is a recipe. The boolean forced one wording on two different
+  situations, a page about an ingredient filed beside the recipes using it and
+  an article that gathers recipes, and one sentence could only describe one of
+  them truthfully. The tools' own answers are unaffected: `per_source` never
+  published the field, and the note it produces now names each source in that
+  source's terms.
+- **`get_recipe` answers in two shapes, and `kind` says which.** One source
+  publishes articles that gather recipes at the same kind of address as a
+  recipe. Such an answer carries `collection` with the headings and the recipes
+  it points at, and no `recipe`; a recipe carries `recipe` and no `collection`.
+  A caller that read the article as a recipe would have offered a dish nobody
+  can cook. `compare_recipes` leaves such a page out and says why.
+- **Pequerecetas is added**, under the id `pequerecetas`, beside the five
+  sources already read. It publishes in Spanish, states no total anywhere, and
+  addresses a recipe by the slug in its own address.
+- **Spanish is read and written like the other two languages.** The scaler
+  reads a Spanish line for what it is, keeps a huevo whole, halves a diente,
+  quarters a cebolla, moves a cucharada into the cucharadita before rounding
+  it, multiplies the count of a pizca while leaving the size of one to the
+  cook, and agrees nouns and adjectives with the number in front of them. A
+  list holding all three languages comes back with each line written in its
+  own. `scale_ingredients` takes `es` beside `fr`, `en` and `auto`.
+- **A line naming a tool is recognised and never multiplied.** Some sites write
+  what a recipe is cooked with among its ingredients, so a mould or an air
+  fryer arrives in the same list as the chicken. Every ingredient line carries
+  `is_equipment`, and `scale_ingredients` reports `equipment_count` beside the
+  counts of what was scaled: a recipe made for more people uses the same pan.
+- **Each site is read at the pace it asks for.** Two of the sites declare three
+  seconds between two requests where the shared default is one second, and they
+  were being read four times faster than that. A setting posted for every
+  source can now only make this server more patient than the slowest of them
+  asks for.
+- **A row that does not name the dish is no longer called a recipe for it.**
+  One of the sources answers any wording with something, so a question asked in
+  a language it does not publish in came back as several confident recipes for a
+  dish nobody published. Every source's rows are now arranged with the ones
+  naming the dish first, `per_source` carries `names_the_dish` beside `count`,
+  and the answer opens on "rows" rather than "recipes" where no source named it.
+- **The library section of the README states the API the client actually has.**
+  It documented a call that does not exist.
+- **An amount stated per eater is recognised in every language.** "50 g par
+  personne" and "50 g por persona" were multiplied by the factor, which asks for
+  twice as much on every plate; only the English wording was read. A length of
+  time is read the same way, in whichever language names it.
+- **The backstop over one source allows what a reader actually spends.** It was
+  computed on the shared spacing and left out the wait a site asks for by name,
+  so it could fire while the reader was still working: the read was abandoned
+  while its requests carried on reaching the site.
+- **An article that gathers recipes is returned bounded.** It was the one answer
+  with no ceiling on it, and an article can point at a hundred recipes.
+  `max_gathered` says how many to return and `gathered_count` how many there
+  are.
+
+## 3.0.1
+
+- **Every tool is documented, with its arguments and what its answer carries.**
+  The README is written for a person deciding whether to install and for a
+  program installing on its own, and a test holds both halves to what the server
+  registers.
+- **The privacy policy travels in the package.** It states the hosts contacted,
+  what a request carries, what is held and for how long.
+- **The manifest names every tool the server registers**, which a host reads
+  before installing anything.
+
 ## 3.0.0
 
 - **`compare_recipes` now answers with up to five versions where it answered

package/PRIVACY.md

@@ -8,7 +8,7 @@ _[Version française](#confidentialité)_
 
 ## What this server is
 
-`mcp-recipes` is a read-only client for five recipe sites: [Marmiton](https://www.marmiton.org), the [Wikibooks Cookbook](https://en.wikibooks.org/wiki/Cookbook:Table_of_Contents), [Ptitchef](https://www.ptitchef.com), [BBC Good Food](https://www.bbcgoodfood.com) and [Supertoinette](https://www.supertoinette.com). It runs on your
+`mcp-recipes` is a read-only client for six recipe sites: [Marmiton](https://www.marmiton.org), the [Wikibooks Cookbook](https://en.wikibooks.org/wiki/Cookbook:Table_of_Contents), [Ptitchef](https://www.ptitchef.com), [BBC Good Food](https://www.bbcgoodfood.com), [Supertoinette](https://www.supertoinette.com) and [Pequerecetas](https://www.pequerecetas.com). It runs on your
 own machine, as a process your MCP host starts, and it speaks over stdio. It
 listens on no port.
 
@@ -16,7 +16,7 @@ It needs no API key and no account, so there is no credential for it to hold and
 
 ## What leaves your machine, and where it goes
 
-**5 hosts are contacted**, and nothing else.
+**6 hosts are contacted**, and nothing else.
 
 | Host                    | What is read there                                                                               |
 | ----------------------- | ------------------------------------------------------------------------------------------------ |
@@ -25,6 +25,7 @@ It needs no API key and no account, so there is no credential for it to hold and
 | `www.ptitchef.com`      | the site's pages                                                                                 |
 | `www.bbcgoodfood.com`   | a JSON route the site's own front end uses, for a search; the recipe's page itself, for a recipe |
 | `www.supertoinette.com` | the site's pages                                                                                 |
+| `www.pequerecetas.com`  | the site's pages                                                                                 |
 
 A Cookbook page is linked as `en.wikibooks.org`, which is where a reader opens
 it. That host is never contacted by this server: the pages themselves are read
@@ -38,7 +39,7 @@ What a request carries:
 | A `User-Agent`         | `mcp-recipes/<version> (+https://github.com/smeet666/mcp-recipes)`, so the site can reach a person about the traffic it receives. |
 | Your IP address        | Sent by your network to any host you contact, as with any web request.                                                            |
 
-Your requests reach the five sites above. What is done with them there is governed by each site's own privacy policy, which this project does not control.
+Your requests reach the six sites above. What is done with them there is governed by each site's own privacy policy, which this project does not control.
 
 ## What is kept, and for how long
 
@@ -90,7 +91,7 @@ Ce serveur ne collecte rien sur vous et n'envoie rien à son auteur.
 
 ## Ce qu'est ce serveur
 
-`mcp-recipes` est un client en lecture seule pour cinq sites de recettes : [Marmiton](https://www.marmiton.org), le [Cookbook des Wikibooks](https://en.wikibooks.org/wiki/Cookbook:Table_of_Contents), [Ptitchef](https://www.ptitchef.com), [BBC Good Food](https://www.bbcgoodfood.com) et [Supertoinette](https://www.supertoinette.com). Il
+`mcp-recipes` est un client en lecture seule pour six sites de recettes : [Marmiton](https://www.marmiton.org), le [Cookbook des Wikibooks](https://en.wikibooks.org/wiki/Cookbook:Table_of_Contents), [Ptitchef](https://www.ptitchef.com), [BBC Good Food](https://www.bbcgoodfood.com), [Supertoinette](https://www.supertoinette.com) et [Pequerecetas](https://www.pequerecetas.com). Il
 tourne sur votre machine, comme un processus que votre hôte MCP démarre, et il
 parle en stdio. Il n'écoute sur aucun port.
 
@@ -98,7 +99,7 @@ Il ne demande ni clé d'API ni compte, donc il ne détient aucun identifiant et
 
 ## Ce qui quitte votre machine, et où cela va
 
-**5 hôtes sont joints**, et rien d'autre.
+**6 hôtes sont joints**, et rien d'autre.
 
 | Hôte                    | Ce qui y est lu                                                                                             |
 | ----------------------- | ----------------------------------------------------------------------------------------------------------- |
@@ -107,6 +108,7 @@ Il ne demande ni clé d'API ni compte, donc il ne détient aucun identifiant et
 | `www.ptitchef.com`      | les pages du site                                                                                           |
 | `www.bbcgoodfood.com`   | une route JSON qu'emploie l'interface du site, pour une recherche ; la page de la recette, pour une recette |
 | `www.supertoinette.com` | les pages du site                                                                                           |
+| `www.pequerecetas.com`  | les pages du site                                                                                           |
 
 Une page du Cookbook est liée sous `en.wikibooks.org`, où un lecteur l'ouvre. Ce
 serveur ne joint jamais cet hôte : les pages elles-mêmes sont lues par la
@@ -120,7 +122,7 @@ Ce qu'une requête emporte :
 | Un `User-Agent`   | `mcp-recipes/<version> (+https://github.com/smeet666/mcp-recipes)`, pour que le site puisse joindre une personne au sujet du trafic qu'il reçoit. |
 | Votre adresse IP  | Transmise par votre réseau à tout hôte que vous joignez, comme pour n'importe quelle requête web.                                                 |
 
-Vos requêtes atteignent les cinq sites ci-dessus. Ce qui en est fait là-bas relève de la politique de confidentialité propre à chaque site, que ce projet ne contrôle pas.
+Vos requêtes atteignent les six sites ci-dessus. Ce qui en est fait là-bas relève de la politique de confidentialité propre à chaque site, que ce projet ne contrôle pas.
 
 ## Ce qui est conservé, et combien de temps