Skip to content

feat: add active-view image import script - #2

Merged
Brutich merged 1 commit into
mainfrom
codex/add-import-image-to-active-view
Aug 26, 2026
Merged

Brutich merged 1 commit into
mainfrom
codex/add-import-image-to-active-view

Conversation

@Brutich

@Brutich Brutich commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

What changed

  • add an IronPython script that imports a raster image into the active Revit view;
  • optionally copy the source image beside the saved RVT without overwriting existing files;
  • center and proportionally scale the image from the current visible view extent;
  • add paired usage, input, output, safety, and manual-test documentation;
  • register the script in catalog.json and the README catalog;
  • add a concise AGENTS.md entry point for future agent-authored script PRs.

Scope and exclusions

This PR adds one reusable documentation script and agent contribution guidance. It does not change the catalog schema, BIMO runtime, approval model, or existing script paths.

User and agent impact

Users can provide a local JPG/PNG path through BIMO Run Python or MCP and receive structured IDs, stored path, copy status, and final dimensions. Agents now have repository-local instructions requiring branches, draft PRs, paired documentation, catalog registration, validation, and honest Revit test reporting.

Validation performed

  • python tools/validate_catalog.py — passed for 5 scripts;
  • git diff --check — passed;
  • python -m py_compile documentation/import_image_to_active_view.py tools/validate_catalog.py — passed;
  • the underlying Revit 2024 API flow (create ImageType, place ImageInstance, scale proportionally, and reload from a copy beside the RVT) was exercised successfully through BIMO MCP.

Risks and remaining manual checks

  • The exact combined repository script has not yet been run end to end, so revit.tested remains empty.
  • Copying the image is an external file-system effect and cannot be rolled back by the Revit transaction; the documentation calls this out.
  • The catalog's current risk enum describes model risk only. A future schema revision may need explicit machine-readable external side-effect metadata.

Documentation impact

Adds paired script documentation, updates README discovery, and adds AGENTS.md as the agent workflow entry point.

@Brutich
Brutich force-pushed the codex/add-import-image-to-active-view branch from c52dc08 to 85caca1 Compare August 26, 2026 20:18
@Brutich
Brutich marked this pull request as ready for review August 26, 2026 20:20
@Brutich
Brutich merged commit 9f9c58d into main Aug 26, 2026
1 check passed
@Brutich
Brutich deleted the codex/add-import-image-to-active-view branch August 26, 2026 20:20
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