Add support for 'remote related' work item links and update validatio…

[andste97]

Changes Implemented

Updates tool wit_work_items_link to support remote related links

• Add "remote related" to the existing link type enum
• Add optional parameter linkToUrl (string) - full URL to the target work item in the remote ADO instance
• Add validation logic and which target url parameter to use:
  • when linkType is anything but remote related, linkToId needs to be set
  • if linkType is remoteRelated, linkToURL needs to be set
• Update tool parameter descriptions

Notes

The new link type maps to System.LinkTypes.Remote.Related
When linkToUrl is provided, use it as the target URL for the linkage instead of constructing URL from linkToId.
Tests have not been implemented as this was done as POC.

[andste97]

@microsoft-github-policy-service agree company="Microsoft"

@microsoft-github-policy-service agree company="Microsoft"

[danhellem]

@andste97 this looks pretty good to me. Please double check and make sure it passes all tests and add a new test to account for the change.

[codecov-commenter]

Codecov Report

❌ Patch coverage is 25.00000% with 6 lines in your changes missing coverage. Please review.
⚠️ Please upload report for BASE (main@08c95f6). Learn more about missing BASE report.

Files with missing lines	Patch %	Lines
src/tools/work-items.ts	25.00%	3 Missing and 3 partials ⚠️

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #867   +/-   ##
=======================================
  Coverage        ?   93.50%           
=======================================
  Files           ?       16           
  Lines           ?     1539           
  Branches        ?      321           
=======================================
  Hits            ?     1439           
  Misses          ?       26           
  Partials        ?       74           

Flag	Coverage Δ
unittests	93.50% <25.00%> (?)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.