GitHub
07/20/2026, 5:54 PM--refresh-catalog to meltano invoke.
This allows:
meltano invoke --refresh-catalog <tap>
meltano invoke --refresh-catalog --dump catalog <tap>
to ignore any existing cached catalog and run discovery before invoking a Singer tap in sync mode or dumping the catalog.
Implementation
This avoids introducing an ELTContext into meltano invoke.
Instead, it follows the existing SelectService approach and sets:
invoker.settings_service.config_override["_use_cached_catalog"] = False
before invoker.prepared(session) runs.
Tests
Added focused tests for:
• CLI wiring of --refresh-catalog into _invoke
• setting _use_cached_catalog=False before invoker.prepared(session)
• existing invoke trigger behaviour
Local checks run:
uv run pytest tests/meltano/cli/test_invoke.py:TestCliInvoke:test_invoke_refresh_catalog_option -q
uv run pytest tests/meltano/cli/test_invoke.py:TestCliInvoke:test_invoke_refresh_catalog_cache_override -q
uv run pytest tests/meltano/cli/test_invoke.py:TestCliInvoke:test_invoke_triggers -q
uv run --with ruff ruff check src/meltano/cli/invoke.py tests/meltano/cli/test_invoke.py
uv run --with ruff ruff format --check src/meltano/cli/invoke.py tests/meltano/cli/test_invoke.py
git diff --check
Docs updated in the CLI reference.
Summary by Sourcery
Introduce a refresh-catalog option to meltano invoke that allows users to invalidate cached catalogs and rerun discovery before tap execution or catalog dumping, with corresponding CLI, internal handling, tests, and documentation updates.
New Features:
• Add a --refresh-catalog flag to meltano invoke to force catalog discovery before invoking Singer taps or dumping catalogs.
Enhancements:
• Wire the new refresh-catalog option through the CLI to the internal _invoke helper, updating invoker configuration to bypass cached catalogs when requested.
Documentation:
• Update CLI reference documentation to describe the new --refresh-catalog usage and its interaction with catalog dumping.
Tests:
• Add CLI and async invoke tests to validate refresh-catalog flag wiring, catalog cache override behavior, and existing invoke trigger behavior remain intact.
meltano/meltanoGitHub
07/23/2026, 2:45 PM