mcptoolshop-rnd 1.1.3.0.0

English | 日本語 | 中文 | Español | Français | हिन्दी | Italiano | Português (BR)

The studio's research bench. Findings from any field come in fast as short Markdown entries, with every source tagged and every claim marked as checked or not. Experiments sit next to the entries they test. External catalogues are mirrored and rated, and a registry lists the studio tools research can call on. One command searches all of it.

Where it sits: the bench before readouts

Two stores hold the studio's knowledge, and they do different jobs.

Knowledge moves one way:

1. Bench. A finding lands here as an entry. Its claims start [unverified], and are marked [verified] only with a note of what checked them. Measurements made on our own machines go in as rig sources, with their harness under experiments/.
2. Internal shelf. Once a topic's load-bearing claims hold up, it is built into a knowledge base in readouts' private working repo, or added to one.
3. Public shelf. A knowledge base is published to the public readouts repo when it is added to the export allow-list.

rnd readouts searches every readouts knowledge base from here, so one seat reaches both stores. Search the bench first, the shelf second, then research the gap.

Research here is not limited to the studio's own fields. Each entry records two things separately: what the knowledge is, and what it means for the studio (relevance: act | watch | reference). reference is a fine verdict.

Use it

Requires Python 3.10 or later and nothing else (standard library only). Runs on Windows, macOS and Linux. From the repo root:

python -m rnd search cuda graphs            # full-text over entries + catalogues
python -m rnd show 2026-10-07-cuda-graphs   # one entry, with backlinks
python -m rnd list --relevance act          # what needs doing
python -m rnd tools                         # instruments this seat can use
python -m rnd readouts splice glitch --any  # search the readouts knowledge bases too
python -m rnd catalog lanes                 # NVIDIA skills by lane, with studio fit
python -m rnd catalog list --fit adjacent   # skills worth using when the need arises
python -m rnd new "Paper title" --kind paper --field audio --tag pitch
python -m rnd check                         # validate every file (exit 1 on errors)
python -m rnd sql "SELECT tier, count(*) FROM sources GROUP BY tier"
python -m rnd bump --note "what changed"  # micro version bump + CHANGELOG section

Every listing command takes --json for agents. rnd.cmd (Windows) and rnd.sh (POSIX shells) are thin wrappers, so the command works from any directory.

To use the tool from other projects, install it from PyPI:

pip install mcptoolshop-rnd

That installs the rnd command, not the library: the entries live in this repository. The command finds a library in this order: --library DIR, then $RND_ROOT, then the nearest folder at or above the current one that holds entries/ and instruments/. Outside a library it stops with NO_LIBRARY; only rnd readouts works without one.

In Python, import mcptoolshop_rnd: that name always works. rnd is kept as a compatibility alias, but an unrelated PyPI package is also called rnd, and if both are installed it can replace the alias. The rnd command and python -m mcptoolshop_rnd keep working either way.

The library changes daily, so versions have five segments, MAJOR.MINOR.PATCH.MICRO.NANO. The first three version the rnd tool; MICRO marks a structural library change and NANO an ordinary update. rnd bump raises the last segment by default and writes a CHANGELOG section from the files changed since the last tag, so each update gets its own small tagged version.

Exit codes: 0 ok · 1 invalid library files · 2 usage error or not found · 3 runtime failure (an external tool, or an unexpected error). Errors print a code, a message and a hint; --debug adds the traceback.

Layout

Entry format

---
id: 2026-10-07-cuda-graphs        # defaults to the file name
title: CUDA Graphs
date: 2026-10-07
kind: concept                     # finding concept release paper tool catalog rig-fact event question decision instrument
relevance: reference              # act | watch | reference
fields: [gpu-computing]           # any research field, open vocabulary
tags: [cuda-graphs, pytorch]
---

## Summary
## Key points
## Studio relevance
## Claims
- [unverified] A checkable statement.
- [verified] A checked statement. (via: what checked it, date)
## Sources
- [primary] https://… — publisher

• Source tiers: primary (vendor docs, papers, repos), secondary (reputable write-ups), aggregator (summary sites, AI search output), user (supplied by a person: slides, notes), rig (measured on our machines).
• Claim confidence: unverified, verified, disputed, wrong. A verified or wrong claim must say what checked it with (via: …).
• [[entry-id]] links entries; rnd show lists backlinks.

Relation to other studio tools

• readouts is the verified shelf this bench feeds (see above).
• research-os builds a gated, frozen evidence pack for one topic. A topic a decision depends on can graduate into a research-os pack, linked from the entry.
• repo-knowledge indexes the studio's own repos; this library covers knowledge from outside them.
• Findings gathered while designing something belong here too, so they outlive the session that produced them.

See python -m rnd tools for the full instrument registry, and docs/standards.md for how the workflow scores against the studio's workflow standards.

Security and trust

• Data touched: files inside this repo (entries/, instruments/, catalogs/, experiments/) and the index rnd.db, which it rebuilds. rnd readouts opens the readouts knowledge bases read-only. rnd sql runs against a read-only connection.
• Data not touched: nothing outside the repo and the readouts checkout. It stores no credentials and reads none.
• Network: none, except rnd catalog sync, which calls the GitHub API through your own gh CLI login when you run it.
• Permissions: ordinary file access. No elevated rights, no background service.
• No telemetry. Nothing is collected or sent.
• Public repo hygiene: before every push, the tree is scanned for home-directory paths and operator identity.

Report vulnerabilities as described in SECURITY.md.

Tests

bash verify.sh                               # tests, library check, index build, smoke
python -m unittest discover -s tests -t .    # tests only

Status and licence

Maintained by the studio and in daily use. Code: MIT. Entries: CC BY 4.0. The NVIDIA skills mirror in catalogs/nvidia-skills/catalog.json reproduces skill names and descriptions from NVIDIA/skills under that project's licences (Apache-2.0 for code, CC-BY-4.0 for skill text).

Built by MCP Tool Shop