feat: add pcm_generate_startlist_xml tool

[mpicciolli]

What

Adds a new MCP tool pcm_generate_startlist_xml that builds a Pro Cycling Manager startlist XML document from a list of teams and their cyclist rosters.

The XML format mirrors PCM's expected layout:

<startlist>
    <team id="34">
        <cyclist id="7602" />
        <cyclist id="5996" />
    </team>
</startlist>

Inputs / outputs

• Input: savePath, raceId (STA_race.IDrace), and teams ([{ id, cyclists: number[] }]).
• Output: xml (the document as text) and fileName, derived from STA_race.gene_sz_filename for the given race (e.g. c0_almeria.xml).

To resolve the file name, the tool reads the .cdb save via withSaveDb and looks up the race row — staying within the server's read-only guarantee (the save is never modified). The XML builder (buildStartlistXml) lives in helpers.ts.

[Copilot]

Pull request overview

Adds a new read-only MCP tool, pcm_generate_startlist_xml, to generate Pro Cycling Manager startlist XML from provided teams/rosters while deriving the suggested output file name from the save’s STA_race.gene_sz_filename.

Changes:

• Introduces pcm_generate_startlist_xml, including DB lookup of gene_sz_filename via withSaveDb and XML generation via a shared helper.
• Adds unit tests for XML formatting/validation (buildStartlistXml) and filename extension handling (resolveStartlistFileName).
• Updates tool registration and documentation tables to include the new tool.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
test/generate-startlist-xml.test.ts	Adds tests covering XML output formatting, validation errors, and filename extension behavior.
src/tools/index.ts	Registers the new pcm_generate_startlist_xml tool with the MCP server.
src/tools/generate-startlist-xml.ts	Implements the tool: resolves race startlist filename from STA_race, and generates XML output.
src/helpers.ts	Adds buildStartlistXml helper and StartlistTeam interface alongside existing response helpers.
README.md	Documents the new tool in the public tool table.
AGENTS.md	Updates repository guidance/tool tables to include the new tool and helper mention.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.