Rename tools and docs to vmt-* prefix, update docs

Renamed all user-facing tools and documentation references from legacy names (e.g., qbsp, vis, light, maputil, lightpreview) to the new vmt-* naming convention (e.g., vmt-bsp, vmt-vis, vmt-light, vmt-maputil, vmt-lightpreview). Updated CMake targets, install rules, and documentation to match. Expanded and modernized documentation to clarify the transition from ericw-tools, added migration notes, and improved build and usage instructions.

Author: themuffinator

AGENTS.md

@@ -1,7 +1,12 @@
-# AGENTS.md
+# AGENTS.md
 
 Instructions for AI coding agents working on VibeyMapTools.
 
+## Philosophy
+
+- Documentation should be playful and emoji-rich when brevity is not required, while staying technically accurate.
+- When touching user-facing docs, include a short "coming from ericw-tools" note to orient legacy users.
+
 ## Project Overview
 
 VibeyMapTools (VMT) is a BSP compilation toolset for Quake engine mapping. It is a fork of [ericw-tools](https://github.com/ericwa/ericw-tools) with rebranding and modernization.
@@ -10,38 +15,38 @@ VibeyMapTools (VMT) is a BSP compilation toolset for Quake engine mapping. It is
 
 | Tool | Purpose | Source Directory |
 |------|---------|------------------|
-| `vmt-bsp` | BSP compiler (.map → .bsp) | `src/qbsp/` |
+| `vmt-bsp` | BSP compiler (.map -> .bsp) | `src/qbsp/` |
 | `vmt-vis` | Visibility compiler (PVS) | `src/vis/` |
 | `vmt-light` | Lighting compiler (lightmaps) | `src/light/` |
 | `vmt-bspinfo` | BSP information utility | `src/bspinfo/` |
 | `vmt-bsputil` | BSP manipulation utility | `src/bsputil/` |
-| `maputil` | Map file Lua scripting | `src/maputil/` |
-| `lightpreview` | Real-time preview GUI | `src/lightpreview/` |
+| `vmt-maputil` | Map file Lua scripting | `src/maputil/` |
+| `vmt-lightpreview` | Real-time preview GUI | `src/lightpreview/` |
 
 ## Repository Structure
 
 ```
 VibeyMapTools/
-├── .github/        # CI workflows, templates
-├── extern/         # Third-party dependencies (submodules)
-├── assets/         # Images, branding
-├── cmake/          # CMake modules
-├── docs/           # Sphinx documentation (.rst files)
-├── scripts/        # Build and utility scripts
-├── src/            # All source code
-│   ├── common/     # Shared library code
-│   ├── include/    # Public headers
-│   ├── qbsp/       # vmt-bsp source
-│   ├── vis/        # vmt-vis source
-│   ├── light/      # vmt-light source
-│   ├── bspinfo/    # vmt-bspinfo source
-│   ├── bsputil/    # vmt-bsputil source
-│   ├── maputil/    # maputil source
-│   └── lightpreview/ # Qt-based preview tool
-├── tests/          # Test suite (maps/ subdirectory contains test .map files)
-├── CMakeLists.txt
-├── README.md
-└── ... (other root files)
+|-- .github/        # CI workflows, templates
+|-- extern/         # Third-party dependencies (submodules)
+|-- assets/         # Images, branding
+|-- cmake/          # CMake modules
+|-- docs/           # Sphinx documentation (.rst files)
+|-- scripts/        # Build and utility scripts
+|-- src/            # All source code
+|   |-- common/     # Shared library code
+|   |-- include/    # Public headers
+|   |-- qbsp/       # vmt-bsp source
+|   |-- vis/        # vmt-vis source
+|   |-- light/      # vmt-light source
+|   |-- bspinfo/    # vmt-bspinfo source
+|   |-- bsputil/    # vmt-bsputil source
+|   |-- maputil/    # vmt-maputil source
+|   `-- lightpreview/ # vmt-lightpreview tool
+|-- tests/          # Test suite (maps/ subdirectory contains test .map files)
+|-- CMakeLists.txt
+|-- README.md
+`-- ... (other root files)
 ```
 
 ## Build System
@@ -56,11 +61,14 @@ The project uses CMake with the following key variables:
 
 # Optional features
 -DENABLE_LIGHTPREVIEW=YES|NO    # Qt6 GUI tool
--DERICWTOOLS_ASAN=YES|NO        # Address sanitizer
+-DDISABLE_TESTS=ON|OFF          # Skip tests
+-DDISABLE_DOCS=ON|OFF           # Skip docs
+-DVIBEYMAPTOOLS_ASAN=YES|NO     # Address sanitizer
+-DVIBEYMAPTOOLS_TIMETRACE=YES|NO # Clang time trace
 
 # Dependencies (auto-detected if installed)
--Dembree_DIR=/path/to/embree
--DTBB_DIR=/path/to/tbb
+-Dembree_DIR=/path/to/embree/lib/cmake/embree-4.x
+-DTBB_DIR=/path/to/tbb/lib/cmake/tbb
 ```
 
 ### Building
@@ -79,9 +87,8 @@ cmake --build build --target package
 
 ### Dependencies
 
-- **Required**: C++20 compiler, CMake 3.14+
-- **Recommended**: Intel Embree 4.x, oneTBB
-- **Optional**: Qt6 (for lightpreview), CUDA/OptiX (GPU lighting), Intel OIDN (denoising)
+- **Required**: C++20 compiler, CMake 3.14+, Intel Embree 4.x, oneTBB
+- **Optional**: Qt6 (for vmt-lightpreview), CUDA/OptiX (GPU lighting), Intel OIDN (denoising)
 
 ## Code Conventions
 
@@ -142,14 +149,14 @@ cd docs && make html
 
 ### Key Documentation Files
 
-| File | Purpose |
-|------|---------|
-| `README.md` | Project overview |
-| `WIKI.md` | Documentation hub |
-| `CHANGELOG.md` | Version history |
-| `BUILDING.md` | Build instructions |
-| `CONTRIBUTING.md` | Contribution guide |
-| `docs/*.rst` | Tool reference docs |
+| File | Purpose | When to Update |
+|------|---------|----------------|
+| `README.md` | Project overview | When features or user story changes |
+| `WIKI.md` | Documentation hub | When adding docs or new tools |
+| `CHANGELOG.md` | Version history | Every PR with user-visible changes |
+| `BUILDING.md` | Build instructions | When build or dependency steps change |
+| `CONTRIBUTING.md` | Contribution guide | When contribution flow changes |
+| `docs/*.rst` | Tool reference docs | When CLI flags or behaviors change |
 
 ## Making Changes
 
@@ -183,6 +190,11 @@ cd docs && make html
 2. Document in `docs/<tool>.rst` under appropriate section
 3. Use existing key/value parsing patterns
 
+## Versioning
+
+VibeyMapTools uses Semantic Versioning. The `VERSION` file stores the base (next) version, and release tags `vMAJOR.MINOR.PATCH` are the source of truth.
+CMake generates `version.hh` in `build/include` for compile-time version info.
+
 ## CI/CD
 
 ### GitHub Actions
@@ -208,10 +220,10 @@ cd docs && make html
 
 ## Gotchas
 
-- **Tool naming**: Executables use `vmt-` prefix, but source directories don't (e.g., `src/qbsp/` builds `vmt-bsp`)
+- **Tool naming**: Executables use `vmt-` prefix, but source directories do not (e.g., `src/qbsp/` builds `vmt-bsp`)
 - **Submodules**: Run `git submodule update --init --recursive` after cloning
-- **Qt6**: Only needed for `lightpreview`, disabled by default
-- **Embree/TBB**: Auto-downloaded on some platforms, may need manual install on others
+- **Qt6**: Only needed for `vmt-lightpreview`, disabled by default
+- **Embree/TBB**: Required dependencies; set `embree_DIR`/`TBB_DIR` if CMake cannot find them
 
 ## Contact