Skip to content

feat: add Toposolid script catalog - #1

Merged
Brutich merged 1 commit into
mainfrom
agent/add-toposolid-script-and-catalog
Aug 3, 2026
Merged

Brutich merged 1 commit into
mainfrom
agent/add-toposolid-script-and-catalog

Conversation

@Brutich

@Brutich Brutich commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

What changed

  • Added an IronPython script that creates a point-based Toposolid from selected model curves.
  • Added paired usage documentation, positional IN definitions, safety limits, and result behavior.
  • Added a machine-readable catalog.json covering all four repository scripts and a JSON Schema for agent discovery.
  • Added a dependency-free catalog and syntax validator with GitHub Actions CI.
  • Reworked the README around real repository contents, BIMO Run Python usage, MCP-oriented discovery, and safety.
  • Added contribution guidance, a pull request template, and Python ignore rules.

Why

This repository is intended to be a maintained library of useful BIMO Run Python scripts and, later, a discoverable source for AI agents executing approved scripts through BIMO MCP. The previous README described folders and examples that were not present and the repository had no machine-readable contract or validation path.

Scope and intentional exclusions

  • Existing script files and paths were not moved or rewritten, so saved BIMO presets remain valid.
  • This PR does not change BIMO RevitApp, BIMO MCP, or the installed local preset.
  • The new script targets Revit 2024+ because it uses Toposolid.
  • No claim of runtime compatibility is made until the script is manually tested in Revit.

User and developer impact

Users can point a BIMO Run Python preset at modeling/create_toposolid_from_model_lines.py, select model curves with real Z elevations, and optionally configure sampling step, XY tolerance, Toposolid type, and level through IN.

Contributors and agents can inspect catalog.json for engine, Revit version, risk, selection, inputs, output, and tags. CI rejects missing catalog entries, paths, documentation, required metadata, duplicate IDs, and CPython syntax errors.

Validation performed

  • python tools/validate_catalog.py — passed for 4 scripts.
  • python -m json.tool catalog.json NUL — passed.
  • python -m json.tool schemas/catalog.schema.json NUL — passed.
  • git diff --cached --check — passed before commit.

Risks and remaining checks

  • Manual Revit validation was not performed in this environment.
  • The Toposolid script writes to the active model and should first be tested on a copy.
  • The script uses point-based Revit triangulation rather than a closed sketch boundary.
  • Sampling is capped at 50,000 points to avoid accidental excessive geometry.
  • Revit 2024, 2025, and 2026 should each be smoke-tested before their versions are added to the catalog's tested array.

Documentation impact

README, contribution guidance, script documentation, catalog schema, and pull request guidance are included in this PR.

@Brutich
Brutich marked this pull request as ready for review August 3, 2026 14:06
@Brutich
Brutich merged commit 2bc87f1 into main Aug 3, 2026
1 check passed
@Brutich
Brutich deleted the agent/add-toposolid-script-and-catalog branch August 3, 2026 14:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant