[Epic] VM Conversion Toolkit Full Build-Out

[kristopherjturner]

Epic: VM Conversion Toolkit Full Build-Out

This epic governs the end-to-end delivery of the Azure Local VM Conversion Toolkit — from script refinement and test coverage through error handling, CI/CD, documentation, and full validation on both Azure Local and standalone Hyper-V environments.

Scope Boundaries

• Script refinement: Azure Local conversion path (scripts/azurelocal/) and Hyper-V path (scripts/hyperv/).
• Test coverage: Pester tests for all scripts with ≥80% coverage.
• Error handling: Rollback capability for failed conversions at each stage.
• Logging: Structured logging compatible with Azure Monitor.
• CI/CD: Lint, test, and release pipelines.
• Documentation: Getting started, runbooks, and troubleshooting guides.
• Validation: End-to-end conversion validated on reference hardware.

Hard Close Gate (Mandatory)

No child issue can close without all of:

1. Contract evidence: input parameters and expected outputs documented.
2. Repro evidence: conversion transcript + VM state before/after + Arc enrollment confirmation.
3. Test evidence: Pester tests passing for all scripts touched.
4. Dependency evidence: blocking cross-repo issues resolved or explicitly waived.

Child Workstream

• feat: script refinement — Azure Local conversion path (01–05 scripts) #6 — Script refinement: Azure Local conversion path (01–05 scripts)
• feat: script refinement — Hyper-V standalone conversion path #7 — Script refinement: Hyper-V standalone conversion path
• feat: Pester test coverage for all conversion scripts #8 — Pester test coverage for all conversion scripts
• feat: error handling and staged rollback capability #9 — Error handling and staged rollback capability
• feat: shared logging module and Azure Monitor forwarding #10 — Shared logging module and Azure Monitor forwarding
• infra: CI/CD pipelines (lint, test, release) #11 — CI/CD pipelines (lint, test, release)
• docs: documentation expansion for all conversion paths and scenarios #12 — Documentation expansion for all conversion paths and scenarios
• feat: Linux and additional VM configuration support #13 — Linux and additional VM configuration support
• feat: end-to-end validation matrix (all OS × path combinations) #14 — End-to-end validation matrix (all OS × path combinations)

Cross-Repo Dependencies

• Toolkit variable registry: Create master variables registry to standardize variables across all repos azurelocal-toolkit#4
• IaC maturity tracking: Track IaC tool maturity status across all repos (Built / Tested / Released) azurelocal-toolkit#5

References

• Dev tracker: Dev tracker: VM Gen1-to-Gen2 conversion toolkit #2

[kristopherjturner]

Tracked in Azure DevOps: https://dev.azure.com/hybridcloudsolutions/Azure%20Local%20VM%20Conversion%20Toolkit/_workitems/edit/181