Address PR MFlowCode#1038 feedback: standardize Homebrew command syntax

- Use shorthand 'mfc case.py' consistently across all documentation
- Clarify that both 'mfc case.py' and 'mfc run case.py' work
- Update README.md, packaging/homebrew/README.md, getting-started.md, and running.md
- Improves consistency and showcases the smart detection feature

Addresses Copilot AI review comment about documentation inconsistency

Author: sbryngelson

README.md

@@ -146,10 +146,10 @@ Install the prebuilt package and run an example:
 brew install mflowcode/mfc/mfc
 mkdir -p ~/mfc_quickstart && cd ~/mfc_quickstart
 cp $(brew --prefix mfc)/examples/1D_sodshocktube/case.py .
-mfc run case.py -n 2
+mfc case.py -n 2
 ```
 
-Use `-n X` to select the number of MPI processes. For developer commands (`build`, `test`, etc.), clone the repo and use `./mfc.sh`.
+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`.
 
 ### macOS from source
 

docs/documentation/getting-started.md

@@ -23,11 +23,12 @@ Run a quick example:
 mkdir -p ~/mfc_quickstart && cd ~/mfc_quickstart
 cp $(brew --prefix mfc)/examples/1D_sodshocktube/case.py .
 # Use -n X to choose the number of MPI processes
-mfc run case.py -n 2
+mfc case.py -n 2
 ```
 
 Notes:
-- The Homebrew wrapper supports only `mfc run ...`. Developer commands like `build`, `test`, `clean` are available when you clone the repo and use `./mfc.sh`.
+- Both `mfc case.py` and `mfc run case.py` work (shorthand auto-detects case files).
+- 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

@@ -13,11 +13,13 @@ several supercomputer clusters, both interactively and through batch submission.
 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).
-- Only the `run` command is supported in the Homebrew wrapper.
+- Both `mfc case.py` and `mfc run case.py` work (shorthand auto-detects case files).
 - 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

@@ -15,7 +15,7 @@ Run the 1D Sod shock tube example:
 ```bash
 mkdir -p ~/mfc_example && cd ~/mfc_example
 cp $(brew --prefix mfc)/examples/1D_sodshocktube/case.py .
-mfc run case.py -n 2
+mfc case.py -n 2
 ```
 
 ## What's Included
@@ -28,12 +28,14 @@ mfc run case.py -n 2
 ## Usage
 
 ```bash
+mfc <case.py> -n <processes>
+# or explicitly:
 mfc run <case.py> -n <processes>
 ```
 
-Use `-n X` to set the number of MPI processes.
+Use `-n X` to set the number of MPI processes. Both syntaxes work (the shorthand version auto-detects case files).
 
-**Note**: The Homebrew wrapper supports only `mfc run`. For developer commands (`build`, `test`, `clean`, etc.), [clone the repository](https://github.com/MFlowCode/MFC) and use `./mfc.sh`.
+**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`.
 
 ## Documentation