MPT-16666: initial command structure and entrypoint

[svazquezco]

Summary by CodeRabbit

• New Features
  • Added a command-line interface with a migrate command, enabling users to execute migration operations directly from the terminal
  • Included built-in help documentation for command guidance

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

📝 Walkthrough

Walkthrough

The PR adds a Typer-based CLI module with a migrate command, updates project configuration with dependencies and build system setup, removes an obsolete dummy test, and introduces CLI tests using CliRunner.

Changes

Cohort / File(s)	Summary
CLI Implementation mpt_tool/cli.py	New module with Typer app initialization, root callback providing help text, migrate command printing "Hello World!", and main entry point function
Project Configuration pyproject.toml	Add typer>=0.9.0 dependency, mpt-tool CLI script entry point, build system configuration with hatchling backend, hatch build include patterns, and mypy test exclusion
Tests tests/dummy_test.py tests/test_cli.py	Remove trivial isinstance test; add new CLI test module with CliRunner fixture and tests for migrate command execution and help output validation

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Pre-merge checks

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The pull request title includes the required JIRA ticket number MPT-16666 with the correct prefix and clearly summarizes the main changes: adding initial command structure and entrypoint.

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[github-actions]

✅ Found Jira issue key in the title: MPT-16666

Generated by 🚫 dangerJS against dbe0983

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
88.9% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[svazquezco]

@coderabbitai review

[coderabbitai]

✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

[coderabbitai]

Actionable comments posted: 1

🧹 Nitpick comments (1)

mpt_tool/cli.py (1)

6-8: Consider removing the redundant callback.

The callback() function duplicates the help text already provided in the Typer() initialization on line 3. Since it serves no additional functional purpose, it can be removed to reduce redundancy.

🔎 Proposed refactor

-@app.callback()
-def callback() -> None:
-    """MPT CLI - Migration tool for extensions."""
-
-
 @app.command()
 def migrate() -> None:
     """Run the migration process."""

📜 Review details

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between e82a172 and dbe0983.

⛔ Files ignored due to path filters (1)

• uv.lock is excluded by !**/*.lock

📒 Files selected for processing (4)

• mpt_tool/cli.py
• pyproject.toml
• tests/dummy_test.py
• tests/test_cli.py

💤 Files with no reviewable changes (1)

• tests/dummy_test.py

🔇 Additional comments (9)

pyproject.toml (3)

35-42: LGTM: Build system configuration.

The hatchling build system configuration is properly set up with appropriate package inclusion patterns.

---

183-183: LGTM: Mypy test exclusion.

Excluding tests from mypy type checking is a reasonable configuration choice that aligns with the per-file-ignores already defined for ruff.

---

10-12: The constraint typer>=0.9.0 is permissive, but this is standard practice in Python packaging and allows the latest stable version (0.21.0). No security issues were found in the latest releases.

tests/test_cli.py (3)

1-9: LGTM: Test setup is clean.

The imports and fixture setup are correct. The CliRunner fixture provides good test isolation.

---

12-16: LGTM: Migrate command test is well-structured.

The test correctly validates the command's exit code and output. The assertion on the specific string "Hello World!" is appropriate for this initial implementation.

---

19-24: LGTM: Help text validation is comprehensive.

The test correctly verifies that the help output includes both the CLI description and the available commands.

mpt_tool/cli.py (3)

1-3: LGTM: Typer app initialization.

The Typer app is correctly configured with help text and no_args_is_help=True, which provides a good user experience.

---

11-14: LGTM: Migrate command placeholder.

The migrate command is appropriately implemented as a placeholder for this initial PR. The docstring is clear and typer.echo() is the correct way to output text.

---

17-19: LGTM: Entry point is correctly implemented.

The main() function correctly serves as the entry point for the CLI application.

[coderabbitai]

⚠️ Potential issue | 🔴 Critical

Critical: Incorrect entry point path.

The script entry point references mpt_tool.app:main, but based on the test imports (from mpt_tool.cli import app) and the actual CLI module provided (mpt_tool/cli.py), the correct path should be mpt_tool.cli:main. This will cause the mpt-tool command to fail at runtime.

🔎 Proposed fix

 [project.scripts]
-mpt-tool = "mpt_tool.app:main"
+mpt-tool = "mpt_tool.cli:main"

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change

	[project.scripts]
	mpt-tool = "mpt_tool.app:main"
	[project.scripts]
	mpt-tool = "mpt_tool.cli:main"

🤖 Prompt for AI Agents

In pyproject.toml around lines 14 to 15, the console script entry incorrectly
points to mpt_tool.app:main whereas the actual CLI module is mpt_tool/cli.py and
tests import from mpt_tool.cli; update the entry to reference mpt_tool.cli:main
so the mpt-tool command resolves the correct module and function at runtime.