redfetch 1.4.0__tar.gz → 1.4.2__tar.gz

{redfetch-1.4.0 → redfetch-1.4.2}/CHANGELOG.md

@@ -5,6 +5,30 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.4.2] - 2026-07-06
+
+### Fixed
+- The update button wouldn't launch MQ if eqbcs.exe was running.
+
+## [1.4.1] - 2026-07-05
+
+### Changed
+- The update button once again doubles as a *launch MQ* button, even when no update occurs.
+
+### Added
+- `redfetch run` and `redfetch open` CLI commands act as shortcuts, for example `redfetch run eqgame` will start EQgame.exe, `redfetch open eqhost` will open the eqhost.txt file, etc. These mirror the TUI shortcuts.
+
+## [1.4.0] - 2026-07-05
+
+### Changed
+- You can now update while playing. Updates take effect the next time you start Very Vanilla MQ.
+
+### Added
+- New logic for restarting VVMQ after an update. redfetch will never touch EQ nor unload MQ.
+
+### Removed
+- The "Close MQ pre-update" setting and TUI toggle.
+
 ## [1.3.0] - 2026-06-26
 
 ### Added

{redfetch-1.4.0 → redfetch-1.4.2}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: redfetch
-Version: 1.4.0
+Version: 1.4.2
 Summary: Download and publish EverQuest scripts and software using the RedGuides API
 Project-URL: Homepage, https://www.redguides.com
 Project-URL: Documentation, https://www.redguides.com/community/resources/redfetch.3177/
 Project-URL: Repository, https://github.com/RedGuides/redfetch
 Project-URL: Issues, https://github.com/RedGuides/redfetch/issues
 Project-URL: Changelog, https://github.com/RedGuides/redfetch/blob/main/CHANGELOG.md
-Project-URL: Source_archive, https://github.com/RedGuides/redfetch/archive/ccf5cf558b6e6f261fab4079e837d5cb47e7975d.zip
+Project-URL: Source_archive, https://github.com/RedGuides/redfetch/archive/38aedc8ce3dc8e7164b3d3c308732461531a7d4a.zip
 Author-email: Redbot <ask@redguides.com>
 License-Expression: GPL-3.0-or-later
 License-File: LICENSE
@@ -105,42 +105,56 @@ To run redfetch from the command line:
 
 ## Command Line Reference
 
-> Run `redfetch --help` or `.\redfetch.exe --help` to see something like this in your terminal:
-> 
+<!-- BEGIN GENERATED CLI REFERENCE -->
+> Run `redfetch --help` for the current list, or `redfetch <COMMAND> --help` for a command's options. It looks like:
+>
 > ### 📦 Resource Management
-> - `update` - Update all watched and special resources
->   - `--force` / `-f` - Force re-download of all watched resources
->   - `--server` / `-s` - Switch to this server before updating (`LIVE`, `TEST`, `EMU`)
-> - `download <ID_OR_URL>` - Download a specific resource by ID or URL
->   - `--force` / `-f` - Force re-download by resetting this resource's download date
->   - `--server` / `-s` - Switch to this server before downloading (`LIVE`, `TEST`, `EMU`)
-> - `list` - List resources and dependencies in the cache database
-> - `reset` - Reset download dates for watched resources
-> 
+> - `update` - Update all *watched* and special resources.
+>   - `--force` / `-f` - Force re-download of all watched resources.
+>   - `--server` / `-s` - Update this server for this run only, without changing your current server (LIVE, TEST, EMU).
+> - `download <ID_OR_URL>` - Download a specific resource by ID or URL.
+>   - `ID_OR_URL` - RedGuides resource ID or URL
+>   - `--force` / `-f` - Force re-download by resetting this resource's download date.
+>   - `--server` / `-s` - Download from this server for this run only, without changing your current server (LIVE, TEST, EMU).
+> - `check` - Non-interactive update check (for automation.)
+>   - `--server` / `-s` - Check this server's env for this run only, without persisting it (LIVE, TEST, EMU).
+> - `list` - List resources and dependencies in your local cache.
+> - `reset` - Reset download dates for *watched resources* in the database.
+>
+> ### 🔧 System & Utilities
+> - `ui` - Launch the *Terminal User Interface*.
+> - `run [SHORTCUT]` - Run a shortcut (e.g. **vvmq**, **eqbcs**, **myseq**). **run** by itself will show a full list.
+>   - `SHORTCUT` - Shortcut to run: vvmq, eqbcs, eq, eqgame, etc.
+>   - `--server` / `-s` - Run for this server this run only, without changing your current server (LIVE, TEST, EMU).
+> - `open [SHORTCUT]` - Open a folder or file (e.g. **downloads**, **eqhost**). **open** by itself will show a full list.
+>   - `SHORTCUT` - Folder/file to open: downloads, vvmq, eq, etc.
+>   - `--server` / `-s` - Resolve paths for this server this run only, without changing your current server (LIVE, TEST, EMU).
+> - `web` - Launch the **RedGuides.com** web interface.
+> - `version` - Show version and exit.
+> - `uninstall` - Uninstall **redfetch** and clean up data.
+> - `logout` - Log out and clear cached token and API cache.
+>
 > ### 🍔 Configuration
-> - `server <SERVER>` - Switch the current server/environment to `LIVE`, `TEST`, or `EMU`
-> - `config <SETTING_PATH> <VALUE>` - Update a setting by path and value
->   - `SETTING_PATH` - Dot-separated setting path (e.g., `SPECIAL_RESOURCES.1974.opt_in`)
+> - `config <SETTING_PATH> <VALUE>` - Update a setting by path and value.
+>   - `SETTING_PATH` - Dot-separated setting path (e.g., SPECIAL_RESOURCES.1974.opt_in)
 >   - `VALUE` - New value for the setting
->   - `--server` / `-s` - Server to apply the change in (`LIVE`, `TEST`, `EMU`)
-> - `status` - Show the configuration for the current or specified server
+>   - `--server` / `-s` - Server to apply the change in (LIVE, TEST, EMU)
+> - `server <SERVER>` - Switch the current server/environment to LIVE, TEST, or EMU.
+>   - `SERVER` - Server to use: LIVE, TEST, EMU
+> - `status` - Show the configuration for the current or specified server.
 >   - `--server` / `-s` - Server to show (defaults to current)
-> 
-> ### 🔧 System & Utilities
-> - `ui` - Launch the Terminal User Interface
-> - `web` - Launch the RedGuides.com web interface
-> - `version` - Show version and exit
-> - `logout` - Disconnect your account from redfetch
-> - `uninstall` - Uninstall redfetch and clean up data
-> 
+>
 > ### 📤 Publishing
-> - `publish <resource_id>` - Publish an update to you or your team's resource. [There's also a github action for this.](https://github.com/marketplace/actions/redguides-publish)
->   - `resource_id` - Existing RedGuides resource ID
->   - `--description <README.md>` / `-d` - Path to a file (e.g. `README.md`) that will become the resource's overview description
->   - `--version <version_number>` / `-v` - New version string (e.g., `v1.0.1`)
->   - `--message <CHANGELOG.md | MESSAGE>` / `-m` - Version update message, a message file (e.g. `message.md` / `message.txt`), or a `CHANGELOG.md` (keep a changelog) file.
+> - `publish <RESOURCE_ID>` - Publish updates to a **RedGuides** resource.
+>   - `RESOURCE_ID` - Existing RedGuides resource ID
+>   - `--description <README.md>` / `-d` - Path to a description file (e.g. README.md) to become the overview description.
+>   - `--version` / `-v` - New version string (e.g., v1.0.1)
+>   - `--message <CHANGELOG.md | MESSAGE>` / `-m` - Path to *CHANGELOG.md* (keep a changelog), other message file, or a direct message string.
 >   - `--file <FILE.zip>` / `-f` - Path to your zipped release file
->   - `--domain <URL>` - Domain to prepend to relative URLs in README.md or CHANGELOG.md files. (mostly for images. e.g., `https://raw.githubusercontent.com/yourusername/yourrepo/main/`)
+>   - `--domain` - If description or message is a .md file with relative URLs, resolve them to this domain (e.g., https://raw.githubusercontent.com/your/repo/main/)
+<!-- END GENERATED CLI REFERENCE -->
+
+The `publish` command also has a [GitHub Action](https://github.com/marketplace/actions/redguides-publish).
 
 ## Settings
 
@@ -163,7 +177,7 @@ opt_in = true
 ```
 * Note the use of single quotes around the path, which are required for windows paths.
 
-The above will install Brewall's maps to the EQ maps directory the next time `--download-watched` is run for `LIVE` servers.
+The above will install Brewall's maps to the EQ maps directory the next time `redfetch update` is run for `LIVE` servers.
 
 ### Overwrite protection
 
@@ -220,14 +234,6 @@ command = ["C:\\Users\\Public\\Python\\python.exe", "C:\\Users\\Public\\redfetch
 
 You can set these per-server, e.g. `[TEST.POST_UPDATE_LAUNCH]`, or global `[DEFAULT.POST_UPDATE_LAUNCH]`.
 
-
-## Trailmap
-- Add custom buttons for "fetch" tab.
-- Option: Close after update
-- Indicate when updated VV is available
-- Run from MQ
-- Deeper integration with the forums
-
 ![Watchers on RedGuides](https://www.redguides.com/community/resources/redfetch.3177/watchers-sparkline?months=12&w=500&h=180)
 
 ## Contributing

{redfetch-1.4.0 → redfetch-1.4.2}/README.md

@@ -61,42 +61,56 @@ To run redfetch from the command line:
 
 ## Command Line Reference
 
-> Run `redfetch --help` or `.\redfetch.exe --help` to see something like this in your terminal:
-> 
+<!-- BEGIN GENERATED CLI REFERENCE -->
+> Run `redfetch --help` for the current list, or `redfetch <COMMAND> --help` for a command's options. It looks like:
+>
 > ### 📦 Resource Management
-> - `update` - Update all watched and special resources
->   - `--force` / `-f` - Force re-download of all watched resources
->   - `--server` / `-s` - Switch to this server before updating (`LIVE`, `TEST`, `EMU`)
-> - `download <ID_OR_URL>` - Download a specific resource by ID or URL
->   - `--force` / `-f` - Force re-download by resetting this resource's download date
->   - `--server` / `-s` - Switch to this server before downloading (`LIVE`, `TEST`, `EMU`)
-> - `list` - List resources and dependencies in the cache database
-> - `reset` - Reset download dates for watched resources
-> 
+> - `update` - Update all *watched* and special resources.
+>   - `--force` / `-f` - Force re-download of all watched resources.
+>   - `--server` / `-s` - Update this server for this run only, without changing your current server (LIVE, TEST, EMU).
+> - `download <ID_OR_URL>` - Download a specific resource by ID or URL.
+>   - `ID_OR_URL` - RedGuides resource ID or URL
+>   - `--force` / `-f` - Force re-download by resetting this resource's download date.
+>   - `--server` / `-s` - Download from this server for this run only, without changing your current server (LIVE, TEST, EMU).
+> - `check` - Non-interactive update check (for automation.)
+>   - `--server` / `-s` - Check this server's env for this run only, without persisting it (LIVE, TEST, EMU).
+> - `list` - List resources and dependencies in your local cache.
+> - `reset` - Reset download dates for *watched resources* in the database.
+>
+> ### 🔧 System & Utilities
+> - `ui` - Launch the *Terminal User Interface*.
+> - `run [SHORTCUT]` - Run a shortcut (e.g. **vvmq**, **eqbcs**, **myseq**). **run** by itself will show a full list.
+>   - `SHORTCUT` - Shortcut to run: vvmq, eqbcs, eq, eqgame, etc.
+>   - `--server` / `-s` - Run for this server this run only, without changing your current server (LIVE, TEST, EMU).
+> - `open [SHORTCUT]` - Open a folder or file (e.g. **downloads**, **eqhost**). **open** by itself will show a full list.
+>   - `SHORTCUT` - Folder/file to open: downloads, vvmq, eq, etc.
+>   - `--server` / `-s` - Resolve paths for this server this run only, without changing your current server (LIVE, TEST, EMU).
+> - `web` - Launch the **RedGuides.com** web interface.
+> - `version` - Show version and exit.
+> - `uninstall` - Uninstall **redfetch** and clean up data.
+> - `logout` - Log out and clear cached token and API cache.
+>
 > ### 🍔 Configuration
-> - `server <SERVER>` - Switch the current server/environment to `LIVE`, `TEST`, or `EMU`
-> - `config <SETTING_PATH> <VALUE>` - Update a setting by path and value
->   - `SETTING_PATH` - Dot-separated setting path (e.g., `SPECIAL_RESOURCES.1974.opt_in`)
+> - `config <SETTING_PATH> <VALUE>` - Update a setting by path and value.
+>   - `SETTING_PATH` - Dot-separated setting path (e.g., SPECIAL_RESOURCES.1974.opt_in)
 >   - `VALUE` - New value for the setting
->   - `--server` / `-s` - Server to apply the change in (`LIVE`, `TEST`, `EMU`)
-> - `status` - Show the configuration for the current or specified server
+>   - `--server` / `-s` - Server to apply the change in (LIVE, TEST, EMU)
+> - `server <SERVER>` - Switch the current server/environment to LIVE, TEST, or EMU.
+>   - `SERVER` - Server to use: LIVE, TEST, EMU
+> - `status` - Show the configuration for the current or specified server.
 >   - `--server` / `-s` - Server to show (defaults to current)
-> 
-> ### 🔧 System & Utilities
-> - `ui` - Launch the Terminal User Interface
-> - `web` - Launch the RedGuides.com web interface
-> - `version` - Show version and exit
-> - `logout` - Disconnect your account from redfetch
-> - `uninstall` - Uninstall redfetch and clean up data
-> 
+>
 > ### 📤 Publishing
-> - `publish <resource_id>` - Publish an update to you or your team's resource. [There's also a github action for this.](https://github.com/marketplace/actions/redguides-publish)
->   - `resource_id` - Existing RedGuides resource ID
->   - `--description <README.md>` / `-d` - Path to a file (e.g. `README.md`) that will become the resource's overview description
->   - `--version <version_number>` / `-v` - New version string (e.g., `v1.0.1`)
->   - `--message <CHANGELOG.md | MESSAGE>` / `-m` - Version update message, a message file (e.g. `message.md` / `message.txt`), or a `CHANGELOG.md` (keep a changelog) file.
+> - `publish <RESOURCE_ID>` - Publish updates to a **RedGuides** resource.
+>   - `RESOURCE_ID` - Existing RedGuides resource ID
+>   - `--description <README.md>` / `-d` - Path to a description file (e.g. README.md) to become the overview description.
+>   - `--version` / `-v` - New version string (e.g., v1.0.1)
+>   - `--message <CHANGELOG.md | MESSAGE>` / `-m` - Path to *CHANGELOG.md* (keep a changelog), other message file, or a direct message string.
 >   - `--file <FILE.zip>` / `-f` - Path to your zipped release file
->   - `--domain <URL>` - Domain to prepend to relative URLs in README.md or CHANGELOG.md files. (mostly for images. e.g., `https://raw.githubusercontent.com/yourusername/yourrepo/main/`)
+>   - `--domain` - If description or message is a .md file with relative URLs, resolve them to this domain (e.g., https://raw.githubusercontent.com/your/repo/main/)
+<!-- END GENERATED CLI REFERENCE -->
+
+The `publish` command also has a [GitHub Action](https://github.com/marketplace/actions/redguides-publish).
 
 ## Settings
 
@@ -119,7 +133,7 @@ opt_in = true
 ```
 * Note the use of single quotes around the path, which are required for windows paths.
 
-The above will install Brewall's maps to the EQ maps directory the next time `--download-watched` is run for `LIVE` servers.
+The above will install Brewall's maps to the EQ maps directory the next time `redfetch update` is run for `LIVE` servers.
 
 ### Overwrite protection
 
@@ -176,14 +190,6 @@ command = ["C:\\Users\\Public\\Python\\python.exe", "C:\\Users\\Public\\redfetch
 
 You can set these per-server, e.g. `[TEST.POST_UPDATE_LAUNCH]`, or global `[DEFAULT.POST_UPDATE_LAUNCH]`.
 
-
-## Trailmap
-- Add custom buttons for "fetch" tab.
-- Option: Close after update
-- Indicate when updated VV is available
-- Run from MQ
-- Deeper integration with the forums
-
 ![Watchers on RedGuides](https://www.redguides.com/community/resources/redfetch.3177/watchers-sparkline?months=12&w=500&h=180)
 
 ## Contributing

{redfetch-1.4.0 → redfetch-1.4.2}/pyproject.toml

@@ -78,3 +78,9 @@ dependencies = [
   "pip-tools",
   "pip-check"
 ]
+
+[tool.hatch.envs.dev.scripts]
+# Regenerate the README 'Command Line Reference' from the typer app.
+gen-docs = "python tests/cli_reference.py --write"
+# Verify it's current
+check-docs = "python tests/cli_reference.py --check"

{redfetch-1.4.0 → redfetch-1.4.2}/src/redfetch/__about__.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '1.4.0'
-__version_tuple__ = version_tuple = (1, 4, 0)
+__version__ = version = '1.4.2'
+__version_tuple__ = version_tuple = (1, 4, 2)
 
 __commit_id__ = commit_id = None

{redfetch-1.4.0 → redfetch-1.4.2}/src/redfetch/config.py

@@ -163,12 +163,40 @@ def initialize_config():
         ]
     )
 
+    self_heal_eqpath()
     write_breadcrumb()
 
     # Return the settings object for potential use
     return settings
 
 
+def self_heal_eqpath() -> None:
+    """Fill a blank or broken EQ PATH from autologin's login.db, per env."""
+    from redfetch import utils, detecteq
+
+    for env in ("LIVE", "TEST", "EMU"):
+        try:
+            env_settings = settings.from_env(env)
+            stored = env_settings.get("EQPATH")
+            if stored and detecteq._is_valid_eq_dir(stored):
+                continue  # heal only when blank or broken
+
+            vvmq_id = utils.get_current_vvmq_id(env)
+            if not vvmq_id:
+                continue
+            vvmq = utils.resolve_special_destination(
+                env_settings.SPECIAL_RESOURCES.get(vvmq_id), env_settings.DOWNLOAD_FOLDER
+            )
+            if not vvmq:
+                continue
+
+            detected = detecteq.read_autologin_eq_path(os.path.join(vvmq, "config"), env)
+            if detected and detected != stored: 
+                update_setting(["EQPATH"], detected, env=env)
+        except Exception:
+            continue  # we're not stopping for this
+
+
 def _resolve_redfetch_executable():
     """PYAPP will give a path when built with PYAPP_PASS_LOCATION=1"""
     pyapp = os.environ.get("PYAPP")

{redfetch-1.4.0 → redfetch-1.4.2}/src/redfetch/detecteq.py

@@ -1,5 +1,7 @@
 import os
+import sqlite3
 import sys
+from pathlib import Path
 
 # Only import winreg on Windows
 if sys.platform == 'win32':
@@ -112,5 +114,29 @@ def find_everquest_uninstall_location():
     return None
 
 
+def read_autologin_eq_path(mq_config_dir: str | None, server_type: str) -> str | None:
+    """from autologin's login.db."""
+    if not mq_config_dir:
+        return None
+    db_path = os.path.join(mq_config_dir, "login.db")
+    if not os.path.isfile(db_path):
+        return None  # autologin maybe hasn't run
+
+    con = None
+    try:
+        con = sqlite3.connect(Path(db_path).as_uri() + "?mode=ro", uri=True)
+        row = con.execute(
+            "SELECT eq_path FROM server_types WHERE type = LOWER(?)", (server_type,)
+        ).fetchone()
+    except (sqlite3.Error, ValueError):
+        return None  # locked or something
+    finally:
+        if con is not None:
+            con.close()
+
+    candidate = row[0] if row else None
+    return os.path.normpath(candidate) if _is_valid_eq_dir(candidate) else None
+
+
 if __name__ == "__main__":
     print(find_everquest_uninstall_location() or "")

{redfetch-1.4.0 → redfetch-1.4.2}/src/redfetch/main.py

@@ -23,6 +23,7 @@ from redfetch import utils
 from redfetch import push
 from redfetch import sync
 from redfetch import store
+from redfetch import shortcuts
 from redfetch.runtime_errors import exit_with_fatal_error
 
 
@@ -53,7 +54,7 @@ def parse_resource_id_or_fail(value: str) -> str:
 
 def _apply_server_override(server: "Optional[Env]" = None) -> None:
     if server is not None and server.value != config.settings.ENV:
-        config.switch_environment(server.value)
+        config.select_environment_in_memory(server.value)
 
 
 def _initialize_auth():
@@ -214,7 +215,7 @@ async def download_command_async(db_name: str, db_path: str, id_or_url: str, for
 )
 def update_command(
     force: bool = typer.Option(False, "--force", "-f", help="Force re-download of all watched resources."),
-    server: Optional[Env] = typer.Option(None, "--server", "-s", case_sensitive=False, help="Switch to this server before updating ([green]LIVE[/green], [yellow]TEST[/yellow], [cyan]EMU[/cyan])."),
+    server: Optional[Env] = typer.Option(None, "--server", "-s", case_sensitive=False, help="Update this server for this run only, without changing your current server ([green]LIVE[/green], [yellow]TEST[/yellow], [cyan]EMU[/cyan])."),
 ):
     db_name, db_path = initialize_db_only(server=server)
     asyncio.run(update_command_async(db_name=db_name, db_path=db_path, force=force))
@@ -228,7 +229,7 @@ def update_command(
 def download(
     id_or_url: str = typer.Argument(..., metavar="ID_OR_URL", help="RedGuides resource ID or URL"),
     force: bool = typer.Option(False, "--force", "-f", help="Force re-download by resetting this resource's download date."),
-    server: Optional[Env] = typer.Option(None, "--server", "-s", case_sensitive=False, help="Switch to this server type before downloading ([green]LIVE[/green], [yellow]TEST[/yellow], [cyan]EMU[/cyan])."),
+    server: Optional[Env] = typer.Option(None, "--server", "-s", case_sensitive=False, help="Download from this server for this run only, without changing your current server ([green]LIVE[/green], [yellow]TEST[/yellow], [cyan]EMU[/cyan])."),
 ):
     db_name, db_path = initialize_db_only(server=server)
     asyncio.run(download_command_async(db_name=db_name, db_path=db_path, id_or_url=id_or_url, force=force))
@@ -249,8 +250,7 @@ def _has_auth_credentials() -> bool:
 @app.command(
     "check",
     help=(
-        "Non-interactive update check. Writes [bold]update_status.json[/bold] for the env "
-        "(exit 0=wrote a verdict, 1=transient failure)."
+        "Non-interactive update check (for automation.)"
     ),
     rich_help_panel="📦 Resource Management",
 )
@@ -329,6 +329,74 @@ def run_tui():
     run_textual_ui()
 
 
+def _print_shortcut_table(entries, available) -> None:
+    """List shortcuts (key, aliases, availability) for the bare `run`/`open` verb."""
+    from rich.table import Table
+
+    # ASCII-only content for legacy Windows consoles
+    table = Table(show_header=True, header_style="bold")
+    table.add_column("shortcut")
+    table.add_column("aliases", style="dim")
+    table.add_column("available", justify="center")
+    table.add_column("description", style="dim")
+    for entry in entries:
+        mark = "[green]yes[/green]" if available(entry) else "[dim]no[/dim]"
+        table.add_row(entry.key, ", ".join(entry.aliases) or "-", mark, entry.tooltip)
+    console.print(table)
+
+
+@app.command(
+    "run",
+    help="Run a shortcut (e.g. [bold]vvmq[/bold], [bold]eqbcs[/bold], [bold]myseq[/bold]). [bold]run[/bold] by itself will show a full list.",
+    rich_help_panel="🔧 System & Utilities",
+)
+def run_shortcut_command(
+    target: Optional[str] = typer.Argument(None, metavar="SHORTCUT", help="Shortcut to run: vvmq, eqbcs, eq, eqgame, etc."),
+    server: Optional[Env] = typer.Option(None, "--server", "-s", case_sensitive=False, help="Run for this server this run only, without changing your current server ([green]LIVE[/green], [yellow]TEST[/yellow], [cyan]EMU[/cyan])."),
+):
+    config.initialize_config()
+    _apply_server_override(server)
+    if target is None:
+        _print_shortcut_table(shortcuts.RUNNABLES, shortcuts.runnable_available)
+        return
+    runnable = shortcuts.find_runnable(target)
+    if runnable is None:
+        valid = ", ".join(r.key for r in shortcuts.RUNNABLES)
+        raise typer.BadParameter(f"Unknown shortcut '{target}'. Try: {valid}")
+    try:
+        shortcuts.run(runnable)
+        console.print(f"Started [bold]{runnable.executable}[/bold].")
+    except (ValueError, RuntimeError, OSError) as exc:
+        console.print(f"[red]Couldn't run {runnable.key}:[/red] {exc}")
+        raise typer.Exit(1)
+
+
+@app.command(
+    "open",
+    help="Open a folder or file (e.g. [bold]downloads[/bold], [bold]eqhost[/bold]). [bold]open[/bold] by itself will show a full list.",
+    rich_help_panel="🔧 System & Utilities",
+)
+def open_shortcut_command(
+    target: Optional[str] = typer.Argument(None, metavar="SHORTCUT", help="Folder/file to open: downloads, vvmq, eq, etc."),
+    server: Optional[Env] = typer.Option(None, "--server", "-s", case_sensitive=False, help="Resolve paths for this server this run only, without changing your current server ([green]LIVE[/green], [yellow]TEST[/yellow], [cyan]EMU[/cyan])."),
+):
+    config.initialize_config()
+    _apply_server_override(server)
+    if target is None:
+        _print_shortcut_table(shortcuts.OPENABLES, shortcuts.openable_available)
+        return
+    openable = shortcuts.find_openable(target)
+    if openable is None:
+        valid = ", ".join(o.key for o in shortcuts.OPENABLES)
+        raise typer.BadParameter(f"Unknown shortcut '{target}'. Try: {valid}")
+    try:
+        detail = shortcuts.open_target(openable)
+        console.print(f"Opened [bold]{openable.key}[/bold]{(' ' + detail) if detail else ''}.")
+    except (ValueError, OSError) as exc:
+        console.print(f"[red]Couldn't open {openable.key}:[/red] {exc}")
+        raise typer.Exit(1)
+
+
 @app.command(
     "web",
     help="Launch the [bold]RedGuides.com[/bold] web interface.",
@@ -352,7 +420,7 @@ async def web_command_async(db_name: str) -> None:
 
 @app.command(
     "list",
-    help="List resources and dependencies currently in the cache database.",
+    help="List resources and dependencies in your local cache.",
     rich_help_panel="📦 Resource Management"
 )
 def resources_list_command():
@@ -628,6 +696,9 @@ def main():
         if len(sys.argv) == 1:
             run_tui()
             return
+        # `redfetch help` → show top-level help 
+        if len(sys.argv) == 2 and sys.argv[1] == "help":
+            sys.argv[1] = "--help"
         app()
     except typer.Exit:
         raise

{redfetch-1.4.0 → redfetch-1.4.2}/src/redfetch/post_update.py

@@ -1,4 +1,4 @@
-"""Post-update policy: does a staged update need a restart to go live?"""
+"""Post-update launch/restart policy for completed sync runs."""
 
 from __future__ import annotations
 
@@ -25,19 +25,19 @@ ColdStartChoice = Literal["yes", "no", "always", "never"]
 
 
 class PostUpdateSurface(Protocol):
-    """This is what the UIs implement."""
+    """UI callbacks used by the post-update workflow."""
     def notify(self, message: str, *, error: bool = False) -> None: ...
     async def confirm_restart(self) -> bool: ...
     async def ask_cold_start(self) -> ColdStartChoice: ...
-    def auto_run_persisted(self, value: bool) -> None: ...  # UI sync only; the write already happened
+    def auto_run_persisted(self, value: bool) -> None: ...  # Refresh UI state; the write already happened.
     async def wait_for_eq_close(self) -> bool: ...
 
 
 def decide(outcome: SyncOutcome, *, mq_running: bool) -> Decision:
-    """Only a VVMQ/loader update gets an offer, anything else needs a manual restart."""
-    if not outcome.vvmq_updated:
-        return Decision.NONE
-    return Decision.RESTART if mq_running else Decision.COLD_START
+    """Return the restart, cold-start, or no-op decision."""
+    if mq_running:
+        return Decision.RESTART if outcome.vvmq_updated else Decision.NONE
+    return Decision.COLD_START if (outcome.success or outcome.vvmq_updated) else Decision.NONE
 
 
 @dataclass(frozen=True, slots=True)
@@ -48,12 +48,12 @@ class PendingOffer:
 
 
 async def prepare(outcome: SyncOutcome) -> PendingOffer:
-    """Scan and decide — call while the caller still has the UI gated (env, re-clicks)."""
+    """Scan process state and build the pending post-update offer."""
     if (
         sys.platform != "win32"
         or os.environ.get("CI") == "true"
-        # decide()'s NONE clause, duplicated so the common no-offer run skips the scan
-        or not outcome.vvmq_updated
+        # Avoid process scans when the run failed before writing anything useful.
+        or not (outcome.success or outcome.vvmq_updated)
     ):
         return PendingOffer(Decision.NONE, None, None)
     running = await asyncio.to_thread(processes.running_executable_paths)
@@ -67,20 +67,22 @@ async def offer(outcome, surface: PostUpdateSurface) -> None:
 
 
 async def execute(pending: PendingOffer, surface: PostUpdateSurface) -> None:
-    # prepare() is the only producer; platform/CI gating already happened there
+    # prepare() already handled platform and CI gating.
     if pending.decision is Decision.NONE:
         return
     mq_folder = pending.mq_folder
     if not mq_folder:
-        surface.notify("MacroQuest path not found. Please check your configuration.", error=True)
+        # Cold starts without a folder have nothing to launch.
+        if pending.decision is Decision.RESTART:
+            surface.notify("MacroQuest path not found. Please check your configuration.", error=True)
         return
 
     if pending.decision is Decision.RESTART:
-        # a restart always asks; AUTO_RUN_VVMQ governs cold starts only
+        # Restarts always ask; AUTO_RUN_VVMQ only applies to cold starts.
         if not await surface.confirm_restart():
             surface.notify("The update will apply next time MacroQuest starts.")
             return
-        # never touch the live game: the user closes EQ or the restart is skipped
+        # Do not restart MQ while EverQuest is running.
         if await asyncio.to_thread(processes.get_eqgame_process_pids):
             if not await surface.wait_for_eq_close():
                 surface.notify("Restart skipped; the update will apply next time MacroQuest starts.")
@@ -94,12 +96,12 @@ async def execute(pending: PendingOffer, surface: PostUpdateSurface) -> None:
                 error=True,
             )
             return
-        # rescan: the restart closed the folder's processes; the old snapshot would skip them
+        # Rescan so loadout filtering sees the current process list.
         running = await asyncio.to_thread(processes.running_executable_paths)
     else:
         if not await _cold_start_consent(surface):
             return
-        # rescan: the user may have started MQ while the prompt sat open
+        # Rescan in case MQ was started while the prompt was open.
         running = await asyncio.to_thread(processes.running_executable_paths)
         if not utils.should_offer_mq_start(running):
             surface.notify("MacroQuest is already running; skipping the start.")
@@ -121,7 +123,7 @@ def _launch_loadout(surface: PostUpdateSurface, running: set[str] | None) -> Non
         try:
             processes.run_command(command, cwd)
         except Exception as exc:
-            # a typo'd custom command must not kill the rest of the batch (or the CLI)
+            # A bad custom command should not stop the remaining launch commands.
             label = os.path.basename(utils._command_program(command)) or "post-update program"
             surface.notify(f"Failed to start {label}: {exc}", error=True)
 
@@ -134,7 +136,7 @@ async def _cold_start_consent(surface: PostUpdateSurface) -> bool:
     if choice in ("always", "never"):
         value = choice == "always"
         config.update_setting(["AUTO_RUN_VVMQ"], value)
-        surface.notify(f"Updated settings to {'always' if value else 'never'} start MacroQuest after updates.")
+        surface.notify(f"Updated settings to {'always' if value else 'never'} start MacroQuest after an update run.")
         surface.auto_run_persisted(value)
     elif choice == "no":
         surface.notify("Not starting MacroQuest.")