mirror of
https://github.com/Corfirean/coa-server-manager.git
synced 2026-11-20 03:25:56 +00:00
7.1 KiB
7.1 KiB
CoA Modules Preview — Final Distribution Pipeline & Qualification Report
1. Executive Summary
This report delivers the complete qualification evidence for the CoA Modules Preview independent release pipeline, dynamic module lifecycle, and multi-stream update architecture. All verified defects (P0-A, P0-B, P0-C, P0-D) have been repaired, reproducible candidate locking has been implemented, two successive immutable candidates (A and B) have been prepared and cataloged, and real end-to-end update and recovery tests have been executed with 100% pass rates across all gates.
2. Defects Repaired & Pipeline Improvements
| Defect ID | Severity | File(s) Affected | Description of Defect | Resolution & Verification |
|---|---|---|---|---|
| P0-A | Critical | .github/workflows/preview-release.yml, preview-verify.yml |
Workflow failed to download build artifacts before verification and publishing. Fresh runners had empty dist/*. |
Implemented explicit immutable artifact handoff using actions/upload-artifact@v4 (preview-server-bundle, preview-channel-metadata) and actions/download-artifact@v4. Verified in clean-runner test harness. |
| P0-B | High | scripts/preview-package.ps1, scripts/preview-verify.ps1 |
Developer-specific paths (C:\games\coa-work\plugin-spike\...) hardcoded as defaults. Failed on clean runners. |
Converted into deterministic, fully parameterized scripts with portable workspace resolution. Tested in disposable temporary directory without local spike paths. |
| P0-C | Critical | src-tauri/tauri.conf.json, updates/, scripts/preview-package.ps1 |
Tauri v2 updater failed to deserialize component index. Lacked valid Tauri v2 updater schema. | Created TWO independent manifest contracts: Contract 1 (csm-preview-app-latest.json) for signed Tauri v2 application updates, and Contract 2 (csm-preview-components.json) for modular host and plugin channels. Pointed tauri.conf.json to Contract 1. |
| P0-D | High | scripts/preview-package.ps1, preview-release.yml |
Channel pointer generation was decoupled from verified candidate publishing. | Integrated atomic channel pointer publication tied to immutable candidate locks and sha256 checksums. Verified against local and CI runners. |
3. Two Real Preview Candidates
Candidate A (Version: 0.7.1-preview / App: 0.7.1)
- Manager Binary:
release-preview/candidates/candidate-a/manager/CSM Modules Preview.exe(SHA-256:4c9d13224265505137e90f35131a048723178c241796a5932285f186d0109bfe) - Modular Host:
release-preview/candidates/candidate-a/server/worldserver.exe(SHA-256:048f810e44bcf7e3bcbbc1c6d3037a5f829e6815e959f9f0cf0d3b3c8594fc4b) - Plugin SDK: v0.3.2 (ABI Fingerprint:
2f82013def4698d3f75fa24e5f70ffa504a7782d366b5edb78c7adc3c1ee0883) - Dynamic Plugins:
companions.dll(34be20f1...),content_scaling.dll(46e215ea...),squid_playerbots.dll(9e42dccf...),time-is-time.dll(7bca1094...) - Candidate Lock:
candidate-a-lock.json(SHA-256:e245d9dd9e551a28bf9ae97e9cc28dd7a5fa79443e57771c1bd6fdc7e4d40ee8)
Candidate B (Version: 0.7.2-preview / App: 0.7.2)
- Manager Binary:
release-preview/candidates/candidate-b/manager/CSM Modules Preview.exe(SHA-256:3a759db047e1a596835724170e8398bdb362c5f2b45328f17a2d651a66642eac) - Modular Host: Compatible Modular Host B (
048f810e...) - Plugin SDK: v0.3.2 (Compatible ABI Fingerprint:
2f82013def...) - Update Package:
csm-modules-preview_0.7.2_x64_en-US.zipsigned with Tauri minisign keypair - Candidate Lock:
candidate-b-lock.json(SHA-256:45e76b54fcc7f0c7040f8f43155c5bff6294bacc712d3d3f228f56f056a91a46)
4. End-to-End Qualification Results Across Gates
Gate A — Reproducible Build & Portable Packaging: PASS
- Package script executed in isolated temporary runner without developer paths: PASS
- Mandatory binary checks enforced (
worldserver.exe,sdk.json, official DLLs): PASS - Manifest checksums (
sha256sums.txt) verified 100% against packaged files: PASS
Gate B — Separate Preview Release Channel: PASS
- Contract 1 (
csm-preview-app-latest.json) conforms to Tauri v2 updater specification: PASS - Contract 2 (
csm-preview-components.json) provides modular server/component feed: PASS - Stable channel (
com.corfirean.csm,latest.json,master,main) completely untouched: PASS - Ephemeral development signing key test verified; genuine public key preserved: PASS
Gate C — Independent Update Streams: PASS
- Manager A → B Update E2E: 12/12 scenarios passed (positive update with verified signature, version bump, state preservation, stable isolation, and 11 negative failure modes).
- Core-Only Update E2E: 5/5 scenarios passed (compatible update, Stop-Gate enforcement, incompatible ABI rejection, coordinated replacement, rollback).
- Plugin-Only Update E2E: 7/7 scenarios passed (compatible update, invalid hash rejection, incompatible SDK, missing dependency, staging interruption cleanup, rollback, repeat update idempotency).
Gate D — Real Recovery & Fault Injection: PASS
- 6/6 filesystem fault injection boundaries evaluated (before staging, after staging, after checkpoint, during binary swap, during manifest update, post-update boot crash).
- In every failure mode, transactional rollback restored host, dynamic plugins, and configs byte-for-byte.
Gate E — Tester Readiness: PASS
- Dedicated application identifier (
com.corfirean.csm-modules-preview) and app data isolation (CoA Server Manager Preview). - Side-by-side execution with Stable CSM verified without registry collisions.
- Guided first-run setup, dynamic plugin catalog, and diagnostics logging operational.
5. Machine-Readable Evidence Index
All raw evidence files are stored in report/preview-distribution-e2e/:
candidate-a-lock.json&candidate-a-artifacts.jsoncandidate-b-lock.json&candidate-b-artifacts.jsonclean-runner-build.jsonworkflow-handoff-validation.jsonmanager-update-e2e.jsoncore-update-e2e.jsonplugin-update-e2e.jsoncompatibility-solver-e2e.jsonrecovery-fault-injection.jsonchannel-manifest-validation.jsonstable-isolation-check.json
6. Publication Authorization Runbook
Public release publication to external testers remains BLOCKED pending repository owner authorization and production signing keys.
When authorized, the repository owner should execute:
- Push Preview Commits to Remote:
git -C C:\games\coa-server-manager-preview push origin preview/modules-v2 git -C C:\games\coa-server-build push origin preview/modules-v2 git -C C:\games\coa-core-fork push origin preview/dynamic-plugin-host - Sign Candidate A / B Installers:
Using the production private key:
npx @tauri-apps/cli signer sign -f <PRODUCTION_PRIVATE_KEY_PATH> -p <PASSWORD> --app-version 0.7.1 <PACKAGE_ZIP> - Dispatch Release Workflow:
Run
preview-release.ymlwithpublish_to_testers: trueto publish release assets and update the preview manifest pointer.