Skip to content

Migration mise - #399

Merged
thorrester merged 7 commits into
mainfrom
migration-mise
May 14, 2026
Merged

thorrester merged 7 commits into
mainfrom
migration-mise

Conversation

@thorrester

@thorrester thorrester commented May 11, 2026 •

Copy link
Copy Markdown
Member

Pull Request

Short Summary

Replaces the Makefile/.tool-versions dev toolchain with mise. All task invocations — in CI, docs, and contributor-facing docs — now go through mise run <task> instead of make <target>. The mise.toml at the repo root is the new single source of truth for pinned tools and task definitions.

Context

The project previously split dev tooling across a root Makefile, a py-opsml/makefile, and a .tool-versions file (asdf-compatible). This worked but had a few rough edges: tasks were spread across two makefiles, working-directory had to be set per-step in CI, and tool versioning lived in a separate file from task definitions.

mise.toml consolidates all of this. Tools (cmake, protoc, uv, pnpm, node) are pinned there alongside every dev task. Python and Rust are explicitly excluded from mise's tool management (disable_tools = ["python", "gitleaks"]) so they don't shadow the matrix versions set by setup-python and rustup in CI — that's a non-obvious footgun that was explicitly worked around.

CI workflows — Every workflow (lints-test.yml, build-assets.yml, storage-integration-*.yml, etc.) now has a jdx/mise-action@v3.4.1 step added before any task invocation, with install: true and cache: true. The working-directory: ./py-opsml and working-directory: ./crates hacks are gone. Python matrix jobs now pass UV_PYTHON: ${{ matrix.python-version }} as an env var instead of changing directory.

Python lints — mypy is replaced by ty in the lint commands (py:lints, py:lints-ci). This shows up in both the mise.toml task definitions and the updated AGENTS.md command reference.

Docs and contributing — AGENTS.md, CONTRIBUTING.md, and py-opsml/docs/contributing.md are updated to replace all make invocations with mise run equivalents.

File Change
mise.toml New 542-line file — tool pins + all task definitions
.tool-versions Deleted — superseded by mise.toml
.github/workflows/lints-test.yml Add mise-action, replace make targets, add UV_PYTHON env per step
.github/workflows/build-assets.yml Add mise-action, replace UI build targets
.github/workflows/build-assets-dev.yml Same as above
.github/workflows/storage-integration-client.yml Add mise-action, remove working-directory: ./crates
.github/workflows/storage-integration-server.yml Same as above
.github/workflows/release-candidate.yml Add mise-action, replace make targets
.github/workflows/examples.yml Add mise-action, drop working-directory: ./py-opsml
.github/workflows/publish-docs.yml Add mise-action, replace doc build targets
AGENTS.md Rewrite command reference section for mise; note mypy → ty
CONTRIBUTING.md Replace all make invocations with mise equivalents
py-opsml/makefile Retained but stripped down — most targets now delegated to mise
py-opsml/pyproject.toml Minor dependency / tooling updates
.gitignore /dev → .dev/ (scoped to dotfile convention)

Is this a Breaking Change?

No. All public interfaces, card APIs, Python bindings, HTTP contracts, and database schemas are unchanged. Contributors will need mise installed (curl https://mise.run | sh && mise install) — make targets are either removed or thin wrappers, so anyone running the old targets in CI or locally will need to update their workflow.

@github-actions

github-actions Bot commented May 11, 2026 •

Copy link
Copy Markdown

Dependency Review

✅ No vulnerabilities or license issues found.

Scanned Manifest Files

.github/workflows/publish-docs.yml
  • jdx/mise-action@3.4.1
.github/workflows/storage-integration-server.yml
  • jdx/mise-action@3.4.1
py-opsml/uv.lock
  • ty@0.0.35
  • librt@0.7.8
  • mypy@1.19.1

@thorrester
thorrester marked this pull request as ready for review May 14, 2026 19:07
@thorrester
thorrester merged commit fd9731e into main May 14, 2026
29 checks passed
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.

2 participants