robert-ai 0.1.0__tar.gz

robert_ai-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Robert J. Hardwick
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

robert_ai-0.1.0/PKG-INFO

@@ -0,0 +1,213 @@
+Metadata-Version: 2.4
+Name: robert-ai
+Version: 0.1.0
+Summary: The AI simulation scientist: a method CLI and MCP server that drives stochadex projects through the discovery-and-warrant loop.
+Author-email: umbralcalc <umbralcalc@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/umbralcalc/robert
+Project-URL: Changelog, https://github.com/umbralcalc/robert/blob/main/CHANGELOG.md
+Keywords: simulation,stochadex,scientific-method,mcp,agents
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering
+Classifier: Environment :: Console
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml>=6
+Requires-Dist: mcp<3,>=2.3
+Requires-Dist: uvicorn>=0.30
+Requires-Dist: httpx>=0.27
+Provides-Extra: arrow
+Requires-Dist: pyarrow>=15; extra == "arrow"
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: build>=1.2; extra == "dev"
+Dynamic: license-file
+
+# robert
+
+The AI scientific research developer powered by simulations.
+
+robert is the method layer of an AI simulation scientist. It packages what a
+simulation scientist does as tools that any coding agent can call, and it leaves the
+simulation itself to [stochadex](https://github.com/umbralcalc/stochadex). The agent
+does the implementation, and the experienced user supplies judgment where the work
+is new. Every point where the user had to step in is logged.
+
+It is built to test one claim: how far can simulation science be automated?
+The [design doc](https://claude.ai/artifact/XXXKh76eufzP1Jidwmq1mo) has the full
+argument.
+
+## The loop
+
+```mermaid
+flowchart LR
+  pose --> conjecture --> confront --> test
+  test -- fails --> discover --> confront
+  test -- holds --> compress --> test
+  compress --> warrant --> query --> revise --> pose
+```
+
+| Step | Writes | Gate before moving on |
+| --- | --- | --- |
+| `init` | repo skeleton, `domain.yaml` | Domain interview complete |
+| `pose` | `claim.yaml` | Question, claim, intended use and conditions named |
+| `conjecture` | `model/partitions.yaml`, lineage root | `stochadex --check`; twice-run harness; a role and hypothesis per partition; observables mapped; input licences |
+| `confront` | `ledger/beliefs.jsonl` | Posterior converged; weak identifiability flagged |
+| `test` | `tests.yaml` verdicts | Every structural partition passed; a backtest ran |
+| `discover` | a variant in `model/lineage.yaml` | Beats its parent on held-out prediction; ladder rule for learned partitions |
+| `compress` | a smaller variant | Claim metric unchanged within tolerance; generalisation |
+| `warrant` | `ledger/warrants.jsonl` | Current variant tested and passed; limits stated |
+| `query` | `queries/<id>.yaml` | The warrant reaches the mode's rung |
+| `revise` | `revise.yaml` | Monitors watch partitions and name their action |
+
+The supporting commands are `run`, `graph`, `plot`, `status`, `explain`, `intervene`
+and `doctor`. Every command is also an MCP tool with the same arguments, so a
+project driven through chat leaves the same trail as one driven by hand.
+
+## Install
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/umbralcalc/robert/main/install.sh | sh
+```
+
+The installer puts the `robert-ai` package in an isolated tool environment, using uv
+if you have it, then pipx, and otherwise it installs uv first. It then runs
+`robert setup`, which:
+
+- downloads the stochadex release robert locks into `~/.robert/stochadex/<version>/`
+  and checks it against the SHA-256 recorded in `robert/stochadex.json`;
+- installs the Claude Code plugin (both skills and the MCP server) when `claude` is
+  on PATH, and adds the MCP server to `~/.cursor/mcp.json` when Cursor is installed.
+
+Run `robert doctor` at any time to check the toolchain. Re-running `robert setup`
+repairs or upgrades the install, and `robert setup --accelerated` swaps in the BLAS +
+DuckDB build of stochadex. Set `ROBERT_VERSION=0.2.0` to install a specific release,
+or `ROBERT_NO_AGENTS=1` to skip agent registration.
+
+Until the first PyPI release is out, install from GitHub instead:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/umbralcalc/robert/main/install.sh | ROBERT_SOURCE=git+https://github.com/umbralcalc/robert sh
+```
+
+### How robert depends on stochadex
+
+robert never bundles stochadex. It locks one release and declares the range it
+supports, in [robert/stochadex.json](robert/stochadex.json):
+
+| Rule | Effect |
+| --- | --- |
+| Resolution order | `STOCHADEX_BIN`, then the managed install of the wanted version, then PATH |
+| Version range | Any binary outside the supported range is refused, with the fix |
+| Checksums | A download that doesn't match the lock (or the release's `SHA256SUMS`) is never installed |
+| Project pin | Each project records the stochadex version it was created with; `doctor` flags drift |
+| Updates | A weekly workflow moves the lock to the newest release, tests it, and opens a PR |
+
+robert needs stochadex v0.24 or later: it renders the partition graph with
+`stochadex graph`, and checks its skills against `stochadex catalogue`, the JSON list
+of everything a build can run.
+
+## Connect an agent
+
+`robert setup` already registers Claude Code and Cursor. To do it by hand:
+
+| Agent | How |
+| --- | --- |
+| Claude Code | `claude plugin marketplace add umbralcalc/robert`, then `claude plugin install robert@robert`. This adds both skills and the MCP server. |
+| Cursor | Add `adapters/cursor/mcp.json` to `~/.cursor/mcp.json`, and copy `adapters/cursor/rules/` into a project's `.cursor/rules/`. |
+| Anything else | Point it at `adapters/agents/AGENTS.md` and run `robert mcp` as a stdio MCP server. |
+
+Every project that `robert init` creates also contains its own `.mcp.json`,
+`.cursor/mcp.json`, `AGENTS.md` and `.devcontainer/`, so any agent opened in it
+finds the tools.
+
+The skills in `skills/` are the single source of method content. After you edit
+one, run `robert adapters` to regenerate the Cursor rules, `AGENTS.md` and the
+plugin manifest. CI fails if they drift.
+
+## In the cloud
+
+| Route | How |
+| --- | --- |
+| Image | `ghcr.io/umbralcalc/robert:<version>` contains robert, the locked stochadex (accelerated build), Python and git. Run `docker run --rm -it -v "$PWD:/work" ghcr.io/umbralcalc/robert status`. |
+| Dev container / Codespaces | Projects from `robert init` open in the robert image. For any other repo, add the feature `"ghcr.io/umbralcalc/robert/robert:0": {}` to its `devcontainer.json`. |
+| Cloud coding agents | Use the one-line installer with `ROBERT_NO_AGENTS=1` as the environment's setup script, or start the agent in the robert image. |
+| MCP over the network | `robert mcp --http` serves streamable HTTP at `http://127.0.0.1:8765/mcp`. Binding to anything else requires a bearer token: `ROBERT_MCP_TOKEN=... robert mcp --http --host 0.0.0.0`. |
+
+## Releases
+
+Versions follow SemVer, pre-1.0, so a minor bump may break the CLI, the tool
+schemas or the file contracts. [CHANGELOG.md](CHANGELOG.md) has the policy.
+`robert/__init__.py` holds the only version number; the package, the plugin
+manifests and every project's recorded skills version all read it.
+
+To release, run the **Prepare release PR** workflow with the new version. It turns
+the `[Unreleased]` changelog section into the release and bumps the version. Review
+and merge that PR. `tag-release.yml` then tags the merge commit, and `release.yml`
+tests and publishes:
+
+- the `robert-ai` package to PyPI, through a trusted publisher;
+- the GitHub Release, with the changelog section as its notes;
+- the image to GHCR, for amd64 and arm64;
+- the Dev Container Feature.
+
+## Worked example
+
+```bash
+examples/logistic-growth/walkthrough.sh /tmp/logistic-demo
+```
+
+This runs the whole loop against real stochadex runs:
+
+1. Unconstrained growth fails its backtest and its density-dependence process check.
+2. The user's redirect is logged.
+3. `discover` adds a carrying capacity, which beats its parent on held-out years.
+4. `compress` removes a seasonal nuisance without moving the claim.
+5. A forecast is warranted and queried.
+6. A `decide` query is refused, because no model-part swap was tested on the action path.
+
+## Design principles
+
+- **One hard boundary.** Determinism is enforced at the stochadex run. The agent
+  is free in everything it writes above it, and restriction comes from checks,
+  not templates.
+- **Build on stochadex, not beside it.** `model/sim.yaml` is a pure stochadex
+  config. Validation, I/O manifests, provenance and the partition graph all come
+  from the stochadex CLI. robert adds only the claim, the per-partition roles and
+  hypotheses, the lineage, the tests, the ledger and the gates.
+- **The agent never produces a number.** Every figure traces back to a config, a
+  seed and a provenance sidecar.
+- **Mechanism first.** Learned (ONNX) components must earn their place through
+  `discover`, after mechanistic variants have failed and the user has approved.
+- **Gates live in the MCP server, never in agent hooks**, so every agent is held
+  to the same standard.
+
+## Repository layout
+
+| Path | What |
+| --- | --- |
+| `robert/` | The method CLI and MCP server (`tools.py` is the single registry) |
+| `robert/stochadex.json`, `robert/deps.py` | The stochadex lock, resolver and installer |
+| `install.sh`, `Dockerfile`, `devcontainer-features/` | Install routes: one line, image, dev container |
+| `skills/simulation-scientist/` | The method skill |
+| `skills/stochadex-model/` | The model-authoring skill, moved from stochadex v0.23.0 |
+| `adapters/`, `.claude-plugin/` | Generated per-agent adapters |
+| `examples/logistic-growth/` | The end-to-end worked example |
+| `tests/` | Unit tests, plus the whole loop against a real stochadex |
+
+## Testing
+
+```bash
+pip install -e '.[dev]'
+```
+
+```bash
+robert setup --no-agents
+```
+
+```bash
+pytest
+```
+
+The loop and recipe tests skip when no supported stochadex is installed.

robert_ai-0.1.0/README.md

@@ -0,0 +1,187 @@
+# robert
+
+The AI scientific research developer powered by simulations.
+
+robert is the method layer of an AI simulation scientist. It packages what a
+simulation scientist does as tools that any coding agent can call, and it leaves the
+simulation itself to [stochadex](https://github.com/umbralcalc/stochadex). The agent
+does the implementation, and the experienced user supplies judgment where the work
+is new. Every point where the user had to step in is logged.
+
+It is built to test one claim: how far can simulation science be automated?
+The [design doc](https://claude.ai/artifact/XXXKh76eufzP1Jidwmq1mo) has the full
+argument.
+
+## The loop
+
+```mermaid
+flowchart LR
+  pose --> conjecture --> confront --> test
+  test -- fails --> discover --> confront
+  test -- holds --> compress --> test
+  compress --> warrant --> query --> revise --> pose
+```
+
+| Step | Writes | Gate before moving on |
+| --- | --- | --- |
+| `init` | repo skeleton, `domain.yaml` | Domain interview complete |
+| `pose` | `claim.yaml` | Question, claim, intended use and conditions named |
+| `conjecture` | `model/partitions.yaml`, lineage root | `stochadex --check`; twice-run harness; a role and hypothesis per partition; observables mapped; input licences |
+| `confront` | `ledger/beliefs.jsonl` | Posterior converged; weak identifiability flagged |
+| `test` | `tests.yaml` verdicts | Every structural partition passed; a backtest ran |
+| `discover` | a variant in `model/lineage.yaml` | Beats its parent on held-out prediction; ladder rule for learned partitions |
+| `compress` | a smaller variant | Claim metric unchanged within tolerance; generalisation |
+| `warrant` | `ledger/warrants.jsonl` | Current variant tested and passed; limits stated |
+| `query` | `queries/<id>.yaml` | The warrant reaches the mode's rung |
+| `revise` | `revise.yaml` | Monitors watch partitions and name their action |
+
+The supporting commands are `run`, `graph`, `plot`, `status`, `explain`, `intervene`
+and `doctor`. Every command is also an MCP tool with the same arguments, so a
+project driven through chat leaves the same trail as one driven by hand.
+
+## Install
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/umbralcalc/robert/main/install.sh | sh
+```
+
+The installer puts the `robert-ai` package in an isolated tool environment, using uv
+if you have it, then pipx, and otherwise it installs uv first. It then runs
+`robert setup`, which:
+
+- downloads the stochadex release robert locks into `~/.robert/stochadex/<version>/`
+  and checks it against the SHA-256 recorded in `robert/stochadex.json`;
+- installs the Claude Code plugin (both skills and the MCP server) when `claude` is
+  on PATH, and adds the MCP server to `~/.cursor/mcp.json` when Cursor is installed.
+
+Run `robert doctor` at any time to check the toolchain. Re-running `robert setup`
+repairs or upgrades the install, and `robert setup --accelerated` swaps in the BLAS +
+DuckDB build of stochadex. Set `ROBERT_VERSION=0.2.0` to install a specific release,
+or `ROBERT_NO_AGENTS=1` to skip agent registration.
+
+Until the first PyPI release is out, install from GitHub instead:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/umbralcalc/robert/main/install.sh | ROBERT_SOURCE=git+https://github.com/umbralcalc/robert sh
+```
+
+### How robert depends on stochadex
+
+robert never bundles stochadex. It locks one release and declares the range it
+supports, in [robert/stochadex.json](robert/stochadex.json):
+
+| Rule | Effect |
+| --- | --- |
+| Resolution order | `STOCHADEX_BIN`, then the managed install of the wanted version, then PATH |
+| Version range | Any binary outside the supported range is refused, with the fix |
+| Checksums | A download that doesn't match the lock (or the release's `SHA256SUMS`) is never installed |
+| Project pin | Each project records the stochadex version it was created with; `doctor` flags drift |
+| Updates | A weekly workflow moves the lock to the newest release, tests it, and opens a PR |
+
+robert needs stochadex v0.24 or later: it renders the partition graph with
+`stochadex graph`, and checks its skills against `stochadex catalogue`, the JSON list
+of everything a build can run.
+
+## Connect an agent
+
+`robert setup` already registers Claude Code and Cursor. To do it by hand:
+
+| Agent | How |
+| --- | --- |
+| Claude Code | `claude plugin marketplace add umbralcalc/robert`, then `claude plugin install robert@robert`. This adds both skills and the MCP server. |
+| Cursor | Add `adapters/cursor/mcp.json` to `~/.cursor/mcp.json`, and copy `adapters/cursor/rules/` into a project's `.cursor/rules/`. |
+| Anything else | Point it at `adapters/agents/AGENTS.md` and run `robert mcp` as a stdio MCP server. |
+
+Every project that `robert init` creates also contains its own `.mcp.json`,
+`.cursor/mcp.json`, `AGENTS.md` and `.devcontainer/`, so any agent opened in it
+finds the tools.
+
+The skills in `skills/` are the single source of method content. After you edit
+one, run `robert adapters` to regenerate the Cursor rules, `AGENTS.md` and the
+plugin manifest. CI fails if they drift.
+
+## In the cloud
+
+| Route | How |
+| --- | --- |
+| Image | `ghcr.io/umbralcalc/robert:<version>` contains robert, the locked stochadex (accelerated build), Python and git. Run `docker run --rm -it -v "$PWD:/work" ghcr.io/umbralcalc/robert status`. |
+| Dev container / Codespaces | Projects from `robert init` open in the robert image. For any other repo, add the feature `"ghcr.io/umbralcalc/robert/robert:0": {}` to its `devcontainer.json`. |
+| Cloud coding agents | Use the one-line installer with `ROBERT_NO_AGENTS=1` as the environment's setup script, or start the agent in the robert image. |
+| MCP over the network | `robert mcp --http` serves streamable HTTP at `http://127.0.0.1:8765/mcp`. Binding to anything else requires a bearer token: `ROBERT_MCP_TOKEN=... robert mcp --http --host 0.0.0.0`. |
+
+## Releases
+
+Versions follow SemVer, pre-1.0, so a minor bump may break the CLI, the tool
+schemas or the file contracts. [CHANGELOG.md](CHANGELOG.md) has the policy.
+`robert/__init__.py` holds the only version number; the package, the plugin
+manifests and every project's recorded skills version all read it.
+
+To release, run the **Prepare release PR** workflow with the new version. It turns
+the `[Unreleased]` changelog section into the release and bumps the version. Review
+and merge that PR. `tag-release.yml` then tags the merge commit, and `release.yml`
+tests and publishes:
+
+- the `robert-ai` package to PyPI, through a trusted publisher;
+- the GitHub Release, with the changelog section as its notes;
+- the image to GHCR, for amd64 and arm64;
+- the Dev Container Feature.
+
+## Worked example
+
+```bash
+examples/logistic-growth/walkthrough.sh /tmp/logistic-demo
+```
+
+This runs the whole loop against real stochadex runs:
+
+1. Unconstrained growth fails its backtest and its density-dependence process check.
+2. The user's redirect is logged.
+3. `discover` adds a carrying capacity, which beats its parent on held-out years.
+4. `compress` removes a seasonal nuisance without moving the claim.
+5. A forecast is warranted and queried.
+6. A `decide` query is refused, because no model-part swap was tested on the action path.
+
+## Design principles
+
+- **One hard boundary.** Determinism is enforced at the stochadex run. The agent
+  is free in everything it writes above it, and restriction comes from checks,
+  not templates.
+- **Build on stochadex, not beside it.** `model/sim.yaml` is a pure stochadex
+  config. Validation, I/O manifests, provenance and the partition graph all come
+  from the stochadex CLI. robert adds only the claim, the per-partition roles and
+  hypotheses, the lineage, the tests, the ledger and the gates.
+- **The agent never produces a number.** Every figure traces back to a config, a
+  seed and a provenance sidecar.
+- **Mechanism first.** Learned (ONNX) components must earn their place through
+  `discover`, after mechanistic variants have failed and the user has approved.
+- **Gates live in the MCP server, never in agent hooks**, so every agent is held
+  to the same standard.
+
+## Repository layout
+
+| Path | What |
+| --- | --- |
+| `robert/` | The method CLI and MCP server (`tools.py` is the single registry) |
+| `robert/stochadex.json`, `robert/deps.py` | The stochadex lock, resolver and installer |
+| `install.sh`, `Dockerfile`, `devcontainer-features/` | Install routes: one line, image, dev container |
+| `skills/simulation-scientist/` | The method skill |
+| `skills/stochadex-model/` | The model-authoring skill, moved from stochadex v0.23.0 |
+| `adapters/`, `.claude-plugin/` | Generated per-agent adapters |
+| `examples/logistic-growth/` | The end-to-end worked example |
+| `tests/` | Unit tests, plus the whole loop against a real stochadex |
+
+## Testing
+
+```bash
+pip install -e '.[dev]'
+```
+
+```bash
+robert setup --no-agents
+```
+
+```bash
+pytest
+```
+
+The loop and recipe tests skip when no supported stochadex is installed.

robert_ai-0.1.0/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["setuptools>=69"]
+build-backend = "setuptools.build_meta"
+
+[project]
+# `robert` is taken on PyPI; the command is still `robert`.
+name = "robert-ai"
+dynamic = ["version"]
+description = "The AI simulation scientist: a method CLI and MCP server that drives stochadex projects through the discovery-and-warrant loop."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.11"
+authors = [{ name = "umbralcalc", email = "umbralcalc@gmail.com" }]
+keywords = ["simulation", "stochadex", "scientific-method", "mcp", "agents"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Topic :: Scientific/Engineering",
+    "Environment :: Console",
+]
+dependencies = [
+    "pyyaml>=6",
+    "mcp>=2.3,<3",
+    "uvicorn>=0.30",
+    "httpx>=0.27",
+]
+
+[project.optional-dependencies]
+arrow = ["pyarrow>=15"]
+dev = ["pytest>=8", "build>=1.2"]
+
+[project.urls]
+Homepage = "https://github.com/umbralcalc/robert"
+Changelog = "https://github.com/umbralcalc/robert/blob/main/CHANGELOG.md"
+
+[project.scripts]
+robert = "robert.cli:main"
+
+[tool.setuptools.dynamic]
+version = { attr = "robert.__version__" }
+
+[tool.setuptools.packages.find]
+include = ["robert*"]
+
+[tool.setuptools.package-data]
+robert = ["stochadex.json"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

robert_ai-0.1.0/robert/__init__.py

@@ -0,0 +1,13 @@
+"""robert: the AI simulation scientist.
+
+A thin method layer over the stochadex engine. It owns the method files and the
+gates of the discovery-and-warrant loop, and delegates every simulation action to
+the stochadex binary. The same tool registry drives the CLI and the MCP server, so
+a chat-driven project and a hand-driven one leave the same trail in the repo.
+
+The version below is the single source: the package metadata, the plugin manifest
+and the skills version every project records all read it. The stochadex version
+robert supports lives in `stochadex.json`.
+"""
+
+__version__ = "0.1.0"

robert_ai-0.1.0/robert/adapters.py

@@ -0,0 +1,97 @@
+"""Render per-agent adapters from the one source of method content in skills/.
+
+Method content has one source. These thin adapters only change its packaging: a
+Claude Code plugin, Cursor rules plus MCP config, and an AGENTS.md for anything
+else. Correctness never lives here; it lives in the MCP tools every adapter calls.
+`tests/test_adapters.py` fails when a committed adapter drifts from its source.
+"""
+
+from __future__ import annotations
+
+import json
+import re
+from pathlib import Path
+
+from . import __version__
+from .scaffold import MCP_SERVER
+from .tools import TOOLS
+
+REPO = Path(__file__).resolve().parents[1]
+AUTHOR = {"name": "umbralcalc", "email": "umbralcalc@gmail.com",
+          "url": "https://github.com/umbralcalc/robert"}
+DESCRIPTION = ("The AI simulation scientist: drives stochadex projects through the "
+               "discovery-and-warrant loop, with every gate enforced by the robert MCP server.")
+HEADER = "<!-- Generated by `robert adapters` from skills/. Do not edit by hand. -->\n"
+
+
+def skills(repo: Path = REPO) -> list[tuple[dict[str, str], str]]:
+    out = []
+    for path in sorted((repo / "skills").glob("*/SKILL.md")):
+        _, front, body = path.read_text().split("---", 2)
+        # Skill frontmatter is `key: value` lines, not strict YAML (descriptions
+        # may contain `{type: ...}`), so split each line at its first colon.
+        meta = dict(line.split(":", 1) for line in front.strip().splitlines())
+        out.append(({k.strip(): v.strip() for k, v in meta.items()}, body.strip() + "\n"))
+    return out
+
+
+def _nest_headings(body: str) -> str:
+    """Push a skill's headings two levels down, leaving code blocks alone."""
+    lines, fenced = [], False
+    for line in body.splitlines(keepends=True):
+        if line.startswith("```"):
+            fenced = not fenced
+        elif not fenced and re.match(r"#+ ", line):
+            line = "##" + line
+        lines.append(line)
+    return "".join(lines)
+
+
+def outputs(repo: Path = REPO) -> dict[str, str]:
+    """Every adapter file, keyed by path relative to the repo."""
+    files: dict[str, str] = {}
+    files[".claude-plugin/plugin.json"] = json.dumps({
+        "name": "robert",
+        "description": DESCRIPTION,
+        "version": __version__,
+        "author": AUTHOR,
+        "repository": AUTHOR["url"],
+        "license": "MIT",
+        "keywords": ["simulation", "stochadex", "scientific-method", "agent-skill"],
+        "skills": "./skills/",
+        "mcpServers": {"robert": MCP_SERVER},
+    }, indent=2) + "\n"
+    files[".claude-plugin/marketplace.json"] = json.dumps({
+        "name": "robert",
+        "owner": AUTHOR,
+        "metadata": {"description": DESCRIPTION, "version": __version__},
+        "plugins": [{"name": "robert", "source": ".", "description": DESCRIPTION,
+                     "category": "modeling",
+                     "keywords": ["simulation", "stochadex", "scientific-method"]}],
+    }, indent=2) + "\n"
+    files["adapters/cursor/mcp.json"] = json.dumps(
+        {"mcpServers": {"robert": MCP_SERVER}}, indent=2) + "\n"
+
+    agents = [HEADER, "# robert: the simulation scientist\n\n",
+              "Connect the `robert` MCP server (`robert mcp`, stdio) and follow the "
+              "skills below. The tools enforce the gates; these notes explain them.\n\n",
+              "## Tools\n\n"]
+    agents += [f"- `{t.name}`: {t.description}\n" for t in TOOLS]
+    for front, body in skills(repo):
+        files[f"adapters/cursor/rules/{front['name']}.mdc"] = (
+            f"---\ndescription: {json.dumps(front['description'], ensure_ascii=False)}\n"
+            "alwaysApply: false\n---\n"
+            + HEADER + body)
+        agents += [f"\n## Skill: {front['name']}\n\n", _nest_headings(body)]
+    files["adapters/agents/AGENTS.md"] = "".join(agents)
+    return files
+
+
+def render(repo: Path = REPO) -> list[str]:
+    written = []
+    for rel, text in outputs(repo).items():
+        p = repo / rel
+        p.parent.mkdir(parents=True, exist_ok=True)
+        p.write_text(text)
+        written.append(rel)
+    return written