fix: architectural improvements per Opus analysis

1. Version sync: provider/main.go = profile.env = 5.0.60
2. docs-generator: removed detectVersion() — no more dependency on provider/
3. docs-generator: removed detectRoot(), pickPath() — all paths via flags/env
4. docs-generator: require --version, --resources, --docs flags
5. Auto-rebuild: yaml-generator rebuilds if sources newer than binary
6. Three version vars → one VERSION in profile.env
7. Created TOOLS/lib/ — shared YAML contract types (not yet integrated)

TOOLS/scripts/03_build_and_upload_provider.sh

@@ -100,7 +100,7 @@ load_s3cfg_registry() {
 
 VERSION="${1:-}"
 if [[ -z "$VERSION" ]]; then
-  VERSION="${PROVIDER_VERSION:-${RELEASE_VERSION:-}}"
+  VERSION="${VERSION:-}"
 fi
 if [[ -z "$VERSION" ]]; then
   VERSION=$(grep -E 'version string' "$PROVIDER_MAIN" | sed -E 's/.*"([0-9.]+)".*/\1/')