mirror of
https://github.com/Corfirean/coa-server-manager.git
synced 2026-11-19 03:25:56 +00:00
5.0 KiB
5.0 KiB
Preview Builder & Release Qualification Report
1. Candidate Identification
| Field | Value |
|---|---|
| Product Target | CoA Modules Preview — Modular Host & Dynamic Modules |
| Preview Channel | preview/modules-v2 |
| Core Branch | preview/dynamic-plugin-host |
| Core Full Commit SHA | a11c2a7143c29e4ce8021d63eae319a2cc623f99 |
| Builder Full Commit SHA | b976818eb8aef00d3dfc78be9939e14c1f930e1c |
| Manager Commit SHA | 3b06b75 |
| CoA Plugin SDK Version | 0.3.2 |
| SDK ABI Fingerprint | 2f82013def4698d3f75fa24e5f70ffa504a7782d366b5edb78c7adc3c1ee0883 |
| Toolchain & Compiler | MSVC 19.44 / C++20 / Windows SDK 10.0.22621.0 |
| Client Target | 3.3.5a (12340) |
| Database Baseline | world_base_20261026.sql / auth_base_20261026.sql / characters_base_20261026.sql |
| Verification Timestamp | 2026-11-03 01:19:14 UTC |
2. Dedicated Preview Pipelines
The build automation in Corfirean/coa-server-build on branch preview/modules-v2 provides dedicated CI and local scripts:
2.1 Workflow Definitions
.github/workflows/preview-build.yml: Compiles the dynamic plugin hostworldserver.exefrompreview/dynamic-plugin-host, generates the SDK headers and export contract (coa_plugin_exports.def), and builds official dynamic DLL plugins..github/workflows/preview-verify.yml: Executes the automated qualification test harness against candidate builds, verifying ABI consistency, symbol export integrity, and regression guards..github/workflows/preview-release.yml: Assembles candidate distribution archives and publishes the isolatedcsm-preview-latest.jsonmanifest without touching stable endpoints.
2.2 Local Builder Scripts
scripts/preview-build.ps1: Builds modular core and exports SDK headers.scripts/preview-build-plugins.ps1: Compiles dynamic plugin DLLs against the candidate SDK.scripts/preview-package.ps1: Packages candidate artifacts, computes SHA-256 digests, and generatescandidate-lock.json.scripts/preview-verify.ps1: Verifies that candidate artifacts conform 100% to qualification requirements.
3. Verified Artifact Catalog & Hashes
All qualified binaries have been compiled, verified, and sealed with immutable SHA-256 hashes:
| Artifact Name | Component Role | Size (Bytes) | SHA-256 Digest |
|---|---|---|---|
worldserver.exe |
Dynamic Plugin Host Core | 37,215,744 | 048f810e44bcf7e3bcbbc1c6d3037a5f829e6815e959f9f0cf0d3b3c8594fc4b |
companions.dll |
Dynamic Bot System Plugin | 4,118,528 | 34be20f127c709fc7b6be9b5b6cd49cc16dd38d0e1e2a51d40aef5c3c0e5fd48 |
content_scaling.dll |
Dynamic Difficulty Scaling | 729,600 | 46e215ea723c180886c4617e49335dee1edfc3b0dacf7530bcea8755821420a1 |
squid_playerbots.dll |
Dynamic SQUID Bot Plugin | 11,269,632 | 9e42dccf534f333c50a49c0e661143267ca4e297d79f6c2b5bcb98ff215f94f0 |
time-is-time.dll |
Dynamic Game Clock Sync | 425,984 | 941916f1559c5d120a108e4ad2dca84343ce044cf8d80f8eb0ea7f66a935f1ff |
CSM Modules Preview.exe |
Desktop Manager Preview UI | 54,768,128 | 4c9d13224265505137e90f35131a048723178c241796a5932285f186d0109bfe |
candidate-lock.json |
Immutable Release Lock | 1,420 | Verified Lockfile |
4. Static vs. Dynamic Duplication Elimination
The dynamic host loader strictly prevents double registration of scripts, bot managers, and hook systems:
- Host-Level Dynamic Export:
worldserver.exedynamic host exportsGossip,MailReceiver,WorldSessionMgr, andPlayerdestruction hooks viacoa_plugin_exports.def. - De-coupling of Official Modules: Official modules (
companions,playerbots,content-scaling) are removed from static compilation inside the modularworldserver.exe. They are loaded exclusively viaplugins/<module>.dllthrough the dynamic plugin loader. - Guard Against Coexistence: The compatibility solver and core startup validator verify that conflicting bot systems (
companionsvsplayerbots) cannot simultaneously register active hooks or controllers.
5. Qualification Gate Results
| Test / Verification Check | Requirement | Result | Status |
|---|---|---|---|
| Core Source Identity | Frozen commit a11c2a7, not floating branch |
Exact SHA locked | PASS |
| Builder Source Identity | Branch preview/modules-v2, commit b976818 |
Exact SHA locked | PASS |
| SDK ABI Stability | Fingerprint match 2f82013def... |
Exact match | PASS |
| DLL Integrity Verification | All 4 dynamic plugins load with zero missing imports | Complete export contract | PASS |
| Updater Channel Isolation | Manifest points to csm-preview-latest.json |
Verified in tauri.conf.json |
PASS |
| Stop-Gate Verification | Prevent core replacement while process is active | Enforced via PID/port check | PASS |
| Rollback Capability | Full restore from pre-update checkpoint | Tested and verified | PASS |
| Automated Test Suite | All coa-core unit tests pass |
774/774 passed | PASS |
OVERALL BUILDER STATUS: QUALIFIED FOR PREVIEW DISTRIBUTION