flutter-dev 0.1.7__tar.gz → 0.1.9__tar.gz

{flutter_dev-0.1.7 → flutter_dev-0.1.9}/CHANGELOG.md

@@ -2,12 +2,21 @@
 
 All notable changes to this project are documented in this file.
 
-## 0.1.7 - 2026-06-25
+## 0.1.9 - 2026-07-14
 
-### Fixed
+### Added
+
+- Added `fdev mirror --turn-screen-off` to keep mirroring while the physical Android display is off.
+
+### Changed
+
+- Running `fdev` without a command now prints command help.
+- `fdev clear-data` now skips confirmation when the foreground Android app matches the current Flutter project and uses a default-Yes prompt when it does not.
+- `fdev upgrade` now prints the current installed version, Python environment, package location, upgrade source, and verified result version.
+
+### Removed
 
-- Reworked the Tkinter dashboard to use classic Tk widgets with explicit colors so `fdev` stays visible on macOS Xcode/system Python runtimes that can render `ttk` widgets as a blank popup.
-- Silenced the macOS system Tk deprecation warning before launching the dashboard.
+- Removed obsolete desktop-only components and their related tests and documentation.
 
 ## 0.1.6 - 2026-06-25
 
@@ -20,23 +29,11 @@ All notable changes to this project are documented in this file.
 
 - `fdev upgrade` and `fdev delete` now print the exact Python executable they target before running `sys.executable -m pip`.
 
-### Fixed
-
-- Reworked the Tkinter dashboard layout to avoid platform-sensitive paned-window sizing that could open a blank `fdev` popup after installing from PyPI.
-
 ## 0.1.5 - 2026-06-24
 
-### Added
-
-- Added a Tkinter desktop dashboard that opens by running `fdev` with no command.
-- Added GUI live log output with ANSI terminal color rendering.
-- Added GUI buttons for all documented command groups, including mirror variants, AI provider shortcuts, and GitHub account subcommands.
-- Added Python coverage for GUI command catalog, ANSI color parsing, and no-command CLI dispatch.
-
 ### Changed
 
 - Kept command help available through `fdev help`, `fdev --help`, and `fdev -h`.
-- Documented Tkinter requirements for the desktop dashboard.
 
 ## 0.1.4 - 2026-06-15
 

{flutter_dev-0.1.7 → flutter_dev-0.1.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flutter-dev
-Version: 0.1.7
+Version: 0.1.9
 Summary: A cross-platform CLI toolkit for Flutter development workflows.
 Author: Royal Court BD
 License-Expression: MIT
@@ -42,7 +42,7 @@ The package is published on PyPI as `flutter-dev` and installs console commands
 python -m pip install flutter-dev
 ```
 
-Current package metadata declares version `0.1.7`, Python `>=3.8`, MIT license, and support for macOS, Linux, and Windows.
+Current package metadata declares version `0.1.9`, Python `>=3.8`, MIT license, and support for macOS, Linux, and Windows.
 
 ## Key Features
 
@@ -53,7 +53,6 @@ Current package metadata declares version `0.1.7`, Python `>=3.8`, MIT license,
 - AI-assisted Git commits using Groq, Mistral, SambaNova, or OpenRouter-compatible chat completion APIs.
 - Git workflow helpers for version tags, branch sync, deployment branch merge, discard, and GitHub account management through `gh`.
 - Feature/page generator that creates a `lib/features/<name>` structure using the project's presenter/base-state pattern.
-- Small Tkinter desktop dashboard opened by running `fdev` with no command, with live colored command logs.
 - Environment diagnostics through `fdev doctor`.
 - Small utilities for Homebrew cleanup, file merging from `paths.txt`, AI provider switching, PyPI self-upgrade/delete, and git diff prompt export.
 
@@ -73,8 +72,6 @@ fdev doctor
 
 `python -m pip install flutter-dev` installs the Python package, Python dependencies, and console scripts into the Python environment selected by `python`. It does not install Flutter, Dart, Git, Android SDK tools, CocoaPods, Firebase CLI, GitHub CLI, `scrcpy`, Java/JDK, or VS Code CLI.
 
-The desktop dashboard uses Python Tkinter. Some Python distributions install this separately; for Homebrew Python, install the matching package such as `brew install python-tk@3.14`.
-
 ### Install From Source
 
 ```bash
@@ -122,14 +119,13 @@ Feature-specific external tools:
 | GitHub CLI / `gh` | `fdev git ...` |
 | VS Code CLI / `code` | Conflict helper in branch sync |
 | Homebrew | `brew`, macOS `install-scrcpy` flow |
-| Python Tkinter | Desktop dashboard opened by `fdev` |
 
 ## Quick Start
 
 Run commands from the root of a Flutter project when they need `pubspec.yaml`, Android Gradle files, iOS files, or build outputs.
 
 ```bash
-# Open the desktop dashboard
+# Show command help
 fdev
 
 # Show command help
@@ -202,11 +198,12 @@ Android APK/AAB build commands rename output files using the Android app label a
 | --- | --- |
 | `fdev install` | Installs a built APK from `build/app/outputs/flutter-apk`, prefers `arm64-v8a`, retries after uninstall on failure, then launches the app. |
 | `fdev uninstall` | In a Flutter project root, uninstalls by package/bundle id. Outside a project, detects the foreground app and asks for confirmation. |
-| `fdev clear-data` | Detects the foreground app, asks for confirmation, and runs `adb shell pm clear <package>` on Android. iOS prints manual options. |
+| `fdev clear-data` | Detects the foreground app and runs `adb shell pm clear <package>` on Android. Confirmation is skipped when it matches the current Flutter project; otherwise the default-Yes safety prompt is shown. iOS prints manual options. |
 | `fdev install-scrcpy` | Installs `scrcpy` using the best supported package manager for the current platform. |
 | `fdev mirror` | Launches `scrcpy` for a selected Android device. |
 | `fdev mirror --wireless` | Guides wireless ADB setup using a USB-connected Android device. |
 | `fdev mirror --no-top` | Launches `scrcpy` without the always-on-top flag. |
+| `fdev mirror --turn-screen-off` | Launches `scrcpy` while keeping the Android device display turned off. |
 | `fdev datetime` | Disables Android auto-time and opens Date & Time settings on the selected device. |
 
 When multiple Android devices are connected, device-aware commands prompt you to choose a device.
@@ -239,10 +236,10 @@ Switching GitHub accounts runs `gh auth switch` and `gh auth setup-git`, but it
 
 | Command | Description |
 | --- | --- |
-| `fdev` | Opens a small Tkinter desktop dashboard for running `fdev` commands with live colored logs and command input. The terminal process stays running while the window is open. |
-| `fdev help` | Shows command help without opening the dashboard. |
+| `fdev` | Shows command help. |
+| `fdev help` | Shows command help. |
 | `fdev doctor` | Checks platform, Python, Flutter/Dart/Git, Python packages, Android/iOS tools, optional CLIs, `.env`, Flutter project detection, and global `fdev` availability. |
-| `fdev upgrade` | Detects the OS, then upgrades the active Python environment's `flutter-dev` package from PyPI with `python -m pip install --upgrade flutter-dev`. |
+| `fdev upgrade` | Shows the current version, Python environment, package location, and PyPI source, then upgrades with `python -m pip install --upgrade flutter-dev` and reports the resulting version. |
 | `fdev delete` | Detects the OS, asks for confirmation, then uninstalls the active Python environment's `flutter-dev` package. Use `fdev delete --yes` to skip confirmation. |
 | `fdev ai` | Shows the current AI provider and opens an interactive provider switch prompt. |
 | `fdev ai <provider>` | Switches `DEFAULT_AI_SERVICE` to `groq`, `mistral`, `sambanova`, or `openrouter`. |
@@ -390,11 +387,12 @@ The installed Python layout is top-level modules plus the `core` and `managers`
 - `fdev tag` updates `pubspec.yaml`, creates a commit, creates a Git tag, and pushes both.
 - `fdev discard` removes tracked changes and untracked files after confirmation.
 - `fdev cleanup` applies `dart fix`, formats the project, and runs a major-version dependency upgrade.
-- `fdev clear-data` clears app data on Android after confirmation.
+- `fdev clear-data` skips confirmation only when the foreground Android app matches the current Flutter project's package ID; otherwise it uses a default-Yes `[Y/n]` confirmation.
 - `fdev uninstall` may fall back to foreground app detection outside a Flutter project root.
 - `fdev upgrade` and `fdev delete` manage the local `flutter-dev` Python package, not the Flutter app on a device.
+- `fdev upgrade` reports the installed version and location before upgrading, then shows the before→after version when the active process can verify it immediately.
 - `fdev delete` removes the `fdev` command from the current Python environment after confirmation; reinstall with `python -m pip install flutter-dev`.
-- `fdev` with no command opens the desktop dashboard. Use `fdev help` to print command usage.
+- `fdev` with no command prints command usage.
 - Most command subcommands create build output directories at startup in the current working directory.
 - Some subcommands return failure internally without always mapping that failure to a non-zero process exit code, so automation should inspect command output carefully.
 
@@ -433,16 +431,6 @@ fdev delete
 
 Both commands print the detected OS and exact Python executable before running. They use that executable with `-m pip`, not a hardcoded `python`, `python3`, `pip`, or `pip3`, so the active venv/global Python that launched `fdev` is the environment that gets upgraded or deleted. On Windows, `fdev delete` and `fdev upgrade` schedule the same `sys.executable -m pip ...` operation in a delayed command process so the currently running console launcher can exit first.
 
-### Blank Dashboard On macOS
-
-If `fdev` prints an Xcode/system Tk warning or opens a blank dashboard, upgrade to `flutter-dev` 0.1.7 or newer:
-
-```bash
-fdev upgrade
-```
-
-`fdev` prints the Python executable it is using. If that path is `/Applications/Xcode.app/Contents/Developer/usr/bin/python3`, the CLI is running on Xcode's bundled Python and system Tk; 0.1.7 uses a more conservative Tk UI path for that runtime.
-
 ### Flutter Project Not Detected
 
 Run project-specific commands from the directory that contains `pubspec.yaml`.
@@ -478,8 +466,12 @@ Install or repair `scrcpy`:
 ```bash
 fdev install-scrcpy
 fdev mirror
+fdev mirror --turn-screen-off
 ```
 
+`--turn-screen-off` may be combined with `--no-top`. The mirrored window stays
+active, but the physical Android display is turned off on supported devices.
+
 For wireless mirroring, connect the device over USB first:
 
 ```bash

{flutter_dev-0.1.7 → flutter_dev-0.1.9}/README.md

@@ -8,7 +8,7 @@ The package is published on PyPI as `flutter-dev` and installs console commands
 python -m pip install flutter-dev
 ```
 
-Current package metadata declares version `0.1.7`, Python `>=3.8`, MIT license, and support for macOS, Linux, and Windows.
+Current package metadata declares version `0.1.9`, Python `>=3.8`, MIT license, and support for macOS, Linux, and Windows.
 
 ## Key Features
 
@@ -19,7 +19,6 @@ Current package metadata declares version `0.1.7`, Python `>=3.8`, MIT license,
 - AI-assisted Git commits using Groq, Mistral, SambaNova, or OpenRouter-compatible chat completion APIs.
 - Git workflow helpers for version tags, branch sync, deployment branch merge, discard, and GitHub account management through `gh`.
 - Feature/page generator that creates a `lib/features/<name>` structure using the project's presenter/base-state pattern.
-- Small Tkinter desktop dashboard opened by running `fdev` with no command, with live colored command logs.
 - Environment diagnostics through `fdev doctor`.
 - Small utilities for Homebrew cleanup, file merging from `paths.txt`, AI provider switching, PyPI self-upgrade/delete, and git diff prompt export.
 
@@ -39,8 +38,6 @@ fdev doctor
 
 `python -m pip install flutter-dev` installs the Python package, Python dependencies, and console scripts into the Python environment selected by `python`. It does not install Flutter, Dart, Git, Android SDK tools, CocoaPods, Firebase CLI, GitHub CLI, `scrcpy`, Java/JDK, or VS Code CLI.
 
-The desktop dashboard uses Python Tkinter. Some Python distributions install this separately; for Homebrew Python, install the matching package such as `brew install python-tk@3.14`.
-
 ### Install From Source
 
 ```bash
@@ -88,14 +85,13 @@ Feature-specific external tools:
 | GitHub CLI / `gh` | `fdev git ...` |
 | VS Code CLI / `code` | Conflict helper in branch sync |
 | Homebrew | `brew`, macOS `install-scrcpy` flow |
-| Python Tkinter | Desktop dashboard opened by `fdev` |
 
 ## Quick Start
 
 Run commands from the root of a Flutter project when they need `pubspec.yaml`, Android Gradle files, iOS files, or build outputs.
 
 ```bash
-# Open the desktop dashboard
+# Show command help
 fdev
 
 # Show command help
@@ -168,11 +164,12 @@ Android APK/AAB build commands rename output files using the Android app label a
 | --- | --- |
 | `fdev install` | Installs a built APK from `build/app/outputs/flutter-apk`, prefers `arm64-v8a`, retries after uninstall on failure, then launches the app. |
 | `fdev uninstall` | In a Flutter project root, uninstalls by package/bundle id. Outside a project, detects the foreground app and asks for confirmation. |
-| `fdev clear-data` | Detects the foreground app, asks for confirmation, and runs `adb shell pm clear <package>` on Android. iOS prints manual options. |
+| `fdev clear-data` | Detects the foreground app and runs `adb shell pm clear <package>` on Android. Confirmation is skipped when it matches the current Flutter project; otherwise the default-Yes safety prompt is shown. iOS prints manual options. |
 | `fdev install-scrcpy` | Installs `scrcpy` using the best supported package manager for the current platform. |
 | `fdev mirror` | Launches `scrcpy` for a selected Android device. |
 | `fdev mirror --wireless` | Guides wireless ADB setup using a USB-connected Android device. |
 | `fdev mirror --no-top` | Launches `scrcpy` without the always-on-top flag. |
+| `fdev mirror --turn-screen-off` | Launches `scrcpy` while keeping the Android device display turned off. |
 | `fdev datetime` | Disables Android auto-time and opens Date & Time settings on the selected device. |
 
 When multiple Android devices are connected, device-aware commands prompt you to choose a device.
@@ -205,10 +202,10 @@ Switching GitHub accounts runs `gh auth switch` and `gh auth setup-git`, but it
 
 | Command | Description |
 | --- | --- |
-| `fdev` | Opens a small Tkinter desktop dashboard for running `fdev` commands with live colored logs and command input. The terminal process stays running while the window is open. |
-| `fdev help` | Shows command help without opening the dashboard. |
+| `fdev` | Shows command help. |
+| `fdev help` | Shows command help. |
 | `fdev doctor` | Checks platform, Python, Flutter/Dart/Git, Python packages, Android/iOS tools, optional CLIs, `.env`, Flutter project detection, and global `fdev` availability. |
-| `fdev upgrade` | Detects the OS, then upgrades the active Python environment's `flutter-dev` package from PyPI with `python -m pip install --upgrade flutter-dev`. |
+| `fdev upgrade` | Shows the current version, Python environment, package location, and PyPI source, then upgrades with `python -m pip install --upgrade flutter-dev` and reports the resulting version. |
 | `fdev delete` | Detects the OS, asks for confirmation, then uninstalls the active Python environment's `flutter-dev` package. Use `fdev delete --yes` to skip confirmation. |
 | `fdev ai` | Shows the current AI provider and opens an interactive provider switch prompt. |
 | `fdev ai <provider>` | Switches `DEFAULT_AI_SERVICE` to `groq`, `mistral`, `sambanova`, or `openrouter`. |
@@ -356,11 +353,12 @@ The installed Python layout is top-level modules plus the `core` and `managers`
 - `fdev tag` updates `pubspec.yaml`, creates a commit, creates a Git tag, and pushes both.
 - `fdev discard` removes tracked changes and untracked files after confirmation.
 - `fdev cleanup` applies `dart fix`, formats the project, and runs a major-version dependency upgrade.
-- `fdev clear-data` clears app data on Android after confirmation.
+- `fdev clear-data` skips confirmation only when the foreground Android app matches the current Flutter project's package ID; otherwise it uses a default-Yes `[Y/n]` confirmation.
 - `fdev uninstall` may fall back to foreground app detection outside a Flutter project root.
 - `fdev upgrade` and `fdev delete` manage the local `flutter-dev` Python package, not the Flutter app on a device.
+- `fdev upgrade` reports the installed version and location before upgrading, then shows the before→after version when the active process can verify it immediately.
 - `fdev delete` removes the `fdev` command from the current Python environment after confirmation; reinstall with `python -m pip install flutter-dev`.
-- `fdev` with no command opens the desktop dashboard. Use `fdev help` to print command usage.
+- `fdev` with no command prints command usage.
 - Most command subcommands create build output directories at startup in the current working directory.
 - Some subcommands return failure internally without always mapping that failure to a non-zero process exit code, so automation should inspect command output carefully.
 
@@ -399,16 +397,6 @@ fdev delete
 
 Both commands print the detected OS and exact Python executable before running. They use that executable with `-m pip`, not a hardcoded `python`, `python3`, `pip`, or `pip3`, so the active venv/global Python that launched `fdev` is the environment that gets upgraded or deleted. On Windows, `fdev delete` and `fdev upgrade` schedule the same `sys.executable -m pip ...` operation in a delayed command process so the currently running console launcher can exit first.
 
-### Blank Dashboard On macOS
-
-If `fdev` prints an Xcode/system Tk warning or opens a blank dashboard, upgrade to `flutter-dev` 0.1.7 or newer:
-
-```bash
-fdev upgrade
-```
-
-`fdev` prints the Python executable it is using. If that path is `/Applications/Xcode.app/Contents/Developer/usr/bin/python3`, the CLI is running on Xcode's bundled Python and system Tk; 0.1.7 uses a more conservative Tk UI path for that runtime.
-
 ### Flutter Project Not Detected
 
 Run project-specific commands from the directory that contains `pubspec.yaml`.
@@ -444,8 +432,12 @@ Install or repair `scrcpy`:
 ```bash
 fdev install-scrcpy
 fdev mirror
+fdev mirror --turn-screen-off
 ```
 
+`--turn-screen-off` may be combined with `--no-top`. The mirrored window stays
+active, but the physical Android display is turned off on supported devices.
+
 For wireless mirroring, connect the device over USB first:
 
 ```bash

{flutter_dev-0.1.7 → flutter_dev-0.1.9}/fdev.py

@@ -70,9 +70,6 @@ from managers.brew import (
 from managers.git_account import (
     git_account_manager,
 )
-from managers.gui import (
-    launch_gui,
-)
 from managers.package import (
     delete_fdev_command,
     upgrade_fdev_command,
@@ -82,7 +79,7 @@ from managers.package import (
 def show_usage(exit_code=1):
     """Show usage information"""
     print(f"{YELLOW}Usage: {sys.argv[0]} [command] [options]{NC}")
-    print(f"{BLUE}Run {GREEN}fdev{NC}{BLUE} without a command to open the desktop dashboard.{NC}")
+    print(f"{BLUE}Run {GREEN}fdev{NC}{BLUE} without a command to show this help.{NC}")
     print(f"\n{BLUE}Build Commands:{NC}")
     print("  apk          Build release APK (Full Process)")
     print("  apk-split    Build APK with --split-per-abi")
@@ -109,6 +106,7 @@ def show_usage(exit_code=1):
     print("  mirror       Launch scrcpy screen mirror (auto-detect device)")
     print("    --wireless Setup wireless ADB connection")
     print("    --no-top   Launch mirror without 'always on top' window")
+    print("    --turn-screen-off Turn off the device display while mirroring")
     print("  datetime     Open device Date & Time settings (auto-time disabled)")
 
     print(f"\n{BLUE}Git & iOS Commands:{NC}")
@@ -136,6 +134,7 @@ def show_usage(exit_code=1):
     print(f"  {GREEN}fdev install-scrcpy{NC}            # Install scrcpy for mirroring")
     print(f"  {GREEN}fdev mirror --wireless{NC}         # Setup wireless ADB first")
     print(f"  {GREEN}fdev mirror --no-top{NC}           # Launch mirror without always-on-top")
+    print(f"  {GREEN}fdev mirror --turn-screen-off{NC}   # Mirror with device display turned off")
     print(f"  {GREEN}fdev datetime{NC}                  # Open device Date & Time settings")
     print(f"  {GREEN}fdev uninstall{NC}                 # Uninstall app (auto-selects device)")
     print(f"  {GREEN}fdev discard{NC}                   # Discard all uncommitted changes")
@@ -150,7 +149,7 @@ def show_usage(exit_code=1):
     print(f"  {GREEN}fdev csv-to-arb{NC}                # Generate lib/l10n ARB files from translations.csv")
     print(f"  {GREEN}fdev upgrade{NC}                   # Upgrade flutter-dev from PyPI")
     print(f"  {GREEN}fdev delete{NC}                    # Remove flutter-dev/fdev from this computer")
-    print(f"  {GREEN}fdev{NC}                           # Open small desktop dashboard")
+    print(f"  {GREEN}fdev{NC}                           # Show command help")
 
     print(f"\n{BLUE}Note:{NC}")
     print(f"  {YELLOW}Multiple devices detected?{NC} Tool will prompt you to select one.")
@@ -165,7 +164,7 @@ def main():
     os.makedirs("build/ios/ipa", exist_ok=True)
 
     if len(sys.argv) < 2:
-        return launch_gui()
+        return show_usage(exit_code=0)
 
     command = sys.argv[1].lower()
 
@@ -238,10 +237,14 @@ def main():
         # Check for wireless option
         wireless = "--wireless" in sys.argv
         no_top = "--no-top" in sys.argv
+        turn_screen_off = "--turn-screen-off" in sys.argv
         if wireless:
             setup_wireless_adb()
         else:
-            launch_scrcpy(always_on_top=not no_top)
+            launch_scrcpy(
+                always_on_top=not no_top,
+                turn_screen_off=turn_screen_off,
+            )
 
     # DateTime command
     elif command == "datetime":

{flutter_dev-0.1.7 → flutter_dev-0.1.9}/flutter_dev.egg-info/SOURCES.txt

@@ -26,7 +26,6 @@ managers/device.py
 managers/doctor.py
 managers/git.py
 managers/git_account.py
-managers/gui.py
 managers/localization.py
 managers/merge.py
 managers/mirror.py
@@ -34,6 +33,5 @@ managers/package.py
 managers/project.py
 managers/web_deploy.py
 tests/test_fdev_cli.py
-tests/test_gui.py
 tests/test_localization.py
 tests/test_package_commands.py

{flutter_dev-0.1.7 → flutter_dev-0.1.9}/install_legacy.py

@@ -368,7 +368,7 @@ def auto_configure_path(bin_dir, system_platform, home):
             # PowerShell failed, show manual instructions
             print(f"{YELLOW}Could not auto-configure PATH. Please add manually:{NC}")
             print(f"\n{BLUE}Path to add: {GREEN}{bin_dir}{NC}")
-            print(f"\n{YELLOW}Option 1 - GUI:{NC}")
+            print(f"\n{YELLOW}Option 1 - Windows settings:{NC}")
             print(f"  1. Press {BLUE}Win + R{NC} → type {BLUE}sysdm.cpl{NC} → Enter")
             print(f"  2. {BLUE}Environment Variables{NC} → User variables → {BLUE}Path{NC} → Edit")
             print(f"  3. New → add: {GREEN}{bin_dir}{NC}")

{flutter_dev-0.1.7 → flutter_dev-0.1.9}/managers/app.py

@@ -207,11 +207,28 @@ def clear_app_data():
     print(f"{BLUE}Platform: {platform_type.upper()}{NC}")
     print(f"{BLUE}App: {package_name}{NC}\n")
 
-    # Ask for confirmation
-    user_input = input(f"Clear data for {GREEN}{package_name}{NC}? (Y/n): ")
-    if user_input.lower() == 'n':
-        print(f"{YELLOW}Operation cancelled{NC}")
-        return False
+    # Skip confirmation only when the foreground app matches the current
+    # Flutter project's Android package. Otherwise, keep the safety prompt.
+    project_package = get_package_name() if is_flutter_project_root() else None
+    is_current_project_app = (
+        platform_type == "android"
+        and project_package is not None
+        and project_package == package_name
+    )
+
+    if is_current_project_app:
+        print(f"{GREEN}✓ Foreground app matches the current Flutter project{NC}\n")
+    else:
+        if project_package and platform_type == "android":
+            print(f"{YELLOW}⚠️  Foreground app does not match the current Flutter project{NC}")
+            print(f"{BLUE}Project package: {project_package}{NC}\n")
+
+        user_input = input(
+            f"Clear data for {GREEN}{package_name}{NC}? [Y/n]: "
+        ).strip().lower()
+        if user_input in ("n", "no"):
+            print(f"{YELLOW}Operation cancelled{NC}")
+            return False
 
     # Clear data based on platform
     if platform_type == "android":

{flutter_dev-0.1.7 → flutter_dev-0.1.9}/managers/brew.py

@@ -54,7 +54,7 @@ def _get_casks():
 
 
 def _is_cask(package):
-    """Check if a package is a cask (GUI app) or formula."""
+    """Check if a package is a cask (desktop app) or formula."""
     result = _run_brew(["info", "--cask", package])
     return bool(result and "Not installed" not in result)
 
@@ -330,7 +330,7 @@ def brew_manager():
         print(f"\n  {YELLOW}View:{NC}")
         print(f"    {BLUE}1.{NC} Top-level packages (brew leaves)")
         print(f"    {BLUE}2.{NC} All installed formulae")
-        print(f"    {BLUE}3.{NC} All installed casks (GUI apps)")
+        print(f"    {BLUE}3.{NC} All installed casks (desktop apps)")
         print(f"    {BLUE}4.{NC} Global cleanup (autoremove + cache)")
         print(f"    {BLUE}0.{NC} Exit")
 

{flutter_dev-0.1.7 → flutter_dev-0.1.9}/managers/mirror.py

@@ -321,12 +321,13 @@ def setup_wireless_adb():
         return False
 
 
-def launch_scrcpy(always_on_top=True):
+def launch_scrcpy(always_on_top=True, turn_screen_off=False):
     """
     Launch scrcpy with optimized settings
 
     Args:
         always_on_top: If True, keep the scrcpy window always on top
+        turn_screen_off: If True, turn off the device display while mirroring
     """
     print(f"{YELLOW}Launching scrcpy...{NC}\n")
 
@@ -347,6 +348,8 @@ def launch_scrcpy(always_on_top=True):
     cmd = ["scrcpy", "-s", selected_device, "--no-mouse-hover", "-m", "1080", "-b", "5M"]
     if always_on_top:
         cmd.insert(4, "--always-on-top")
+    if turn_screen_off:
+        cmd.append("--turn-screen-off")
 
     print(f"\n{BLUE}Launching scrcpy...{NC}")
     print(f"{YELLOW}Command: {' '.join(cmd)}{NC}\n")

{flutter_dev-0.1.7 → flutter_dev-0.1.9}/managers/package.py

@@ -4,6 +4,7 @@ Package Manager - self-management commands for the installed fdev package.
 """
 
 import argparse
+from importlib import metadata
 import platform
 import subprocess
 import sys
@@ -38,6 +39,26 @@ def _print_python_environment():
     print(f"{BLUE}Python environment: {GREEN}{sys.executable}{NC}")
 
 
+def _get_installed_package_info():
+    """Return the installed package version and location for this Python environment."""
+    try:
+        distribution = metadata.distribution(PACKAGE_NAME)
+    except metadata.PackageNotFoundError:
+        return "not installed", "not found in the current Python environment"
+
+    try:
+        package_location = str(distribution.locate_file("").resolve())
+    except (AttributeError, OSError):
+        package_location = str(distribution.locate_file(""))
+
+    return distribution.version, package_location
+
+
+def _print_installed_package_info(version, package_location):
+    print(f"{BLUE}Current version: {GREEN}{version}{NC}")
+    print(f"{BLUE}Package location: {GREEN}{package_location}{NC}")
+
+
 def _build_pip_command(pip_args):
     return [sys.executable, "-m", "pip", *pip_args]
 
@@ -132,8 +153,11 @@ def upgrade_fdev_command(argv=None):
     os_key, os_name = get_os_info()
     _print_os_info(os_name)
     _print_python_environment()
+    current_version, package_location = _get_installed_package_info()
+    _print_installed_package_info(current_version, package_location)
 
     pip_args = ["install", "--upgrade", PACKAGE_NAME]
+    print(f"{BLUE}Upgrade source: {GREEN}PyPI{NC}")
     print(f"{YELLOW}Upgrading {PACKAGE_NAME} from PyPI...{NC}")
 
     if os_key == "windows":
@@ -141,7 +165,19 @@ def upgrade_fdev_command(argv=None):
 
     result = _run_pip_direct(pip_args)
     if result == 0:
-        print(f"{GREEN}✓ {PACKAGE_NAME} upgraded successfully.{NC}")
+        installed_version, installed_location = _get_installed_package_info()
+        if current_version != installed_version:
+            print(
+                f"{GREEN}✓ {PACKAGE_NAME} upgraded successfully: "
+                f"{current_version} → {installed_version}.{NC}"
+            )
+        else:
+            print(
+                f"{GREEN}✓ {PACKAGE_NAME} upgrade completed. "
+                f"Installed version: {installed_version}.{NC}"
+            )
+        if installed_location != package_location:
+            print(f"{BLUE}Installed at: {GREEN}{installed_location}{NC}")
         print(f"{BLUE}Restart your terminal if the fdev command still uses the old version.{NC}")
     else:
         print(f"{RED}✗ Failed to upgrade {PACKAGE_NAME}.{NC}")

{flutter_dev-0.1.7 → flutter_dev-0.1.9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "flutter-dev"
-version = "0.1.7"
+version = "0.1.9"
 description = "A cross-platform CLI toolkit for Flutter development workflows."
 readme = "README.md"
 requires-python = ">=3.8"

{flutter_dev-0.1.7 → flutter_dev-0.1.9}/tests/test_fdev_cli.py

@@ -6,29 +6,29 @@ import fdev
 
 
 class FdevCliTests(unittest.TestCase):
-    def test_no_command_launches_gui(self):
-        with patch.object(sys, "argv", ["fdev"]), patch.object(fdev, "launch_gui", return_value=0) as launch_gui:
+    def test_no_command_prints_usage(self):
+        with (
+            patch.object(sys, "argv", ["fdev"]),
+            patch.object(fdev, "show_usage", return_value=0) as show_usage,
+        ):
             result = fdev.main()
 
         self.assertEqual(result, 0)
-        launch_gui.assert_called_once_with()
+        show_usage.assert_called_once_with(exit_code=0)
 
-    def test_help_command_prints_usage_without_launching_gui(self):
+    def test_help_command_prints_usage(self):
         with (
             patch.object(sys, "argv", ["fdev", "help"]),
-            patch.object(fdev, "launch_gui", return_value=0) as launch_gui,
             patch.object(fdev, "show_usage", return_value=0) as show_usage,
         ):
             result = fdev.main()
 
         self.assertEqual(result, 0)
         show_usage.assert_called_once_with(exit_code=0)
-        launch_gui.assert_not_called()
 
-    def test_gui_subcommand_is_not_the_dashboard_entrypoint(self):
+    def test_unknown_command_prints_usage_and_exits_with_error(self):
         with (
-            patch.object(sys, "argv", ["fdev", "gui"]),
-            patch.object(fdev, "launch_gui", return_value=0) as launch_gui,
+            patch.object(sys, "argv", ["fdev", "unknown"]),
             patch.object(fdev, "show_usage", return_value=1) as show_usage,
         ):
             with self.assertRaises(SystemExit) as raised:
@@ -36,7 +36,6 @@ class FdevCliTests(unittest.TestCase):
 
         self.assertEqual(raised.exception.code, 1)
         show_usage.assert_called_once_with()
-        launch_gui.assert_not_called()
 
     def test_delete_command_routes_to_package_delete(self):
         with (