How hlnd2t/goldsrc_vibesignatures works
GoldSrc VibeSignatures is a reproducible GoldSrc binary-analysis framework. The main workflow acquires game binaries, restores exact warm IDB generations, runs IDA-backed symbol analysis, and produces per-symbol YAML artifacts; snapshot tooling validates and packages artifacts, while PR tooling plans their impact. The repository also documents process reporting and a dashboard for run monitoring, plus symbol search. Dashboard backend implementation and several workflow details were not sampled, so those connections are limited to documented capabilities rather than inferred calls.
Main entry points: ida_analyze_bin.py IDA analyzer · operations.py Snapshot operations · App.tsx Dashboard UI · accepted_bin.py Accepted binaries
Components 29
Binary acquisition
- Depot download
download_depot.py - Game binaries
binary_format.py - Warm IDB restore
idb_warm_worker.py
Symbol analysis
- Analysis config
analysis_config.py - IDA analyzer
ida_analyze_bin.py - IDA analysis utilities
ida_analyze_util.py - LLM decompiler
ida_llm_decompile.py - Decompile specs
llm_spec.py - Symbol declarations
llm_declarations.py - Symbol preprocessors
ida_preprocessor_scripts - Global references
ida_preprocessor_scripts/_direct_gv_common.py
Artifacts and snapshots
- Symbol YAML artifacts
gamesymbol_snapshot_lib/operations.py - Artifact contract
bin_artifact_contract.py - Artifact diagnostics
artifact_diagnostics.py - Snapshot operations
gamesymbol_snapshot_lib/operations.py - Snapshot model
gamesymbol_snapshot_lib/model.py - Snapshot paths
gamesymbol_snapshot_lib/paths.py - Anchor drift
gamesymbol_snapshot_lib/anchor_drift.py
Release and PR workflow
- PR impact planning
gamesymbol_snapshot_lib/pr_cli.py - Accepted binaries
release_workflow_lib/accepted_bin.py - Release hashing
release_workflow_lib/hashing.py - Release manifests
release_workflow_lib/manifests.py
Run dashboard
- Dashboard UI
pages/src/App.tsx - Live run view
pages/src/features/run-detail/useRunLive.ts - Dashboard API client
pages/src/api/client.ts - Symbol search
pages/src/features/symbols/SymbolSearch.tsx
Other components
- Engineer
- Process monitoring API
- LLM service
Connections 27
- Engineer → Depot download: acquires binaries
README.md - Depot download → Game binaries: downloads
- Game binaries → Warm IDB restore: restores IDBs
README.md - Engineer → IDA analyzer: starts analysis
README.md - Analysis config → IDA analyzer: configures
analysis_config.py - IDA analyzer → IDA analysis utilities: uses
ida_analyze_util.py - IDA analysis utilities → LLM decompiler: invokes
ida_analyze_util.py - LLM decompiler → LLM service: requests analysis
- IDA analyzer → Symbol declarations: uses specs
- IDA analyzer → Symbol preprocessors: runs skills
README.md - Symbol preprocessors → Global references: uses helpers
ida_preprocessor_scripts/find-EngineSurface-context-globals.py - IDA analyzer → Symbol YAML artifacts: writes YAML
README.md - Symbol YAML artifacts → Artifact contract: validated by
bin_artifact_contract.py - Artifact contract → Artifact diagnostics: reports issues
bin_artifact_contract.py - Engineer → Snapshot operations: packs or verifies
README.md - Snapshot operations → Snapshot model: builds snapshot
gamesymbol_snapshot_lib/operations.py - Snapshot operations → Snapshot paths: resolves paths
gamesymbol_snapshot_lib/operations.py - Snapshot operations → Anchor drift: checks anchors
bin_artifact_contract.py - Engineer → PR impact planning: plans PR impact
README.md - PR impact planning → Snapshot operations: materializes artifacts
gamesymbol_snapshot_lib/pr_cli.py - Accepted binaries → Release hashing: verifies files
release_workflow_lib/accepted_bin.py - Accepted binaries → Release manifests: uses manifests
release_workflow_lib/accepted_bin.py - Engineer → Dashboard UI: views runs
README.md - Dashboard UI → Live run view: shows run detail
- Live run view → Dashboard API client: requests run data
pages/src/features/run-detail/useRunLive.ts - Dashboard API client → Process monitoring API: fetches and streams
pages/src/api/client.ts - Dashboard UI → Symbol search: searches symbols