Skip to content

Test every MCP tool adapter and prepare beta.4 #37

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ShadowNineX merged 4 commits into from
Oct 16, 2026
Merged

Test every MCP tool adapter and prepare beta.4 #37

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
a298695
Test every MCP tool adapter and refresh Client and SDK packages
ShadowNineX Oct 16, 2026
d91ef4c
Merge latest main test-platform updates
ShadowNineX Oct 16, 2026
67a260e
Prepare 2.0.0-beta.4 prerelease
ShadowNineX Oct 16, 2026
ab7fe3e
Clarify beta.4 native dispatcher qualification limit
ShadowNineX Oct 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion Directory.Build.props
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@
<!-- Audit-source outages and low/moderate advisories are reported without blocking; high and critical fail. -->
<WarningsNotAsErrors>$(WarningsNotAsErrors);NU1900;NU1901;NU1902;NU1905</WarningsNotAsErrors>
<PlatformTarget>x64</PlatformTarget>
<Version>2.0.0-beta.3</Version>
<Version>2.0.0-beta.4</Version>
<Authors>CheatEngineNet</Authors>
<Company>CheatEngineNet</Company>
<RepositoryUrl>https://github.com/CheatEngineNet/CheatEngine.Mcp</RepositoryUrl>
Expand Down
4 changes: 2 additions & 2 deletions Directory.Packages.props
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,8 @@
<CentralPackageTransitivePinningEnabled>true</CentralPackageTransitivePinningEnabled>
</PropertyGroup>
<ItemGroup>
<PackageVersion Include="CheatEngine.Client" Version="1.0.0"/>
<PackageVersion Include="CheatEngine.SDK" Version="2.0.0"/>
<PackageVersion Include="CheatEngine.Client" Version="1.1.0"/>
<PackageVersion Include="CheatEngine.SDK" Version="2.0.1"/>
<PackageVersion Include="Costura.Fody" Version="6.2.0"/>
<PackageVersion Include="Fody" Version="6.9.3"/>
<PackageVersion Include="ModelContextProtocol" Version="2.2.0"/>
Expand Down
18 changes: 9 additions & 9 deletions THIRD-PARTY-NOTICES.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,13 +12,13 @@ shipped package has no row.

| Package | Version | License | Copyright | Shipped in | License text |
|---|---|---|---|---|---|
| CheatEngine.Client | 1.0.0 | MIT | Copyright (c) 2026 AriusII, ShadowNineX and CheatEngine.Client contributors | Metapackage, no files | [MIT License](#mit-license) |
| CheatEngine.Client.Abstractions | 1.0.0 | MIT | Copyright (c) 2026 AriusII, ShadowNineX and CheatEngine.Client contributors | Embedded plugin dependencies, gateway | [MIT License](#mit-license) |
| CheatEngine.Client.Core | 1.0.0 | MIT | Copyright (c) 2026 AriusII, ShadowNineX and CheatEngine.Client contributors | Embedded plugin dependencies, gateway | [MIT License](#mit-license) |
| CheatEngine.Client.Extensions.DependencyInjection | 1.0.0 | MIT | Copyright (c) 2026 AriusII, ShadowNineX and CheatEngine.Client contributors | Embedded plugin dependencies, gateway | [MIT License](#mit-license) |
| CheatEngine.Client.Fluent | 1.0.0 | MIT | Copyright (c) 2026 AriusII, ShadowNineX and CheatEngine.Client contributors | Embedded plugin dependencies, gateway | [MIT License](#mit-license) |
| CheatEngine.Client.Hosting | 1.0.0 | MIT | Copyright (c) 2026 AriusII, ShadowNineX and CheatEngine.Client contributors | Embedded plugin dependencies, gateway | [MIT License](#mit-license) |
| CheatEngine.SDK | 2.0.0 | MIT | Copyright (c) 2026 AriusII, ShadowNineX and CheatEngine.SDK contributors | Embedded plugin dependencies: the seven `CheatEngine.SDK*.dll` assemblies and the native `cheatengine-sdk-lua-bridge.dll`. Gateway: the managed assemblies only | [MIT License](#mit-license) |
| CheatEngine.Client | 1.1.0 | MIT | Copyright (c) 2026 AriusII, ShadowNineX and CheatEngine.Client contributors | Metapackage, no files | [MIT License](#mit-license) |
| CheatEngine.Client.Abstractions | 1.1.0 | MIT | Copyright (c) 2026 AriusII, ShadowNineX and CheatEngine.Client contributors | Embedded plugin dependencies, gateway | [MIT License](#mit-license) |
| CheatEngine.Client.Core | 1.1.0 | MIT | Copyright (c) 2026 AriusII, ShadowNineX and CheatEngine.Client contributors | Embedded plugin dependencies, gateway | [MIT License](#mit-license) |
| CheatEngine.Client.Extensions.DependencyInjection | 1.1.0 | MIT | Copyright (c) 2026 AriusII, ShadowNineX and CheatEngine.Client contributors | Embedded plugin dependencies, gateway | [MIT License](#mit-license) |
| CheatEngine.Client.Fluent | 1.1.0 | MIT | Copyright (c) 2026 AriusII, ShadowNineX and CheatEngine.Client contributors | Embedded plugin dependencies, gateway | [MIT License](#mit-license) |
| CheatEngine.Client.Hosting | 1.1.0 | MIT | Copyright (c) 2026 AriusII, ShadowNineX and CheatEngine.Client contributors | Embedded plugin dependencies, gateway | [MIT License](#mit-license) |
| CheatEngine.SDK | 2.0.1 | MIT | Copyright (c) 2026 AriusII, ShadowNineX and CheatEngine.SDK contributors | Embedded plugin dependencies: the seven `CheatEngine.SDK*.dll` assemblies and the native `cheatengine-sdk-lua-bridge.dll`. Gateway: the managed assemblies only | [MIT License](#mit-license) |
| Costura.Fody | 6.2.0 | MIT | Copyright (c) 2012 Simon Cropp and contributors | Plugin: embedded dependencies and injected loader code | [MIT License](#mit-license) |
| Microsoft.Extensions.AI.Abstractions | 10.10.1 | MIT | Copyright (c) .NET Foundation; © Microsoft Corporation | Embedded plugin dependencies, gateway | [MIT License](#mit-license) |
| ModelContextProtocol | 2.2.0 | Apache-2.0 (MIT for earlier contributions not yet relicensed) | © Model Context Protocol a Series of LF Projects, LLC. | Embedded plugin dependencies, gateway | [Apache License 2.0](#apache-license-20), [MIT License](#mit-license) |
Expand Down Expand Up @@ -62,8 +62,8 @@ SDK changes the runtime version, update this table.

| Component | Upstream license file |
|---|---|
| CheatEngine.Client 1.0.0 | <https://github.com/CheatEngineNet/CheatEngine.Client/blob/f88de3d843252c9139f08c71531a02f03c0516bb/LICENSE> (the source commit of the packages) |
| CheatEngine.SDK 2.0.0 | <https://github.com/CheatEngineNet/CheatEngine.SDK/blob/325c47b573f8bd39a247f1d0101f110fa36c1696/LICENSE> (the source commit of the package) |
| CheatEngine.Client 1.1.0 | <https://github.com/CheatEngineNet/CheatEngine.Client/blob/cfdcb0018c9d64108ed2f533658daa755ec65e19/LICENSE> (the source commit of the packages) |
| CheatEngine.SDK 2.0.1 | <https://github.com/CheatEngineNet/CheatEngine.SDK/blob/06c529f84e47295e3ca7a4e81ca808b9c4686b3a/LICENSE> (the source commit of the package) |
| Microsoft.Extensions.AI.Abstractions 10.10.1 | <https://github.com/dotnet/extensions/blob/59e1741f6fb45cf7ae08e2df088aef71537a7bc4/LICENSE> (the source commit of the package) |
| ModelContextProtocol 2.2.0 | <https://github.com/modelcontextprotocol/csharp-sdk/blob/6fa3825973949a9c4f0cd8af344e15a8db09dc35/LICENSE> and <https://github.com/modelcontextprotocol/csharp-sdk/blob/6fa3825973949a9c4f0cd8af344e15a8db09dc35/THIRD-PARTY-NOTICES.txt> (the source commit of the packages) |
| .NET runtime packs 10.0.12 | `LICENSE.TXT` and `THIRD-PARTY-NOTICES.TXT` of the runtime packs |
Expand Down
24 changes: 24 additions & 0 deletions docs/beta4-release-notes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
# CheatEngine.Mcp 2.0.0-beta.4

This Windows x64 prerelease updates the Client/SDK dependencies, fixes two tool adapters and expands automated coverage across the complete MCP catalog. Download `CheatEngine.Mcp-2.0.0-beta.4-win-x64.zip` and verify it with `SHA256SUMS.txt`. The ZIP contains the single plugin DLL, matching gateway executable, installation instructions and licenses.

## Changes since beta.3

- Updated `CheatEngine.Client` to 1.1.0 and `CheatEngine.SDK` to 2.0.1, including regenerated normal and Native AOT dependency locks.
- Fixed `code_get_comments` so its address array reaches Lua as one argument, and fixed `process_list_threads` to use CE's documented zero-based StringList indexer.
- Added catalog-derived routing/refusal checks for every backend tool, positive adapter evidence for all 193 backend tools, and gateway-local discovery checks. New catalog entries must have reviewed adapter-test mappings.
- Expanded standalone Lua adapter tests and execution-argument, conversion/calculation and pointer-file boundary, failure and cleanup tests.
- Added a bounded live workflow scenario that tests target, gateway and host restarts independently of the unresolved plugin reload bridge.
- Preserved the latest test-platform package updates from `main`.

## Validation and known limits

The recorded automated baseline passes 5,314 portable tests in both Debug and Release and 651 standalone Lua tests, with no failures or skips. Combined coverage reaches 94.50% of instrumented handwritten product C# lines, including 94.37% in Tools. This C# percentage does not measure embedded Lua branch coverage or native CE behavior.

The release pipeline checks the isolated bundled DLL, reflected catalog, Native AOT gateway smoke responses, ZIP contents and checksums. Native evidence for 37 backend tools comes from the separately identified private dependency-refresh candidate recorded in the [all-tool qualification report](https://github.com/CheatEngineNet/CheatEngine.Mcp/blob/main/docs/qualification/all-tools/README.md); it does not qualify newly rebuilt release bytes. Another 156 backend tools still need native success fixtures, and same-process plugin reload remains unqualified. SDK provider-stack guards reject invalid states; the original intermittent dispatcher corruption was investigated, but its root cause remains unresolved. This beta is not stable v2.0.0 sign-off.

## Installation, upgrade and rollback

Use Cheat Engine 7.7 x64 with the x64 .NET 10, ASP.NET Core 10 and Windows Desktop 10 runtimes. The gateway is self-contained. All four optional execution capabilities remain enabled by default; configure their exposure for your setup. The recorded bounded native workflows explicitly disabled them.

Back up the previous matching plugin/gateway pair, configuration and CE settings. Disable the plugin and close CE and the gateway before extracting beta.4 into a new folder. Install `CheatEngine.Mcp.dll`, point the MCP client at the matching `CheatEngine.Mcp.Gateway.exe`, then use `instance_list` to discover a fresh instance ID. Keep both binaries from the same ZIP. To roll back, close both processes and restore the previous matching pair and registration. See the [recovery guide](https://github.com/CheatEngineNet/CheatEngine.Mcp/blob/main/srcs/CheatEngine.Mcp.Resources/Knowledge/Documents/connection-troubleshooting.md#several-instances-updates-and-removal) for locked files and partial upgrades.
Loading
Loading