chore: add usdasm fetch helper

.gitignore

@@ -75,6 +75,7 @@ src/lib/cmake/
 src/lib/GL/
 src/lib/libpng/
 src/lib/zlib/
+assets/asm/usdasm/
 src/app/gui/modules/component.h
 src/ios/macOS/Info-macOS.plist
 src/ios/macOS/MainMenu.storyboard

docs/internal/debug/ai_asm_guide.md

@@ -24,6 +24,13 @@ z3ed emu start --rom oracle_of_secrets.sfc --grpc-port 50051
 
 Load symbols from your ASM source directory for meaningful labels:
 
+If you need the vanilla usdasm disassembly, fetch it on demand:
+
+```bash
+scripts/fetch_usdasm.sh
+# or: USDASM_DIR=/path/to/usdasm scripts/fetch_usdasm.sh
+```
+
 ```protobuf
 rpc LoadSymbols(SymbolFileRequest) returns (CommandResponse)
 

scripts/README.md

@@ -2,6 +2,15 @@
 
 This directory contains build automation and maintenance scripts for the YAZE project.
 
+## fetch_usdasm.sh
+
+Fetch the usdasm disassembly on demand (not vendored in the repo).
+
+```bash
+scripts/fetch_usdasm.sh
+# or: USDASM_DIR=/path/to/usdasm scripts/fetch_usdasm.sh
+```
+
 ## build_cleaner.py
 
 Automates CMake source list maintenance and header include management with IWYU-style analysis.

scripts/fetch_usdasm.sh

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO_URL="${USDASM_REPO_URL:-https://github.com/spannerisms/usdasm.git}"
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+TARGET_DIR="${USDASM_DIR:-$ROOT_DIR/assets/asm/usdasm}"
+
+if [ -d "$TARGET_DIR/.git" ]; then
+  echo "usdasm already present at $TARGET_DIR"
+  exit 0
+fi
+
+if [ -e "$TARGET_DIR" ]; then
+  echo "Removing existing path at $TARGET_DIR"
+  rm -rf "$TARGET_DIR"
+fi
+
+mkdir -p "$(dirname "$TARGET_DIR")"
+git clone --depth 1 "$REPO_URL" "$TARGET_DIR"
+echo "usdasm fetched to $TARGET_DIR"