Update VSS documentation generation to COVESA VSS 6.0 with auto-detection

[Copilot]

The VSS build script was hardcoded to VSS 3.1 and required a manual clone of the COVESA VSS repo. This updates it to auto-detect and download the latest VSS release (currently 6.0), and fixes API compatibility with vss-tools 4.2.

Build script (build-vss-docs.sh)

• Queries GitHub API for latest release tag; falls back to v6.0 if unavailable
• Downloads and extracts the VSS source zip automatically
• Cleans output/ before regenerating to avoid stale files (e.g. the removed Vehicle.OBD branch)

LATEST_TAG=$(curl -s "${GITHUB_API_URL}" | python3 -c "import sys, json; print(json.load(sys.stdin)['tag_name'])" 2>/dev/null || echo "")

Python converter (vspecjson2markdown.py)

• Replaces removed Unit class with VSSUnit/VSSUnitCollection from vss-tools 4.x API
• Adds -q/--quantities argument; calls vspec.load_quantities() for the new quantities.yaml required by VSS 6.0
• Sets abort_on_unknown_attribute=False to tolerate the new pattern keyword in VSS 6.0

Mako template (vss.mako.md)

• Maps to renamed unit attributes: unit.label→unit.unit, unit.description→unit.definition, unit.domain→unit.quantity
• Guards attribute access with hasattr checks

Regenerated output

• 1,607 signal pages from VSS 6.0 (up from 1,138 in VSS 3.1)
• Vehicle.OBD removed; new branches added: ControlUnit, Diagnostics, MotionManagement, Trailer, and others

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• https://api.github.com/repos/COVESA/vehicle_signal_specification/releases
  • Triggering command: /usr/bin/curl curl -s REDACTED (http block)
• https://api.github.com/repos/COVESA/vehicle_signal_specification/releases/latest
  • Triggering command: /usr/bin/curl curl -s REDACTED (http block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Update to latest VSS Release 6.0</issue_title>
<issue_description>Change the build script in the vss folder to retrieve the latest COVESA VSS Release automatically. Currently, that is 6.0
It would be great if the script could auto-detect the latest version.
Run the script and commit the updated static markdown files.</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes Update to latest VSS Release 6.0 #75

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.