@rnd-news/newsletter 0.0.0 → 1.30.0

package/README.md

@@ -1,3 +1,39 @@
-# @rnd-news/newsletter
+# Research and Development: the newsletter
 
-Placeholder. The daily rnd newsletter from mcp-tool-shop will be published here from CI, with provenance. Read it now at https://mcp-tool-shop-org.github.io/rnd/newsletter/
+The research newsletter of mcp-tool-shop: what we measured, and what it means. Each issue reports the studio's experiments
+in plain language, with the numbers, the charts, what held up and what didn't.
+
+This package mirrors the published issues and is updated automatically after each issue goes live on the site.
+It holds 28 issues. The newest is issue 30, 2026-10-25: [25 October: a crash test, a lab for tests with proven answers, and our Colab cards measured](https://mcp-tool-shop-org.github.io/rnd/newsletter/issue-30/).
+
+- **Read it on the web:** https://mcp-tool-shop-org.github.io/rnd/
+- **RSS:** https://mcp-tool-shop-org.github.io/rnd/newsletter/rss.xml
+- **Source:** [mcp-tool-shop-org/rnd](https://github.com/mcp-tool-shop-org/rnd), where each issue is
+  `site/src/content/docs/newsletter/issue-NN.md`.
+
+## Files
+
+- `data/issues.jsonl`: one row per issue, with `issue`, `date`, `title`, `description`, `highlights` (HTML
+  strings), `url` and `body_markdown` (the issue's Markdown, with site links made absolute).
+- `index.json`: the package's main export, one entry per issue without its body.
+- `issues/issue-NN.md`: each issue as a Markdown file with its front matter.
+
+Charts are linked from the site, not copied here.
+
+## Load it
+
+```js
+const index = require("@rnd-news/newsletter");          // one entry per issue, newest last
+```
+
+```js
+import index from "@rnd-news/newsletter" with { type: "json" };
+```
+
+Each entry gives the issue's number, date, title, description, highlights, url and `file`, the path of its
+Markdown inside the package (`@rnd-news/newsletter/issues/issue-NN.md`). `data/issues.jsonl` holds the full rows,
+bodies included. The same data is on Hugging Face as [mcp-tool-shop/rnd-newsletter](https://huggingface.co/datasets/mcp-tool-shop/rnd-newsletter).
+
+## Licence and author
+
+MIT, the licence of the rnd repository the issues are published from. Author: mcp-tool-shop.