gitpr-cli 0.0.28__py3-none-any.whl → 0.0.29__py3-none-any.whl

{gitpr_cli-0.0.28.dist-info → gitpr_cli-0.0.29.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitpr-cli
-Version: 0.0.28
+Version: 0.0.29
 Summary: Automação de PRs, Commits e Code Review com IA (Gemini e DeepSeek)
 Author-email: Natan Fiuza <contato@natanfiuza.dev.br>
 Requires-Python: >=3.10
@@ -139,7 +139,7 @@ You can pass the following *flags* for specific actions:
 * `--lang <code>`: Forces the interface language for this execution (e.g.: `en_us`, `pt_br`). Overrides `GITPR_LANG` in `.env` without persisting the change.
 * `-ch` or `--chat`: Opens the **Interactive Pair Programming Chat** — a TUI terminal where the AI sees your current diff and maintains a contextual conversation. Features memory per branch, slash commands (`/explain`, `/tests`, `/optimize`, `/clear`), auto-patching (F5), diff refresh (F2), and session export (F6).
 * `-l` or `--linter`: Runs **only the local static linter** (no AI calls). Ideal for use in CI/CD pipelines to block non-compliant code.
-* `--mcp`: Starts GitPR as an **MCP server** (Model Context Protocol) on stdio transport. Enables integration with VS Code, Cursor, Claude Desktop, and other MCP-compatible editors — exposing all GitPR AI capabilities as tools directly inside your IDE. Also available as the standalone `gitpr-mcp` command.
+* `--mcp`: Starts GitPR as an **MCP server** (Model Context Protocol) on stdio transport. Enables integration with VS Code, Cursor, Claude Desktop, and other MCP-compatible editors — exposing all GitPR AI capabilities as 10 annotated tools, 15 resources, and 7 pre-built prompts directly inside your IDE. Also available as the standalone `gitpr-mcp` command.
 * `--install`: **Interactive Setup Wizard.** Runs a guided 4-step setup: downloads skill templates, installs Git hooks, configures MCP for detected editors, and checks/requests your AI provider API key. Each step asks for confirmation before proceeding.
 * `-ih` or `--installhooks`: Automatically installs **local Git Hooks** (`pre-commit` and `prepare-commit-msg`) in your repository.
 * `-s` or `--skill`: Creates the AI context template files (`.gitpr.commit.md`, `.gitpr.pr.md`, `.gitpr.review.md`, `.gitpr.filereview.md`, `.gitpr.issue.md`, `.gitpr.blame.md`) and the Linter (`.gitpr.linter.yml`) at the project root.
@@ -272,6 +272,8 @@ Once configured, use natural language in your editor's AI chat:
 
 📖 **Full documentation:** [docs/mcp-integration.md](https://github.com/natanfiuza/gitpr/blob/main/docs/mcp-integration.md) — available in 5 languages (EN, PT-BR, PT-PT, ES, FR).
 
+> 💬 **MCP Prompts** — GitPR also exposes 7 pre-defined message templates (prompts) for common flows like "Review PR", "Generate Commit Message", and "Create Issue from Diff". See the [MCP Prompts guide](https://github.com/natanfiuza/gitpr/blob/main/docs/mcp-prompts.md) for the full list.
+
 ## 📚 Technical Documentation and Advanced Guides
 
 To keep this README concise, we detail the most advanced **DevOps** and **Continuous Integration** focused implementations in separate documents.
@@ -307,6 +309,8 @@ If you want to implement GitPR as an automated quality barrier in your team, che
 * [**GitHub Token (PAT) Integration and Security**](https://github.com/natanfiuza/gitpr/blob/main/docs/github-pat-integration.md) — Understand how GitPR creates issues directly in the repository with authentication.
 * [**Internationalization (i18n)**](https://github.com/natanfiuza/gitpr/blob/main/docs/i18n_explanation.md) — Architecture, usage patterns, and how to add new languages.
 * [**MCP Integration**](https://github.com/natanfiuza/gitpr/blob/main/docs/mcp-integration.md) — Connect GitPR to VS Code, Cursor, and Claude Desktop via Model Context Protocol.
+* [**MCP Prompts**](https://github.com/natanfiuza/gitpr/blob/main/docs/mcp-prompts.md) — Pre-built message templates (7 prompts, 35 language variants) for common GitPR workflows in your editor's AI chat.
+* [**MCP Tool Annotations**](https://github.com/natanfiuza/gitpr/blob/main/docs/mcp-annotations.md) — IDE integration hints (`readOnlyHint`, `destructiveHint`) for smarter UI behavior and safer tool execution.
 
 ## ⚡ Local Cache System (Quota Savings)
 

{gitpr_cli-0.0.28.dist-info → gitpr_cli-0.0.29.dist-info}/RECORD

@@ -1,4 +1,4 @@
-gitpr_cli-0.0.28.dist-info/licenses/LICENSE,sha256=UQzLC6mwqb-ZNDkBBAqOxC-SMQcEID0gaM6oFcu6u48,27030
+gitpr_cli-0.0.29.dist-info/licenses/LICENSE,sha256=UQzLC6mwqb-ZNDkBBAqOxC-SMQcEID0gaM6oFcu6u48,27030
 src/__init__.py,sha256=U6ksarernNcryHO20aj4rNG7w0thT7xdMs5KzBJyPvE,28
 src/ai_providers.py,sha256=cxPuytZ9LfvhQbWFPBJ4dud3lHLpAQpa3cbY8bKESk8,10954
 src/blame_engine.py,sha256=z-uh8mHOF--JxY_nnbp5r_9y_a_IO4Zn42P0AeLBpto,10436
@@ -10,17 +10,17 @@ src/i18n.py,sha256=QED7hTSdWCC1lSNJ-l6VuOba18OrWgFTMQcZ7cQmXbY,3599
 src/issue_engine.py,sha256=XJ7WNLoeg3wct079wS7OQqU62f_avn3A8LmMuPWchzE,3642
 src/linter_engine.py,sha256=D04wvOgRa-vZEYknm-z-Cg7V_3gnoQz_64PMorWnISo,4414
 src/main.py,sha256=BoI2aN3l1fS4UzoWL67Yw2QtkeRxh9ITuVIQEc9JOPA,32724
-src/mcp_server.py,sha256=14BRJX7-etSPztBdUfzocbL9KML99nogQfjkZFRFFIU,31406
+src/mcp_server.py,sha256=rT5ACAb0MUpvt8qfO0jIt3g4y6BKWW5YY2qRrs6hKsQ,40227
 src/security.py,sha256=Li0zM8ZURTK2nKRHIt49TWLO4DIddBEHzXPrVycv0Rs,1343
-src/spinner.py,sha256=16ngB2oT1t7O-c3D2DWCJbFb9nMyD-HWv6KcvhKTelQ,7651
+src/spinner.py,sha256=fnl_jVOPjlC1DmINbnJ_IKW-uujpyJNTv51jwhAMvlc,8466
 src/tui_issue.py,sha256=gcAJCIfMcdeMjrFJUWQQvdgBv7fnOBtxQxwdBk2Sk40,1789
-src/updater.py,sha256=M30nc_eAO7CZl6628TkSwuTwXbzZ9sdIgaoilLL1z2A,5886
+src/updater.py,sha256=kHzP-SyprrNQSLeOhiplFjPuswkh4enVc9TM_7LQnpU,5886
 src/ui/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 src/ui/chat_app.py,sha256=y-py5UpisQbPLqqDON8AIkyA7X1IM5LAn1GbeYr2p_U,25598
 src/ui/help_screen.py,sha256=tjbokXhwyzLnkOC0S56NbpX-78hcFQnvsQMpNU1wt0c,1862
 src/ui/issue_app.py,sha256=8MdBcOVdCHPFx6EUhs80CiZ2G-29KulskkCz9qMZ_Lg,4737
-gitpr_cli-0.0.28.dist-info/METADATA,sha256=w1I_R_77I4BP4ajS81C7KcE_PSxpSGqaECzTayg64iM,22656
-gitpr_cli-0.0.28.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
-gitpr_cli-0.0.28.dist-info/entry_points.txt,sha256=TstGnMUzdOI5qNmpM97EPDBPuMqOZxoo6EoLxHSOMSQ,71
-gitpr_cli-0.0.28.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
-gitpr_cli-0.0.28.dist-info/RECORD,,
+gitpr_cli-0.0.29.dist-info/METADATA,sha256=Q77hoxR0vAluySUVwFCFuJPb3-7zozYTPFNm-y2Y1jY,23425
+gitpr_cli-0.0.29.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+gitpr_cli-0.0.29.dist-info/entry_points.txt,sha256=TstGnMUzdOI5qNmpM97EPDBPuMqOZxoo6EoLxHSOMSQ,71
+gitpr_cli-0.0.29.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
+gitpr_cli-0.0.29.dist-info/RECORD,,

src/mcp_server.py

@@ -37,8 +37,9 @@ from pathlib import Path
 import click
 from dotenv import load_dotenv
 from mcp.server.fastmcp import FastMCP
+from mcp.types import ToolAnnotations
 
-from src.i18n import __
+from src.i18n import __, CURRENT_LANG
 
 # =============================================================================
 # Output Patching System
@@ -243,7 +244,8 @@ mcp = FastMCP(
 # =============================================================================
 
 @mcp.tool(
-    description=__("Get the current git branch, repository name, and remote origin URL.")
+    description=__("Get the current git branch, repository name, and remote origin URL."),
+    annotations=ToolAnnotations(readOnlyHint=True, idempotentHint=True),
 )
 def get_git_context() -> str:
     """Return JSON with branch name and repository info."""
@@ -264,7 +266,8 @@ def get_git_context() -> str:
 
 @mcp.tool(
     description=__("Get the current unstaged git diff (git diff HEAD). ")
-                + __("Lists all changed files and their line-level modifications.")
+                + __("Lists all changed files and their line-level modifications."),
+    annotations=ToolAnnotations(readOnlyHint=True, idempotentHint=True),
 )
 def analyze_diff() -> str:
     """Return the raw git diff for uncommitted local changes."""
@@ -284,7 +287,8 @@ def analyze_diff() -> str:
 
 @mcp.tool(
     description=__("Get the full diff of the current branch against the remote "
-                    "base branch (origin/main or origin/master). Runs git fetch first.")
+                    "base branch (origin/main or origin/master). Runs git fetch first."),
+    annotations=ToolAnnotations(readOnlyHint=False, destructiveHint=False, idempotentHint=False),
 )
 def get_full_diff() -> str:
     """Return the full diff between the current branch and origin/main."""
@@ -309,7 +313,8 @@ def get_full_diff() -> str:
 @mcp.tool(
     description=__("Generate a Conventional Commits commit message from the "
                     "current git diff using AI. "
-                    "Returns a message like 'feat: add user authentication'.")
+                    "Returns a message like 'feat: add user authentication'."),
+    annotations=ToolAnnotations(readOnlyHint=False, destructiveHint=False, idempotentHint=False),
 )
 def generate_commit_message(
     provider: str = "",
@@ -351,7 +356,8 @@ def generate_commit_message(
 @mcp.tool(
     description=__("Perform an AI code review on uncommitted local changes "
                     "(git diff HEAD). Returns structured feedback with issues "
-                    "and improvement suggestions.")
+                    "and improvement suggestions."),
+    annotations=ToolAnnotations(readOnlyHint=False, destructiveHint=False, idempotentHint=False),
 )
 def review_code(
     provider: str = "",
@@ -391,7 +397,8 @@ def review_code(
 
 @mcp.tool(
     description=__("Perform a full AI code review comparing the entire current "
-                    "branch against origin/main. Runs git fetch automatically.")
+                    "branch against origin/main. Runs git fetch automatically."),
+    annotations=ToolAnnotations(readOnlyHint=False, destructiveHint=False, idempotentHint=False),
 )
 def full_review(provider: str = "") -> str:
     """AI code review of all changes since origin/main.
@@ -426,7 +433,8 @@ def full_review(provider: str = "") -> str:
 @mcp.tool(
     description=__("Generate a complete Pull Request description (title + body) "
                     "from the full diff against origin/main. Uses AI to create a "
-                    "structured, professional PR document.")
+                    "structured, professional PR document."),
+    annotations=ToolAnnotations(readOnlyHint=False, destructiveHint=False, idempotentHint=False),
 )
 def generate_pr_description(provider: str = "") -> str:
     """Generate a full PR description from the branch diff.
@@ -466,7 +474,8 @@ def generate_pr_description(provider: str = "") -> str:
 @mcp.tool(
     description=__("Run the static local linter (regex-based rules from "
                     ".gitpr.linter.yml) on the current git diff. "
-                    "Returns error and warning counts with detailed messages.")
+                    "Returns error and warning counts with detailed messages."),
+    annotations=ToolAnnotations(readOnlyHint=True, idempotentHint=True),
 )
 def run_linter() -> str:
     """Analyze the current diff against .gitpr.linter.yml rules."""
@@ -499,7 +508,8 @@ def run_linter() -> str:
 @mcp.tool(
     description=__("Run AI-powered git blame analysis on a file region to trace "
                     "the origin of business rules. Classifies each commit as "
-                    "ORIGIN (first introduction) or REFACTORING (later change).")
+                    "ORIGIN (first introduction) or REFACTORING (later change)."),
+    annotations=ToolAnnotations(readOnlyHint=False, destructiveHint=False, idempotentHint=False),
 )
 def analyze_blame(
     file_path: str,
@@ -542,7 +552,8 @@ def analyze_blame(
 @mcp.tool(
     description=__("Generate a structured Issue (What / Why / Where / How) from "
                     "code context using AI. Supports three modes: diff (current "
-                    "changes), history (branch history), or blame (file region).")
+                    "changes), history (branch history), or blame (file region)."),
+    annotations=ToolAnnotations(readOnlyHint=False, destructiveHint=False, idempotentHint=False),
 )
 def generate_issue(context_type: str = "diff") -> str:
     """Generate an issue from code context.
@@ -592,6 +603,19 @@ SKILL_FILES = {
     "blame": ".gitpr.blame.md",
 }
 
+# Prompt template files (message templates for common MCP flows).
+# Each prompt has a base English file and optional language variants
+# (e.g. gitpr.prompt.review.pt_br.md).
+PROMPT_FILES = {
+    "review": "gitpr.prompt.review.md",
+    "commit": "gitpr.prompt.commit.md",
+    "pr": "gitpr.prompt.pr.md",
+    "linter": "gitpr.prompt.linter.md",
+    "issue": "gitpr.prompt.issue.md",
+    "blame": "gitpr.prompt.blame.md",
+    "explore": "gitpr.prompt.explore.md",
+}
+
 
 def _read_resource_file(filename: str) -> str:
     """Read a skill or config file from the project's .gitpr/skill/ directory.
@@ -613,6 +637,62 @@ def _read_resource_file(filename: str) -> str:
     })
 
 
+def _read_prompt_file(prompt_name: str) -> str:
+    """Load prompt content from a template file with language fallback.
+
+    Tries the language-specific variant first (e.g.
+    gitpr.prompt.review.pt_br.md), falling back to the English base
+    file (gitpr.prompt.review.md).  Returns an empty string when
+    neither file can be found.
+
+    Search order (first match wins):
+      1. <cwd>/templates/          — development / project-local
+      2. <cwd>/.gitpr/skill/       — downloaded via --skill
+      3. <package>/templates/      — bundled with the installation
+    """
+    base_filename = PROMPT_FILES.get(prompt_name)
+    if not base_filename:
+        return ""
+
+    # Build language-specific filename
+    if not CURRENT_LANG.startswith("en"):
+        name_part, ext = base_filename.rsplit(".", 1)
+        lang_filename = f"{name_part}.{CURRENT_LANG}.{ext}"
+    else:
+        lang_filename = base_filename
+
+    # Search directories in priority order
+    search_dirs = [
+        os.path.join(os.getcwd(), "templates"),              # dev / project-local
+        os.path.join(os.getcwd(), ".gitpr", "skill"),       # downloaded
+        os.path.join(os.path.dirname(__file__), "..", "templates"),  # bundled
+    ]
+
+    def _try_read(search_dir, filename):
+        path = os.path.join(search_dir, filename)
+        if os.path.exists(path):
+            try:
+                with open(path, "r", encoding="utf-8", errors="replace") as f:
+                    return f.read().strip()
+            except Exception:
+                pass
+        return None
+
+    for search_dir in search_dirs:
+        # Try language variant first
+        result = _try_read(search_dir, lang_filename)
+        if result:
+            return result
+
+    # Fallback to English base in all directories
+    for search_dir in search_dirs:
+        result = _try_read(search_dir, base_filename)
+        if result:
+            return result
+
+    return ""
+
+
 @mcp.resource(
     uri="skill://list",
     name=__("Available Skill Templates"),
@@ -697,6 +777,174 @@ def get_linter_config() -> str:
     return _read_resource_file(".gitpr.linter.yml")
 
 
+# =============================================================================
+# Resources — Prompt Templates
+# =============================================================================
+
+@mcp.resource(
+    uri="prompt://list",
+    name=__("Available Prompt Templates"),
+    description=__("Lists all available MCP prompt template URIs."),
+    mime_type="application/json",
+)
+def list_prompts() -> str:
+    """Return a JSON list of available prompt resource URIs."""
+    return json.dumps({
+        "prompts": [f"prompt://{name}" for name in PROMPT_FILES],
+    })
+
+
+@mcp.resource(
+    uri="prompt://review",
+    name=__("Review PR Prompt"),
+    description=__("Prompt template: full code review of the current branch."),
+    mime_type="text/markdown",
+)
+def get_prompt_review() -> str:
+    return _read_prompt_file("review")
+
+
+@mcp.resource(
+    uri="prompt://commit",
+    name=__("Commit Message Prompt"),
+    description=__("Prompt template: generate a Conventional Commits message."),
+    mime_type="text/markdown",
+)
+def get_prompt_commit() -> str:
+    return _read_prompt_file("commit")
+
+
+@mcp.resource(
+    uri="prompt://pr",
+    name=__("PR Description Prompt"),
+    description=__("Prompt template: generate a Pull Request description."),
+    mime_type="text/markdown",
+)
+def get_prompt_pr() -> str:
+    return _read_prompt_file("pr")
+
+
+@mcp.resource(
+    uri="prompt://linter",
+    name=__("Linter Prompt"),
+    description=__("Prompt template: run the static linter on changes."),
+    mime_type="text/markdown",
+)
+def get_prompt_linter() -> str:
+    return _read_prompt_file("linter")
+
+
+@mcp.resource(
+    uri="prompt://issue",
+    name=__("Issue Prompt"),
+    description=__("Prompt template: generate a structured issue from changes."),
+    mime_type="text/markdown",
+)
+def get_prompt_issue() -> str:
+    return _read_prompt_file("issue")
+
+
+@mcp.resource(
+    uri="prompt://blame",
+    name=__("Blame Prompt"),
+    description=__("Prompt template: trace code origin with git blame + AI."),
+    mime_type="text/markdown",
+)
+def get_prompt_blame() -> str:
+    return _read_prompt_file("blame")
+
+
+@mcp.resource(
+    uri="prompt://explore",
+    name=__("Explore Prompt"),
+    description=__("Prompt template: explore project context and available skills."),
+    mime_type="text/markdown",
+)
+def get_prompt_explore() -> str:
+    return _read_prompt_file("explore")
+
+
+# =============================================================================
+# Prompts — Message Templates for Common Flows
+# =============================================================================
+# Prompts are pre-defined message templates that users can select in their
+# editor's AI chat. Unlike tools (which execute automatically), prompts are
+# starter messages that guide the AI to invoke the right GitPR tools.
+#
+# Prompt content is loaded from template files in templates/ (with language
+# variants), so translations can be updated independently of the Python code.
+# =============================================================================
+
+@mcp.prompt(
+    name=__("Review PR"),
+    description=__("Full code review of all changes in the current branch against origin/main. "
+                    "Runs the full review tool and linter, then composes a comprehensive report."),
+)
+def review_pr_prompt() -> str:
+    """Prompt: full code review of the current branch."""
+    return _read_prompt_file("review")
+
+
+@mcp.prompt(
+    name=__("Generate Commit Message"),
+    description=__("Generate a Conventional Commits message (e.g., 'feat: add user auth') "
+                    "from the current uncommitted changes."),
+)
+def generate_commit_message_prompt() -> str:
+    """Prompt: generate a commit message from uncommitted changes."""
+    return _read_prompt_file("commit")
+
+
+@mcp.prompt(
+    name=__("Create PR Description"),
+    description=__("Generate a complete Pull Request description (title + body) "
+                    "from all changes in the current branch."),
+)
+def create_pr_description_prompt() -> str:
+    """Prompt: generate a full PR description."""
+    return _read_prompt_file("pr")
+
+
+@mcp.prompt(
+    name=__("Run Code Linter"),
+    description=__("Run the static linter (.gitpr.linter.yml rules) on current "
+                    "uncommitted changes and report violations."),
+)
+def run_linter_prompt() -> str:
+    """Prompt: run the static linter on current changes."""
+    return _read_prompt_file("linter")
+
+
+@mcp.prompt(
+    name=__("Create Issue from Diff"),
+    description=__("Generate a structured issue (What / Why / Where / How) from "
+                    "the current uncommitted changes."),
+)
+def create_issue_prompt() -> str:
+    """Prompt: generate an issue from the current diff."""
+    return _read_prompt_file("issue")
+
+
+@mcp.prompt(
+    name=__("Trace Code Origin"),
+    description=__("Investigate the history of a specific file region using git "
+                    "blame + AI to trace where business rules came from."),
+)
+def trace_code_origin_prompt() -> str:
+    """Prompt: trace the origin of code in a file region."""
+    return _read_prompt_file("blame")
+
+
+@mcp.prompt(
+    name=__("Explore Project Context"),
+    description=__("Get current branch info, repository name, and list available "
+                    "skill templates for the project."),
+)
+def explore_project_prompt() -> str:
+    """Prompt: explore the current git context and available skills."""
+    return _read_prompt_file("explore")
+
+
 # =============================================================================
 # MCP Config Installer (gitpr-mcp --install <editor>)
 # =============================================================================

src/spinner.py

@@ -135,6 +135,29 @@ class Spinner:
         self._running = False
         self._quiet = quiet
 
+    @staticmethod
+    def _adaptive_speed(word):
+        """Calculate chars_per_letter and sleep_time based on word length.
+
+        Short words (<=15 chars) keep the original leisurely reveal.
+        Longer phrases get progressively faster so the full text is
+        displayed well before the spinner switches to the next word.
+        """
+        length = len(word)
+        if length <= 15:
+            # Single word: original speed
+            return 4, 0.08
+        elif length <= 35:
+            # Medium phrase: moderate speed
+            return 2, 0.06
+        else:
+            # Long phrase: fast reveal
+            return 1, 0.04
+
+    def _next_word(self, current_idx):
+        """Pick the next word index (sequential, wrapping around)."""
+        return (current_idx + 1) % len(THINKING_WORDS)
+
     def _spin(self):
         """Main animation loop, runs in a separate thread."""
         braille_idx = 0
@@ -144,7 +167,9 @@ class Spinner:
         discovered = ""          # Letters already "discovered" of the word
         dots_cycle = 0           # 0 = ".", 1 = "..", 2 = "..."
         char_step = 0            # Frame counter for revealing letters
-        chars_per_letter = 4     # Frames with random chars before revealing a letter
+
+        # Adaptive speed based on word length
+        chars_per_letter, sleep_time = self._adaptive_speed(word)
 
         while self._running:
             braille_char = BRAILLE_FRAMES[braille_idx]
@@ -177,22 +202,22 @@ class Spinner:
 
                 # Change word and color after a few dot cycles
                 if dots_cycle == 0 and braille_idx == 0:
-                    word_idx = (word_idx + 1) % len(THINKING_WORDS)
+                    word_idx = self._next_word(word_idx)
                     word = THINKING_WORDS[word_idx]
                     word_color = random.choice(WORD_COLORS)
                     discovered = ""
                     char_step = 0
+                    # Recalculate adaptive speed for the new word
+                    chars_per_letter, sleep_time = self._adaptive_speed(word)
 
             # Build and display the line: magenta braille + colored word
-            line = f"\r  {MAGENTA}{braille_char}{RESET} {word_color}{display_word}{RESET}"
-            # Pad the rest of the line with spaces
-            line = line.ljust(70 + len(MAGENTA) + len(RESET) * 2 + len(word_color))
+            line = f"\r  {MAGENTA}{braille_char}{RESET} {word_color}{display_word}{RESET}\033[K"
 
             if not self._quiet:
                 sys.stdout.write(line)
                 sys.stdout.flush()
 
-            time.sleep(0.08)  # ~12 fps, suave
+            time.sleep(sleep_time)
 
     def start(self):
         """Starts the animation in the background."""
@@ -208,5 +233,5 @@ class Spinner:
         if self._thread:
             self._thread.join(timeout=0.5)
         if not self._quiet:
-            sys.stdout.write("\r" + " " * 70 + "\r")
+            sys.stdout.write("\r\033[K")
             sys.stdout.flush()

src/updater.py

@@ -7,8 +7,8 @@ import click
 from datetime import datetime
 
 # Current version of your local executable (Update this on every new build!)
-__version__ = "0.0.28"  # GitPR current version
-__lang_version__ = "v0.0.6"  # Language dictionary version control
+__version__ = "0.0.29"  # GitPR current version
+__lang_version__ = "v0.0.7"  # Language dictionary version control
 GITHUB_API_URL = "https://api.github.com/repos/natanfiuza/gitpr/releases/latest"
 PYPI_API_URL = "https://pypi.org/pypi/gitpr-cli/json"