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/01_generate_yamls.sh

@@ -137,10 +137,12 @@ fi
 
 rm -f "$FAILURES_FILE"
 
-# Build service_spec_gen binary if missing.
-if [[ ! -x "${ROOT_DIR}/TOOLS/bin/yaml-generator" ]]; then
-  echo "Building service_spec_gen..."
-  # Binary pre-built in TOOLS/bin/yaml-generator
+# Auto-rebuild yaml-generator if sources are newer than binary
+BIN="${ROOT_DIR}/TOOLS/bin/yaml-generator"
+SRC="${ROOT_DIR}/TOOLS/yaml-generator/"
+if [[ ! -x "$BIN" ]] || [[ "$SRC" -nt "$BIN" ]]; then
+  echo "Building yaml-generator..."
+  (cd "${ROOT_DIR}/TOOLS/yaml-generator" && go build -o "$BIN" .)
 fi
 
 # Проверка что список сервисов не пустой