chore: release v1.9.4 — fix README.MD casing in release workflow

Author: Thavarshan

.github/copilot-instructions.md

@@ -0,0 +1,48 @@
+# Copilot Instructions for phpvm
+
+## Project Context
+
+phpvm is a PHP Version Manager written as a single bash script (`phpvm.sh`). It supports macOS (Homebrew) and Linux (apt, dnf, yum, pacman). Tests use BATS.
+
+## Code Style
+
+- POSIX-compliant bash where possible
+- All global variables must be prefixed with `PHPVM_` to avoid namespace pollution when sourced
+- Use `command` prefix for external commands (e.g., `command grep`, `command awk`)
+- Use `printf '%s\n'` instead of `echo` when piping variable content to avoid `-n`/`-e` interpretation
+- Use `if/then/fi` instead of `[ test ] && cmd` for functions that must return 0 on success
+- Use `while IFS= read -r` loops instead of `for x in $(...)` to avoid word-splitting issues
+- Prefer `command_exists` helper over inline `command -v X > /dev/null 2>&1`
+
+## Testing
+
+```bash
+bash -n phpvm.sh          # Syntax check
+bats tests/               # Run all tests
+bats tests/01_core.bats   # Run specific test file
+```
+
+Tests run in isolated mock environments with `PHPVM_TEST_MODE=true`.
+
+## Release Procedure
+
+Conventions: tag = `X.Y.Z` (no `v` prefix), title = `vX.Y.Z` (with `v` prefix).
+
+1. Bump `PHPVM_VERSION` in `phpvm.sh`
+2. Add entry to `CHANGELOG.md` under `[Unreleased]` with format:
+   ```
+   ## [vX.Y.Z](https://github.com/Thavarshan/phpvm/compare/vPREV...vX.Y.Z) - YYYY-MM-DD
+   ```
+3. Run `bash -n phpvm.sh && bats tests/` — all tests must pass
+4. Commit: `git commit -m "chore: release vX.Y.Z — short description"`
+5. Push: `git push origin main`
+6. Create release: `gh release create X.Y.Z --title "vX.Y.Z" --notes-file <file>`
+   - Use `--notes-file` for multi-line notes to avoid shell quoting issues
+
+## Key Environment Variables
+
+- `PHPVM_DIR` — Installation directory (default: `~/.phpvm`)
+- `PHPVM_TEST_MODE` — Enable test/mock mode
+- `DEBUG` — Enable debug logging
+- `PHPVM_AUTO_USE` — Enable automatic `.phpvmrc` detection
+- `PHPVM_PHPVMRC_MAX_DEPTH` — Max parent directory traversal for `.phpvmrc` (default: 25)

.github/workflows/release.yml

@@ -22,7 +22,7 @@ jobs:
           required_files=(
             "phpvm.sh"
             "install.sh"
-            "README.MD"
+            "README.md"
             "CHANGELOG.md"
             "LICENSE"
           )
@@ -63,7 +63,7 @@ jobs:
           sections=("Installation" "Usage" "Commands")
 
           for section in "${sections[@]}"; do
-            if grep -qi "$section" README.MD; then
+            if grep -qi "$section" README.md; then
               echo "✓ README contains $section section"
             else
               echo "⚠ README might be missing $section section"
@@ -89,7 +89,7 @@ jobs:
           mkdir -p dist
           cp phpvm.sh dist/
           cp install.sh dist/
-          cp README.MD dist/
+          cp README.md dist/
           cp LICENSE dist/
           cp CHANGELOG.md dist/
 

CHANGELOG.md

@@ -2,6 +2,17 @@
 
 ## [Unreleased]
 
+## [v1.9.4](https://github.com/Thavarshan/phpvm/compare/v1.9.3...v1.9.4) - 2026-03-15
+
+### Fixed
+
+- **Fixed `README.MD` → `README.md` casing in `release.yml`:** The release workflow referenced `README.MD` but the file is `README.md`, causing CI failures on case-sensitive Linux filesystems.
+- **Fixed `README.MD` → `README.md` casing in `CLAUDE.md` file structure diagram.**
+
+### Internal
+
+- **Version bump:** Updated to v1.9.4.
+
 ## [v1.9.3](https://github.com/Thavarshan/phpvm/compare/v1.9.2...v1.9.3) - 2026-03-15
 
 ### Fixed

CLAUDE.md

@@ -116,11 +116,32 @@ time ./phpvm.sh help
 ```
 
 ### Release Process
-1. Update version number in `PHPVM_VERSION` variable
-2. Update CHANGELOG.md with new features/fixes
-3. Test across different platforms
-4. Ensure all tests pass
-5. Update README.md if needed
+
+Conventions: tag = `X.Y.Z` (no `v` prefix), title = `vX.Y.Z` (with `v` prefix).
+
+1. **Bump version** in `PHPVM_VERSION` variable at the top of `phpvm.sh`
+2. **Update CHANGELOG.md** — add a new section under `[Unreleased]` following the existing format:
+   ```
+   ## [vX.Y.Z](https://github.com/Thavarshan/phpvm/compare/vPREV...vX.Y.Z) - YYYY-MM-DD
+   ```
+   Use subsections: `### Fixed`, `### Changed`, `### Removed`, `### Internal` as needed.
+3. **Verify syntax and tests pass:**
+   ```bash
+   bash -n phpvm.sh
+   bats tests/
+   ```
+4. **Commit and push:**
+   ```bash
+   git add phpvm.sh CHANGELOG.md
+   git commit -m "chore: release vX.Y.Z — short description"
+   git push origin main
+   ```
+5. **Create GitHub release** (triggers the `release.yml` workflow):
+   ```bash
+   gh release create X.Y.Z --title "vX.Y.Z" --notes-file /path/to/notes.md
+   ```
+   Or use `--notes "..."` for short notes. Prefer `--notes-file` for multi-line content to avoid shell quoting issues.
+6. **Update README.md** if needed (new features, changed env vars, etc.)
 
 ## Key Functions in phpvm.sh
 
@@ -139,7 +160,7 @@ phpvm/
 ├── CLAUDE.md          # This file
 ├── CHANGELOG.md       # Release history
 ├── LICENSE           # MIT license
-├── README.MD         # User documentation
+├── README.md         # User documentation
 ├── TESTING.md        # Testing documentation (minimal)
 ├── assets/           # Project images
 ├── install-bats.sh   # BATS installation script

phpvm.sh

@@ -11,7 +11,7 @@
 
 # shellcheck disable=SC2155  # Allow declare and assign on same line for better readability
 
-PHPVM_VERSION="1.9.3"
+PHPVM_VERSION="1.9.4"
 
 # Test mode flag
 PHPVM_TEST_MODE="${PHPVM_TEST_MODE:-false}"