Simplify Homebrew wrapper: remove redundant 'mfc run' syntax

- Remove smart detection logic - wrapper now only accepts 'mfc <case.py>'
- Simplify help text and error handling
- Update all documentation to remove mentions of 'mfc run'
- Cleaner UX: one way to do things, no confusion

The wrapper always prepends 'run' internally, but users only need to
know the simple 'mfc <case.py>' syntax.

Author: sbryngelson

README.md

@@ -149,7 +149,7 @@ cp $(brew --prefix mfc)/examples/1D_sodshocktube/case.py .
 mfc case.py -n 2
 ```
 
-Use `-n X` to select the number of MPI processes. Both `mfc case.py` and `mfc run case.py` work. For developer commands (`build`, `test`, etc.), clone the repo and use `./mfc.sh`.
+Use `-n X` to select the number of MPI processes. For developer commands (`build`, `test`, etc.), clone the repo and use `./mfc.sh`.
 
 ### macOS from source
 

docs/documentation/getting-started.md

@@ -27,7 +27,7 @@ mfc case.py -n 2
 ```
 
 Notes:
-- Both `mfc case.py` and `mfc run case.py` work (shorthand auto-detects case files).
+- The Homebrew package uses a simplified syntax: just `mfc <case.py>` to run cases.
 - Developer commands like `build`, `test`, `clean` are available when you clone the repo and use `./mfc.sh`.
 - The package bundles a Python venv and prebuilt binaries; no additional setup is required.
 - Examples are installed at `$(brew --prefix mfc)/examples/`.

docs/documentation/running.md

@@ -14,12 +14,10 @@ If you installed MFC via Homebrew, run cases with the `mfc` wrapper:
 
 ```bash
 mfc <path/to/case.py> -n 2
-# or explicitly:
-mfc run <path/to/case.py> -n 2
 ```
 
 - Use `-n X` to control the number of MPI processes (ranks).
-- Both `mfc case.py` and `mfc run case.py` work (shorthand auto-detects case files).
+- The Homebrew package uses a simplified syntax: just `mfc <case.py>` to run cases.
 - To use developer commands (`build`, `test`, `clean`, etc.), clone the repository and use `./mfc.sh`.
 - The wrapper passes through runtime flags like `-t pre_process simulation`, `-n`, and others; it always runs with preinstalled binaries.
 - Examples live at `$(brew --prefix mfc)/examples/`.

packaging/homebrew/README.md

@@ -29,11 +29,9 @@ mfc case.py -n 2
 
 ```bash
 mfc <case.py> -n <processes>
-# or explicitly:
-mfc run <case.py> -n <processes>
 ```
 
-Use `-n X` to set the number of MPI processes. Both syntaxes work (the shorthand version auto-detects case files).
+Use `-n X` to set the number of MPI processes.
 
 **Note**: The Homebrew wrapper supports only running cases. For developer commands (`build`, `test`, `clean`, etc.), [clone the repository](https://github.com/MFlowCode/MFC) and use `./mfc.sh`.
 

packaging/homebrew/mfc.rb

@@ -94,20 +94,17 @@ def install
           fi
         done
 
-        SUBCMD="${ARGS[0]-}"
-
         # Friendly help and guardrails
-        if [[ ${#ARGS[@]} -eq 0 ]] || [[ "${SUBCMD}" == "--help" ]] || [[ "${SUBCMD}" == "-h" ]]; then
+        if [[ ${#ARGS[@]} -eq 0 ]] || [[ "${ARGS[0]-}" == "--help" ]] || [[ "${ARGS[0]-}" == "-h" ]]; then
           cat <<'HHELP'
       MFC (Homebrew) #{version}
 
       Usage:
         mfc <case.py> [options]
-        mfc run <case.py> [options]
 
       Examples:
         mfc case.py -n 2
-        mfc run case.py -n 2 -t pre_process simulation
+        mfc examples/1D_sodshocktube/case.py -n 2 -t pre_process simulation
 
       Notes:
         - This Homebrew wrapper uses prebuilt binaries and a preinstalled venv.
@@ -117,17 +114,8 @@ def install
           exit 0
         fi
 
-        # Smart detection: if first arg looks like a case file, auto-prepend "run"
-        if [[ "${SUBCMD}" =~ .py$ ]] || [[ -f "${SUBCMD}" ]]; then
-          ARGS=("run" "${ARGS[@]}")
-          SUBCMD="run"
-        fi
-
-        if [[ "${SUBCMD}" != "run" ]]; then
-          echo "mfc (Homebrew): only 'run' is supported in the Homebrew package."
-          echo "Use 'mfc <case.py>' or clone the repository for developer commands."
-          exit 2
-        fi
+        # Always prepend "run" since this wrapper only supports running cases
+        ARGS=("run" "${ARGS[@]}")
 
         # Create a temporary working directory (Cellar is read-only)
         TMPDIR="$(mktemp -d)"
@@ -226,8 +214,7 @@ def caveats
       MFC has been installed successfully!
 
       To run a case:
-        mfc <case.py>
-        mfc run <case.py>  (explicit form)
+        mfc <case.py> [options]
 
       Pre-built binaries are also available directly:
         pre_process, simulation, post_process