Vorsam Work Item Generator

Azure DevOps Boards hub that generates and creates work items directly in ADO with a self-contained BYOK model.

Architecture

• Collection-scoped config via Extension Data Service under vorsam.settings.global
• Provider mode: openai or gemini
• Direct browser fetch to provider APIs (no Vorsam backend proxy)
• Native work item creation using direct ADO REST (/_apis/wit/workitems/$<type>)
• Startup tracker + global error capture for actionable Load failed diagnostics

UX behavior

1. Reads project context from SDK.getWebContext()
2. If settings are missing:
   • Admin users: configure via gear/settings panel
   • Non-admin users: shown Contact Administrator panel
3. Generator view captures prompt and creates draft items
4. Review step is mandatory before create
5. Preflight checks validate project context, token, draft shape, and validate-only permission probe
6. Create step uses parent-first topological ordering and retry/backoff for 429/5xx
7. If System.State is rejected by process template, create retries without System.State
8. Result view reports per-item status with detailed error tooltips

Security notes

• API keys are organization-level and masked in the UI after save
• No user JWT tokens are requested or stored
• CSP limits outbound calls to OpenAI/Gemini and Azure DevOps API hosts

Reliability notes

• Collection URL resolution order: SDK.getWebContext().collection.uri -> Location Service -> document.referrer
• Work item types from the AI are mapped to names that exist in the project process (e.g. Story → User Story / Product Backlog Item)
• Hierarchy linking uses parent REST URL, never web URLs
• Startup failures include stage and extension version to speed diagnosis

Publisher

Set publisher in vss-extension.json to your Marketplace publisher id before packaging/publishing.