v20.0.0

[MrHinsh]

Story so far

Migration Modules

Stages run left-to-right: Capture → Export → Prepare → Import → Validate

Connector	Module	Capture	Export	Prepare	Import	Validate
Azure DevOps Services	Work Items	✅	✅	🔜	🔜	📋
	Identities	✅	✅	🔜	🔜	📋
	Area & Iteration Nodes	✅	✅	🔜	🔜	📋
	Teams	✅	✅	🔜	🔜	📋
	Test Plans	📋	📋	📋	📋	📋
	Shared Queries	📋	📋	📋	📋	📋
	Git Repositories	✅	🔜	🔜	🔜	📋
	Pipelines	🔜	🔜	🔜	🔜	📋
	Permissions	🔜	🔜	🔜	🔜	📋
Team Foundation Server	Work Items	🚧	🚧	📋	📋	📋
	Identities	🚧	🚧	📋	📋	📋
	Area & Iteration Nodes	🚧	🚧	📋	📋	📋
	Teams	🚧	🚧	📋	📋	📋
	Test Plans	📋	📋	📋	📋	📋
	Shared Queries	📋	📋	📋	📋	📋
	Git Repositories	📋	📋	📋	📋	📋
	TFVC Repositories*	❌	❌	❌	❌	❌
	Pipelines	🔜	🔜	📋	📋	📋
	Permissions	🔜	🔜	📋	📋	📋

* We may integrate GitTfs for TFVC repository migration in the future.

Analisers

Analysers run during Capture and write reports to the package for operator review. They never write to source or target.

Analyser	Status	Purpose
Inventory	✅	Consolidates per-module counts into a unified package-level report
Dependencies	✅	Maps cross-project work item links so operators can assess scope before import

Tools

Tools are stateless transformation services that apply during Export and Import with no I/O of their own.

Tool	Status	Purpose
FieldTransform	✅	Apply declarative field-rewrite rules to each work item revision
NodeTranslation	✅	Translate area and iteration path strings against configured mappings
IdentityLookup	✅	Resolve and remap user identities across organisations
WorkItemTypeTranslation	📋	Remap work item type names between source and target (e.g., User Story → Product Backlog Item)

---

What's Changed

• 007 observability logging by @MrHinsh in 007 observability logging #15
• 008 tui job dashboard by @MrHinsh in 008 tui job dashboard #16
• 009 resumable export import by @MrHinsh in 009 resumable export import #17
• Copilot/simulate migration data by @MrHinsh in Copilot/simulate migration data #18
• 010 workitem comments images by @MrHinsh in 010 workitem comments images #19
• Enhance Work Item Export Service and Validation by @MrHinsh in Enhance Work Item Export Service and Validation #20
• enforce doc-sync as a mandatory ATDD phase to prevent pending-actions drift by @Copilot in enforce doc-sync as a mandatory ATDD phase to prevent pending-actions drift #21
• Feature/011 inline comment fetching by @MrHinsh in Feature/011 inline comment fetching #22
• refactor: Update environment variable references for system tests and… by @MrHinsh in refactor: Update environment variable references for system tests and… #23
• 012 discovery dependencies by @MrHinsh in 012 discovery dependencies #24
• Update config by @MrHinsh in Update config #25
• chore: introduce Central Package Management with Directory.Packages.props and Directory.Build.props by @Copilot in chore: introduce Central Package Management with Directory.Packages.props and Directory.Build.props #26
• feat: enhance documentation for ControlPlaneHost and Migration Agent … by @MrHinsh in feat: enhance documentation for ControlPlaneHost and Migration Agent … #27
• fix: update CLI package structure and path resolution for tfsmigration by @MrHinsh in fix: update CLI package structure and path resolution for tfsmigration #28
• Windows detect by @MrHinsh in Windows detect #29
• fix: update artifact packaging structure to include subfolders for CL… by @MrHinsh in fix: update artifact packaging structure to include subfolders for CL… #30
• Refactor control plane URL handling and introduce EnvironmentOptions by @MrHinsh in Refactor control plane URL handling and introduce EnvironmentOptions #31
• Tweeks nad job check by @MrHinsh in Tweeks nad job check #32
• Mre bits by @MrHinsh in Mre bits #33
• chore: restrict satellite resource assemblies to English only by @Copilot in chore: restrict satellite resource assemblies to English only #36
• fix: disabled orgs participate in GUID project-name resolution during dependency discovery by @Copilot in fix: disabled orgs participate in GUID project-name resolution during dependency discovery #37
• Add hexagonal-check skill for detecting architecture boundary violations by @Copilot in Add hexagonal-check skill for detecting architecture boundary violations #38
• feat: CLI config branch and interactive scenario selection by @Copilot in feat: CLI config branch and interactive scenario selection #35
• 013 ado workitems import by @MrHinsh in 013 ado workitems import #34
• Hexagonal architecture by @MrHinsh in Hexagonal architecture #40
• feat: Enhance installed mode to launch ControlPlane and MigrationAgen… by @MrHinsh in feat: Enhance installed mode to launch ControlPlane and MigrationAgen… #41
• Fix for build 2 by @MrHinsh in Fix for build 2 #42
• Tfs architecture update by @MrHinsh in Tfs architecture update #43
• Refactor discovery to agent job by @MrHinsh in Refactor discovery to agent job #44
• feat: introduce OrganisationEndpoint as canonical connection context type (spec 016) by @MrHinsh in feat: introduce OrganisationEndpoint as canonical connection context type (spec 016) #46
• 017 simulated infrastructure by @MrHinsh in 017 simulated infrastructure #47
• refactor: Replace DiscoveryJobOrganisation with MigrationEndpointOpti… by @MrHinsh in refactor: Replace DiscoveryJobOrganisation with MigrationEndpointOpti… #48
• feat: Introduce Work Item Scoped Fetch Service by @MrHinsh in feat: Introduce Work Item Scoped Fetch Service #49
• Pending actions by @MrHinsh in Pending actions #51
• feat 014: field filter scope by @MrHinsh in feat 014: field filter scope #53
• Restore old specs by @MrHinsh in Restore old specs #54
• feat 018: Add specifications and architecture discrepancies for Work Item OpenTelemetry Metrics by @MrHinsh in feat 018: Add specifications and architecture discrepancies for Work Item OpenTelemetry Metrics #50
• feat: add architecture perspective validation skills and combined review wrapper by @Copilot in feat: add architecture perspective validation skills and combined review wrapper #55
• feat 019: Work Item ID Map Sync — integrity check, revision watermark, duplicate prevention, exclusive package lock by @MrHinsh in feat 019: Work Item ID Map Sync — integrity check, revision watermark, duplicate prevention, exclusive package lock #52
• feat: add consolidation analysis command for architectural review and… by @MrHinsh in feat: add consolidation analysis command for architectural review and… #56
• feat(tests): add system test for CLI failure on unreachable control plane in Hosted mode by @MrHinsh in feat(tests): add system test for CLI failure on unreachable control plane in Hosted mode #57
• Refactor for config to add tools and simplfy c onfig by @MrHinsh in Refactor for config to add tools and simplfy c onfig #58
• Feature gap and Central file locations by @MrHinsh in Feature gap and Central file locations #59
• 020 resumable batching cursor by @MrHinsh in 020 resumable batching cursor #62
• P2: Three-Channel Telemetry Model by @MrHinsh in P2: Three-Channel Telemetry Model #63
• P3: Process-per-Component Standalone Mode by @MrHinsh in P3: Process-per-Component Standalone Mode #64
• Metrics logging trace by @MrHinsh in Metrics logging trace #66
• fix: flush telemetry sinks before SignalTerminalAsync to prevent progress.jsonl loss in process-per-component mode by @Copilot in fix: flush telemetry sinks before SignalTerminalAsync to prevent progress.jsonl loss in process-per-component mode #65
• feat: update OpenTelemetry packages and enhance module architecture with discovery features by @MrHinsh in feat: update OpenTelemetry packages and enhance module architecture with discovery features #67
• Fix dependency functions project level by @MrHinsh in Fix dependency functions project level #68
• M1: WorkItemsModule — FieldMapping by @MrHinsh in M1: WorkItemsModule — FieldMapping #69
• feat: add metrics tracking for work item export progress by @MrHinsh in feat: add metrics tracking for work item export progress #70
• Split SystemTest into SystemTest_Simulated and SystemTest_Live for ordered, fail-fast execution by @Copilot in Split SystemTest into SystemTest_Simulated and SystemTest_Live for ordered, fail-fast execution #72
• Separation of concerns2 by @MrHinsh in Separation of concerns2 #74
• Fix for checkpointing by @MrHinsh in Fix for checkpointing #75
• Refactor work item field mapping interfaces and tasks to adhere to 02… by @MrHinsh in Refactor work item field mapping interfaces and tasks to adhere to 02… #76
• 023 workitems nodestructure tool by @MrHinsh in 023 workitems nodestructure tool #77
• feat: Update job contract and secrets handling in documentation for clarity and security improvements by @MrHinsh in feat: Update job contract and secrets handling in documentation for clarity and security improvements #78
• Move tfs to agent by @MrHinsh in Move tfs to agent #79
• feat: Add file-based diagnostics for OpenTelemetry by @MrHinsh in feat: Add file-based diagnostics for OpenTelemetry #80
• Extra bits by @MrHinsh in Extra bits #81
• Spec 024: Introduce Identities, NodeStructure, and Teams Modules with Architecture Refactoring by @MrHinsh in Spec 024: Introduce Identities, NodeStructure, and Teams Modules with Architecture Refactoring #82
• 024 teams module by @MrHinsh in 024 teams module #83
• 025 agent config package by @MrHinsh in 025 agent config package #84
• Job change by @MrHinsh in Job change #85
• 028 ioptions schema gen by @MrHinsh in 028 ioptions schema gen #86
• Orcastrator architecture by @MrHinsh in Orcastrator architecture #87
• Licencing update by @MrHinsh in Licencing update #88
• fix: readme by @MrHinsh in fix: readme #89
• 030 module analiser refactor by @MrHinsh in 030 module analiser refactor #90
• Fix up invantory by @MrHinsh in Fix up invantory #91
• Platform metrics unification by @MrHinsh in Platform metrics unification #92
• Updates & Cleanup by @MrHinsh in Updates & Cleanup #93
• 032 icapture interface by @MrHinsh in 032 icapture interface #94
• Architectire changes by @MrHinsh in Architectire changes #95
• Enhance job plan execution with analyser and inventory context support by @MrHinsh in Enhance job plan execution with analyser and inventory context support #96
• Enhance documentation and tools for skill testing and runtime state management by @MrHinsh in Enhance documentation and tools for skill testing and runtime state management #97
• Add agent_observability TDD safety net and DiagnosticLogStore unit tests by @MrHinsh in Add agent_observability TDD safety net and DiagnosticLogStore unit tests #98
• Strengthen package validator safety net by @MrHinsh in Strengthen package validator safety net #100
• Preserve run-scoped package log folder for delayed telemetry flushes by @MrHinsh in Preserve run-scoped package log folder for delayed telemetry flushes #103
• Harden AgentWorkerBase lease cleanup and add lease-coordination safety-net test by @MrHinsh in Harden AgentWorkerBase lease cleanup and add lease-coordination safety-net test #102
• Stabilize agent task dependency resume by @MrHinsh in Stabilize agent task dependency resume #104
• Update for discovery by @MrHinsh in Update for discovery #99
• Enhance package manager adoption with updated specs and documentation by @MrHinsh in Enhance package manager adoption with updated specs and documentation #105
• fix: correct path for release packages in CI workflow by @MrHinsh in fix: correct path for release packages in CI workflow #106

Full Changelog: v0.0.1-185...v20.0.0

---

This discussion was created from the release v20.0.0.