# CLI 0.0.4-microsoft-preview.37

Microsoft migration engine preview. Stable `latest` remains 0.0.3.

## Bounded helper-group convergence

- Extends `lambogenius_correctFlowGroups` with revision-bound `mergeGroups`.
  Each merge atomically moves every artifact from one helper-only source group
  into an existing executable target group and removes the invalid source
  definition before the original Microsoft grouping checks run again.
- Returns all structurally readable helper-only groups as `invalidGroups` and
  all current orchestration- or binding-backed targets as
  `executableGroupIds`. This lets one compact correction merge multiple helper
  groups without enumerating artifact UUIDs or regenerating the complete
  grouping document.
- Restricts merge sources to groups with no orchestration or binding and merge
  targets to groups that already contain one. Executable flows cannot be
  collapsed into each other, helper groups cannot receive merges, stale
  revisions fail, and the full orchestration, binding, caller/callee, and
  selected-artifact coverage checks remain mandatory.
- Distinguishes a repairable draft with an ungrouped entry point from a source
  inventory containing no BizTalk orchestration or binding at all. The former
  receives an exact assignment remedy; the latter must correct source
  selection and cannot invent an executable flow.
- Retains preview.36's audited, one-round recovery for Ollama connection resets
  and preview.35's range-bounded initial grouping transport.

The preview.36 qualification run submitted a bounded ranged draft and reached
normal correction calls, but three proposed groups contained only maps,
schemas, or custom code. The correction API could move individual artifacts
but could not delete a helper-only group definition. Calls 12 through 15
therefore repeated an operation that could never resolve
`flow-1-presto-processing`, and the host correctly stopped the model/tool loop.
Preview.37 provides the missing bounded structural operation instead of
increasing call limits or accepting an invalid group.

## Verification and limits

- 165 Microsoft migration-core tests, 257 CLI tests, and 30
  release/installer/documentation tests pass. Repository lint, TypeScript
  compilation, all production builds, and 24 VS Code compatibility tests pass;
  one platform-specific extension test remains pending on Windows.
- Regression coverage begins with the ranged grouping tool, merges multiple
  helper sources into one executable target, and verifies exact stored
  membership. Negative coverage rejects executable sources, helper targets,
  self-merges, stale revisions, unknown memberships, and inventories with no
  possible executable entry point.
- The failed preview.36 evidence remains under
  `failure-evidence/2026-09-21T23-39-42-preview36-grouping-helper-loop` in the
  test workspace. It establishes a missing correction operation and an audited
  model/tool stall, not absent BizTalk source or successful discovery.
- A complete fresh FINACCONT2024Backup-BT migration with preview.37 remains a
  post-publication qualification step. This release does not claim an Azure
  deployment, deployed Logic Apps runtime test, or business equivalence.

## PowerShell update

```powershell
Invoke-WebRequest 'https://tools.lambogenius.com/lambogenius-integration-migration/0.0.4-microsoft-preview.37/install-cli.ps1' -OutFile install-cli-preview37.ps1
# Review the downloaded script before running it.
& .\install-cli-preview37.ps1 -SkipDependencies
li.cmd --version
```

Expected version: `0.0.4-microsoft-preview.37`. This preview is not promoted to
the stable `latest` alias. Preserve existing reports and generated output before
upgrading. Use a fresh generated workspace because the Microsoft engine
fingerprint changed; do not edit fingerprint records to force checkpoint reuse.
Installation does not reset license counters.
