Files
coa-server-manager/crates/coa-core/src/release_schema.rs
T

955 lines
37 KiB
Rust

//! Database acceptance for release packages, using a freshly extracted signed base fixture.
use crate::{
backup, fsx, install,
manifest::{Kind, Migration},
migrations, package, pkgsource,
release::{self, SqlFile},
schema_check, Error, Result,
};
use std::collections::HashSet;
use std::fs;
use std::path::Path;
const MARKER: &str = ".release-schema-fixture";
struct QualificationEnv<'a>(crate::update::RepackEnv<'a>);
impl crate::update::Env for QualificationEnv<'_> {
fn activate(&self) -> Result<()> {
Ok(())
}
fn ensure_stopped(&self) -> Result<()> {
self.0.ensure_stopped()
}
fn preflight(&self, manifest: &crate::manifest::Manifest) -> Result<()> {
self.0.preflight(manifest)
}
fn snapshot(&self) -> Result<String> {
self.0.snapshot()
}
fn verify_snapshot(&self, id: &str) -> Result<()> {
self.0.verify_snapshot(id)
}
fn restore_snapshot(&self, id: &str) -> Result<()> {
self.0.restore_snapshot(id)
}
fn migrate(
&self,
manifest: &crate::manifest::Manifest,
staged: &Path,
) -> Result<crate::migrations::ApplyReport> {
self.0.migrate(manifest, staged)
}
fn validate(&self) -> Result<()> {
self.0.validate()
}
fn validate_recovery(&self) -> Result<()> {
self.0.validate_recovery()
}
fn recover_validation(&self) -> Result<()> {
self.0.recover_validation()
}
fn automatic_rollback(&self) -> bool {
true
}
// Health checks use the normal private validation; qualification never opens game ports after commit.
}
pub fn qualify_upgrade(
base: &Path,
source: &Path,
candidate: &Path,
fixture: &Path,
trusted_key: &str,
) -> Result<serde_json::Value> {
use crate::update::Env;
if !cfg!(windows) {
return Err(Error::Invalid(
"Manager upgrade qualification requires a Windows fixture.".into(),
));
}
if fixture.exists()
|| !fixture
.file_name()
.is_some_and(|name| name.to_string_lossy().starts_with("coa-schema-fixture-"))
{
return Err(Error::Invalid(
"Upgrade qualification requires a new disposable coa-schema-fixture-* directory."
.into(),
));
}
let fixture_root = std::path::absolute(fixture)?;
let fixture = fixture_root.as_path();
let base_root = fsx::canonicalize_lenient(base)?;
let base = base_root.as_path();
let source_root = fsx::canonicalize_lenient(source)?;
let source = source_root.as_path();
let candidate_root = fsx::canonicalize_lenient(candidate)?;
let candidate = candidate_root.as_path();
let metadata = crate::registry::metadata_dir_for(fixture)?;
if metadata.exists() {
return Err(Error::Invalid(
"Upgrade fixture metadata already exists.".into(),
));
}
let (base_manifest, base_bytes) =
pkgsource::fetch_manifest(&pkgsource::Source::Dir(base.into()), trusted_key)?;
let (source_manifest, source_bytes) =
pkgsource::fetch_manifest(&pkgsource::Source::Dir(source.into()), trusted_key)?;
let (candidate_manifest, candidate_bytes) =
pkgsource::fetch_manifest(&pkgsource::Source::Dir(candidate.into()), trusted_key)?;
if candidate_manifest.kind != Kind::Update
|| !matches!(source_manifest.kind, Kind::Base | Kind::Update)
|| (source_manifest.kind == Kind::Base
&& fsx::sha256_bytes(&base_bytes) != fsx::sha256_bytes(&source_bytes))
{
return Err(Error::Invalid(
"Invalid source or candidate package for upgrade qualification.".into(),
));
}
extract_base(base, fixture, trusted_key)?;
package::extract_selected(
base,
&base_manifest,
fixture,
&|path| path.starts_with("Data/"),
&|_, _| {},
)?;
let mut meta = crate::registry::InstallMeta::new(crate::registry::InstallKind::New, fixture);
meta.core.version = Some(base_manifest.version.clone());
meta.core.commit = base_manifest.core.commit.clone();
meta.original_hashes = base_manifest
.files
.iter()
.map(|file| (file.path.clone(), file.sha256.clone()))
.collect();
crate::registry::MetaDir::create(fixture, &meta)?;
let env = QualificationEnv(crate::update::RepackEnv {
root: fixture,
meta_dir: &metadata,
});
let apply = |package: &Path| -> Result<()> {
let outcome = crate::update::apply(
&crate::update::Params {
root: fixture,
meta_dir: &metadata,
source: pkgsource::Source::Dir(package.into()),
trusted_key,
cancel: crate::download::Cancel::default(),
resolutions: Default::default(),
env: &env,
fail_after_ops: None,
},
&|_, _| {},
)?;
if outcome.txn.state != crate::update::State::Committed {
return Err(Error::Invalid(
"Upgrade qualification did not commit.".into(),
));
}
env.ensure_stopped()
};
let mut migration_audit = None;
install::with_scratch_ports(fixture, || {
if source_manifest.kind == Kind::Update {
apply(source)?;
}
let user_file = fixture.join("Core/configs/coa-qualification-user.conf");
let user_bytes = b"Qualification.UserSetting = 7391\r\n";
fsx::atomic_write(&user_file, user_bytes)?;
apply(candidate)?;
migration_audit = Some(audit_migrations(fixture, &candidate_manifest.migrations)?);
if std::fs::read(&user_file)?.as_slice() != user_bytes {
return Err(Error::Invalid(
"The update changed a user configuration file.".into(),
));
}
let (_, installed) = crate::registry::MetaDir::open(&metadata)?;
if installed.core.version.as_deref() != Some(candidate_manifest.version.as_str())
|| crate::update_isolation::pending(&metadata)
|| crate::update::pending_checked(&metadata)?.is_some()
{
return Err(Error::Invalid(
"The update left inconsistent metadata or an unfinished transaction.".into(),
));
}
Ok(())
})?;
Ok(serde_json::json!({
"schema": 1, "result": "passed", "fromVersion": source_manifest.version,
"toVersion": candidate_manifest.version, "toManifestSha256": fsx::sha256_bytes(&candidate_bytes),
"migrationInventorySha256": migrations::inventory_sha256(&candidate_manifest.migrations)?, "migrations": migration_audit, "fromManifestSha256": fsx::sha256_bytes(&source_bytes),
"fromSchemaSha256": source_manifest.files.iter().find(|file| file.path == schema_check::CONTRACT).map(|file| &file.sha256),
"checks": ["legacy-race-start-data", "migration-ledger", "manager-transaction", "recovery-backed-database-update", "database-schema", "private-auth-world-startup", "existing-identities", "user-file-preservation"],
}))
}
pub fn compose_install(
base: &Path,
candidate: &Path,
fixture: &Path,
trusted_key: &str,
) -> Result<()> {
qualify_upgrade(base, base, candidate, fixture, trusted_key)?;
let fixture = fsx::canonicalize_lenient(fixture)?;
let (_, bytes) =
pkgsource::fetch_manifest(&pkgsource::Source::Dir(candidate.into()), trusted_key)?;
let manifest = crate::manifest::Manifest::parse(&bytes)?;
install::with_scratch_ports(&fixture, || {
backup::with_database(&fixture, |db| {
let players = db.query(&format!(
"SELECT COUNT(*) FROM acore_characters.characters WHERE account<>{};",
crate::companions::TEMPLATE_ACCOUNT
))?;
if players.trim() != "0" || crate::companions::template_count(db)? != 21 {
return Err(Error::Invalid(
"The installation image contains unexpected player characters.".into(),
));
}
for table in crate::cleanbase::AUTH_PLAYER_TABLES {
if db.tables("acore_auth")?.iter().any(|name| name == table) {
db.query(&format!("DELETE FROM acore_auth.`{table}`;"))?;
}
}
if let Some(problem) = schema_check::check(db, &fixture)?.first() {
return Err(Error::Invalid(format!(
"Installation image schema mismatch: {}.{}",
problem.table, problem.column
)));
}
Ok(())
})
})?;
fs::remove_file(fixture.join("Core/configs/coa-qualification-user.conf"))?;
let path = fixture.join("Settings/repack.json");
let mut settings: serde_json::Value = fsx::read_json(&path)?;
settings["raPassword"] = "".into();
fsx::atomic_write_json(&path, &settings)?;
fsx::atomic_write_json(
&fixture.join("Settings/install-source.json"),
&serde_json::json!({
"version": manifest.version, "core": manifest.core, "bots": manifest.bots,
"updateManifestSha256": fsx::sha256_bytes(&bytes),
}),
)?;
crate::mysql_snapshot::stop(&fixture)?;
fs::remove_file(fixture.join(MARKER))?;
Ok(())
}
pub fn qualify_install(
package: &Path,
fixture: &Path,
trusted_key: &str,
) -> Result<serde_json::Value> {
qualify_install_against(package, None, fixture, trusted_key)
}
pub fn qualify_install_against(
package: &Path,
update: Option<&Path>,
fixture: &Path,
trusted_key: &str,
) -> Result<serde_json::Value> {
use crate::update::Env;
if !cfg!(windows)
|| fixture.exists()
|| !fixture
.file_name()
.is_some_and(|name| name.to_string_lossy().starts_with("coa-schema-fixture-"))
{
return Err(Error::Invalid(
"Clean installation qualification requires a new disposable Windows fixture.".into(),
));
}
let fixture = std::path::absolute(fixture)?;
let package = fsx::canonicalize_lenient(package)?;
let (manifest, bytes) =
pkgsource::fetch_manifest(&pkgsource::Source::Dir(package.clone()), trusted_key)?;
let expected_update = update
.map(|path| pkgsource::fetch_manifest(&pkgsource::Source::Dir(path.into()), trusted_key))
.transpose()?;
if let Some((expected, _)) = &expected_update {
if expected.kind != Kind::Update
|| expected.version != manifest.version
|| expected.core.commit != manifest.core.commit
|| expected.bots.as_ref().and_then(|b| b.commit.as_ref())
!= manifest.bots.as_ref().and_then(|b| b.commit.as_ref())
{
return Err(Error::Invalid(
"Clean installation image does not match the selected release.".into(),
));
}
}
let registry_dir = tempfile::tempdir()?;
let registry = crate::registry::Registry::at(registry_dir.path().join("registry.json"));
let installed = install::install_base(
&install::Params {
source: pkgsource::Source::Dir(package),
dest: fixture.clone(),
trusted_key,
registry: &registry,
cancel: crate::download::Cancel::default(),
},
&|_| {},
)?;
let metadata = crate::registry::metadata_dir_for(&fixture)?;
let env = QualificationEnv(crate::update::RepackEnv {
root: &fixture,
meta_dir: &metadata,
});
env.validate()?;
env.ensure_stopped()?;
crate::mysql_snapshot::stop(&fixture)?;
if installed.version != manifest.version || crate::update::pending_checked(&metadata)?.is_some()
{
return Err(Error::Invalid(
"Clean installation did not finish at the packaged release.".into(),
));
}
let migration_audit = expected_update
.as_ref()
.map(|(expected, _)| audit_migrations(&fixture, &expected.migrations))
.transpose()?;
env.ensure_stopped()?;
crate::mysql_snapshot::stop(&fixture)?;
let inventory = expected_update
.as_ref()
.map(|(expected, _)| migrations::inventory_sha256(&expected.migrations))
.transpose()?;
let mut checks = vec![
"clean-install",
"signed-full-package",
"credential-rotation",
"schema-contract",
"private-auth-world-startup",
];
if expected_update.is_some() {
checks.push("migration-ledger");
checks.push("legacy-race-start-data");
}
Ok(
serde_json::json!({ "schema": 1, "result": "passed", "version": installed.version,
"manifestSha256": fsx::sha256_bytes(&bytes),
"checks": checks, "migrationInventorySha256": inventory, "migrations": migration_audit }),
)
}
fn audit_migrations(
root: &Path,
list: &[Migration],
) -> Result<std::collections::BTreeMap<String, migrations::Audit>> {
install::with_scratch_ports(root, || {
backup::with_database(root, |db| {
crate::realms::state(root)?
.modes()
.into_iter()
.map(|mode| {
if mode == crate::realms::Mode::Coa {
let rows = db
.clone()
.for_realm(mode)
.query("SELECT race,class FROM acore_world.playercreateinfo;")?;
let missing = missing_legacy_starts(&rows);
if !missing.is_empty() {
return Err(Error::Invalid(format!(
"Release is missing legacy race starting data: {}",
missing.join(", ")
)));
}
}
Ok((
mode.name().to_string(),
migrations::audit_applied(&db.clone().for_realm(mode), list)?,
))
})
.collect()
})
})
}
fn missing_legacy_starts(rows: &str) -> Vec<String> {
let pairs: std::collections::BTreeSet<(u32, u32)> = rows
.lines()
.filter_map(|line| line.split_once('\t'))
.filter_map(|(race, class)| Some((race.parse().ok()?, class.parse().ok()?)))
.collect();
let mut missing = Vec::new();
for (race, parent) in [(33, 1), (45, 8)] {
for &(source, class) in &pairs {
if source == parent && !pairs.contains(&(race, class)) {
missing.push(format!("race {race} / class {class}"));
}
}
}
missing
}
pub fn collect(core: &Path, bots: Option<&Path>, repairs: Option<&Path>) -> Result<Vec<SqlFile>> {
let mut files = release::collect_core_sql(core)?;
if let Some(bots) = bots {
files.extend(release::collect_bots_sql(bots)?);
}
if let Some(repairs) = repairs {
for kind in ["auth", "characters", "world"] {
let dir = repairs.join(kind);
if !dir.exists() {
continue;
}
let mut paths: Vec<_> = std::fs::read_dir(&dir)?
.map(|e| e.map(|e| e.path()))
.collect::<std::io::Result<_>>()?;
paths.sort();
for path in paths
.into_iter()
.filter(|p| p.extension().is_some_and(|e| e == "sql"))
{
let stem = path.file_stem().unwrap().to_string_lossy();
files.push(SqlFile {
db: kind.into(),
id: format!("manager_repair__{stem}"),
origin: format!("{kind}/{stem}.sql"),
sha256: fsx::sha256_file(&path)?,
abs: path,
});
}
}
}
let mut seen = HashSet::new();
for file in &files {
if !seen.insert((&file.db, &file.id)) {
return Err(Error::Invalid(format!(
"Duplicate release migration: {} / {}",
file.db, file.id
)));
}
}
Ok(files)
}
pub fn extract_base(source: &Path, fixture: &Path, trusted_key: &str) -> Result<()> {
if fixture.exists()
|| !fixture
.file_name()
.is_some_and(|n| n.to_string_lossy().starts_with("coa-schema-fixture-"))
{
return Err(Error::Invalid(
"Use a new coa-schema-fixture-* directory for release validation.".into(),
));
}
let (manifest, _) =
pkgsource::fetch_manifest(&pkgsource::Source::Dir(source.into()), trusted_key)?;
if manifest.kind != Kind::Base {
return Err(Error::Invalid(
"Release schema validation needs a signed base package.".into(),
));
}
package::extract_selected(
source,
&manifest,
fixture,
&|path| {
let path = path.to_ascii_lowercase();
[
"mysql/",
"settings/",
"runtime/",
"scripts/",
"core/",
"bugreport/",
]
.iter()
.any(|prefix| path.starts_with(prefix))
},
&|_, _| {},
)?;
fsx::atomic_write(&fixture.join(MARKER), b"disposable release-schema fixture")?;
// A Linux computer has no Windows database program: the fixture is a Docker server over the package's data directory.
if cfg!(windows) {
install::bootstrap_database(fixture)
} else {
crate::docker::fixture::prepare(fixture)
}
}
pub fn capture_release(fixture: &Path, tree: &Path, sql: &[SqlFile]) -> Result<()> {
if !fixture
.file_name()
.is_some_and(|n| n.to_string_lossy().starts_with("coa-schema-fixture-"))
|| std::fs::read(fixture.join(MARKER)).ok().as_deref()
!= Some(b"disposable release-schema fixture")
{
return Err(Error::Invalid(
"Refusing to apply release SQL to a non-fixture server.".into(),
));
}
let staging = tempfile::tempdir()?;
let migrations: Vec<_> = sql
.iter()
.map(|f| Migration {
compatible_sha256: vec![],
db: f.db.clone(),
id: f.id.clone(),
sha256: f.sha256.clone(),
destructive: false,
})
.collect();
for file in sql {
let path = fsx::safe_join(staging.path(), &format!("{}/{}.sql", file.db, file.id))?;
fsx::atomic_write(&path, &std::fs::read(&file.abs)?)?;
}
install::with_scratch_ports(fixture, || {
backup::with_database(fixture, |db| {
let db = db.clone().for_realm(crate::realms::Mode::Coa);
let report = migrations::apply_pending(&db, &migrations, staging.path(), &|| {
Ok("disposable release fixture".into())
})?;
if let Some((id, why)) = report.failed {
return Err(Error::Invalid(format!(
"Release migration {id} failed: {why}"
)));
}
// Validate known critical feature effects before capturing; history may be stale in the base.
let previous = tree.join(schema_check::CONTRACT);
if previous.exists() {
return Err(Error::Invalid("Release tree already contains a schema contract; generate it from a fresh tree.".into()));
}
let problems = schema_check::check(&db, tree)?;
if let Some(p) = problems.first() {
return Err(Error::Invalid(format!(
"Release database failed validation: {}.{}.{}: {}",
p.database, p.table, p.column, p.detail
)));
}
schema_check::capture(&db, tree)?;
schema_check::require_release_contract(tree)?;
Ok(())
})
})
}
pub fn validate_startup(fixture: &Path, tree: &Path, base: &Path, trusted_key: &str) -> Result<()> {
use crate::update::Env;
if !cfg!(windows) {
return Err(Error::Invalid(
"Repack startup qualification requires a Windows runner.".into(),
));
}
if !fixture
.file_name()
.is_some_and(|n| n.to_string_lossy().starts_with("coa-schema-fixture-"))
|| std::fs::read(fixture.join(MARKER)).ok().as_deref()
!= Some(b"disposable release-schema fixture")
{
return Err(Error::Invalid(
"Startup qualification requires a disposable release-schema fixture.".into(),
));
}
let fixture_root = fsx::canonicalize_lenient(fixture)?;
let fixture = fixture_root.as_path();
let tree_root = fsx::canonicalize_lenient(tree)?;
let tree = tree_root.as_path();
let metadata = crate::registry::metadata_dir_for(fixture)?;
if metadata.exists() {
return Err(Error::Invalid(
"Startup fixture already has Manager metadata; use a fresh fixture.".into(),
));
}
schema_check::require_release_contract(tree)?;
for name in ["worldserver.exe", "authserver.exe"] {
if !tree.join("Core").join(name).is_file() {
return Err(Error::Invalid(format!(
"Startup candidate is missing {name}."
)));
}
}
let (manifest, _) =
pkgsource::fetch_manifest(&pkgsource::Source::Dir(base.into()), trusted_key)?;
if manifest.kind != Kind::Base {
return Err(Error::Invalid(
"Startup qualification requires a signed base package.".into(),
));
}
let mut directories = vec![tree.to_path_buf()];
let mut files = Vec::new();
while let Some(directory) = directories.pop() {
for entry in std::fs::read_dir(directory)? {
let entry = entry?;
let kind = entry.file_type()?;
if kind.is_symlink() {
return Err(Error::Invalid(
"Startup release tree must not contain symbolic links.".into(),
));
}
let path = entry.path();
fsx::ensure_within(tree, &path)?;
if kind.is_dir() {
directories.push(path);
continue;
}
if !kind.is_file() {
return Err(Error::Invalid(
"Startup release tree contains an unsupported file type.".into(),
));
}
let relative = path
.strip_prefix(tree)
.map_err(|e| Error::Invalid(e.to_string()))?
.to_path_buf();
let first = relative
.components()
.next()
.unwrap()
.as_os_str()
.to_string_lossy();
if !matches!(
first.as_ref(),
"Core" | "Scripts" | "Data" | "Extras" | "Licenses"
) {
return Err(Error::Invalid(
"Startup release tree contains installation-specific files.".into(),
));
}
fsx::ensure_within(fixture, &fixture.join(&relative))?;
files.push(relative);
}
}
package::extract_selected(
base,
&manifest,
fixture,
&|path| path.starts_with("Data/"),
&|_, _| {},
)?;
for relative in files {
let target = fsx::ensure_within(fixture, &fixture.join(&relative))?;
fsx::atomic_write(&target, &std::fs::read(tree.join(&relative))?)?;
let expected = fsx::sha256_file(&tree.join(relative))?;
if fsx::sha256_file(&target)? != expected {
return Err(Error::Invalid(
"Startup candidate copy failed verification.".into(),
));
}
}
let meta = crate::registry::InstallMeta::new(crate::registry::InstallKind::New, fixture);
crate::registry::MetaDir::create(fixture, &meta)?;
let env = crate::update::RepackEnv {
root: fixture,
meta_dir: &metadata,
};
env.validate()?;
env.ensure_stopped()?;
if crate::update_isolation::pending(&metadata) {
return Err(Error::Invalid(
"Startup qualification left unfinished isolated validation.".into(),
));
}
Ok(())
}
pub fn verify_package(dir: &Path, trusted_key: &str) -> Result<()> {
verify_package_source(dir, &pkgsource::Source::Dir(dir.into()), trusted_key)
}
pub fn verify_install_package(dir: &Path, trusted_key: &str) -> Result<()> {
verify_package_source(
dir,
&pkgsource::Source::Installation(Box::new(pkgsource::Source::Dir(dir.into()))),
trusted_key,
)
}
fn verify_package_source(dir: &Path, source: &pkgsource::Source, trusted_key: &str) -> Result<()> {
let (manifest, _) = pkgsource::fetch_manifest(source, trusted_key)?;
if !manifest
.files
.iter()
.any(|f| f.path == schema_check::CONTRACT && f.size > 0)
{
return Err(Error::Invalid(
"The release is missing its database schema contract.".into(),
));
}
let scratch = tempfile::tempdir()?;
package::extract_selected(
dir,
&manifest,
scratch.path(),
&|p| p == schema_check::CONTRACT,
&|_, _| {},
)?;
schema_check::require_release_contract(scratch.path())?;
Ok(())
}
pub fn verify_upgrade_fixture(dir: &Path, trusted_key: &str) -> Result<()> {
let (manifest, _) =
pkgsource::fetch_manifest(&pkgsource::Source::Dir(dir.into()), trusted_key)?;
if !matches!(manifest.kind, Kind::Base | Kind::Update) {
return Err(Error::Invalid(
"Upgrade fixtures must be base or server update packages.".into(),
));
}
let scratch = tempfile::tempdir()?;
package::extract_selected(
dir,
&manifest,
scratch.path(),
&|path| path == schema_check::CONTRACT,
&|_, _| {},
)?;
if manifest.kind == Kind::Update
|| manifest
.files
.iter()
.any(|file| file.path == schema_check::CONTRACT)
{
schema_check::require_release_contract(scratch.path())?;
}
Ok(())
}
#[cfg(test)]
mod tests {
use super::*;
use base64::{engine::general_purpose::STANDARD, Engine};
use ed25519_dalek::{Signer, SigningKey};
#[test]
#[ignore = "Requires the disposable current-release installation audit fixture"]
fn real_current_image_is_blocked_until_legacy_start_data_is_restored() {
let root = std::path::PathBuf::from(std::env::var_os("COA_RELEASE_AUDIT_FIXTURE").unwrap());
assert_eq!(
root.file_name().unwrap(),
"coa-schema-fixture-latest-install-audit-20261030"
);
assert!(root.join(".release-schema-fixture").is_file());
assert!(!root.join("legacy-release-gate-probe-started").exists());
fsx::atomic_write(
&root.join("legacy-release-gate-probe-started"),
b"disposable regression test",
)
.unwrap();
let candidate =
std::path::PathBuf::from(std::env::var_os("COA_RELEASE_AUDIT_PACKAGE").unwrap());
let (manifest, _) = pkgsource::fetch_manifest(
&pkgsource::Source::Dir(candidate),
crate::signing::EMBEDDED_PUBLIC_KEY,
)
.unwrap();
let failure = audit_migrations(&root, &manifest.migrations).unwrap_err();
assert!(failure.to_string().contains("race 33 / class 12"));
assert!(failure.to_string().contains("race 45 / class 30"));
println!("PASS: signed current image is blocked for missing legacy starts despite a complete migration ledger");
let sql =
fs::read_to_string(std::env::var_os("COA_RELEASE_AUDIT_CORRECTION").unwrap()).unwrap();
install::with_scratch_ports(&root, || backup::with_database(&root, |db| {
let before = db.query("SELECT * FROM acore_characters.characters ORDER BY guid;")?;
db.query(&format!("USE acore_world;\n{sql}"))?;
let once = db.query("SELECT * FROM acore_world.playercreateinfo WHERE race IN (33,45) ORDER BY race,class;")?;
db.query(&format!("USE acore_world;\n{sql}"))?;
assert_eq!(once, db.query("SELECT * FROM acore_world.playercreateinfo WHERE race IN (33,45) ORDER BY race,class;")?);
assert_eq!(before, db.query("SELECT * FROM acore_characters.characters ORDER BY guid;")?);
Ok(())
})).unwrap();
let audits = audit_migrations(&root, &manifest.migrations).unwrap();
println!("PASS: corrected data passes the release gate; characters unchanged; correction idempotent; audit={}", serde_json::to_string(&audits).unwrap());
}
#[test]
fn release_rejects_missing_legacy_starts_even_without_existing_characters() {
assert_eq!(
missing_legacy_starts("1\t12\n8\t30\n"),
["race 33 / class 12", "race 45 / class 30"]
);
assert!(missing_legacy_starts("1\t12\n8\t30\n33\t12\n45\t30\n").is_empty());
}
#[test]
#[ignore = "Requires a composed disposable installation image"]
fn real_full_package_installs_the_current_version_without_an_update_transaction() {
let image = std::path::PathBuf::from(
std::env::var_os("COA_INSTALL_IMAGE_DIR").expect("COA_INSTALL_IMAGE_DIR"),
);
let provenance: serde_json::Value =
fsx::read_json(&image.join("Settings/install-source.json")).unwrap();
let root = tempfile::tempdir().unwrap();
let package = root.path().join("package");
let options = package::BuildOptions {
kind: Kind::Base,
version: provenance["version"].as_str().unwrap().into(),
core_commit: provenance["core"]["commit"].as_str().map(String::from),
bots_commit: provenance["bots"]["commit"].as_str().map(String::from),
built_at: "qualification".into(),
part_size: package::DEFAULT_PART_SIZE,
migrations: vec![],
};
package::build(&image, &package, &options, &|_| {}).unwrap();
let signing_key = SigningKey::generate(&mut rand_core::OsRng);
let bytes = fs::read(package.join("manifest.json")).unwrap();
fs::write(
package.join("manifest.json.sig"),
STANDARD.encode(signing_key.sign(&bytes).to_bytes()),
)
.unwrap();
let trusted_key = STANDARD.encode(signing_key.verifying_key().to_bytes());
let fixture = root.path().join("coa-schema-fixture-clean-install");
let report = qualify_install(&package, &fixture, &trusted_key).unwrap();
assert_eq!(report["version"], provenance["version"]);
assert_eq!(report["result"], "passed");
let metadata = crate::registry::metadata_dir_for(&fixture).unwrap();
let (_, installed) = crate::registry::MetaDir::open(&metadata).unwrap();
assert_eq!(
installed.core.version.as_deref(),
provenance["version"].as_str()
);
assert!(!metadata
.join("updates")
.read_dir()
.is_ok_and(|mut entries| entries.next().is_some()));
}
#[test]
fn relative_startup_fixture_targets_replace_the_original_location() {
let directory = tempfile::Builder::new()
.prefix("coa-schema-fixture-path-test-")
.tempdir_in(".")
.unwrap();
let current = std::env::current_dir().unwrap();
let relative = directory.path().strip_prefix(&current).unwrap();
fsx::atomic_write(&relative.join("Core/worldserver.exe"), b"old").unwrap();
let root = fsx::canonicalize_lenient(relative).unwrap();
let target = fsx::ensure_within(&root, &root.join("Core/worldserver.exe")).unwrap();
fsx::atomic_write(&target, b"candidate").unwrap();
assert_eq!(
std::fs::read(relative.join("Core/worldserver.exe")).unwrap(),
b"candidate"
);
assert!(!root.join(relative).join("Core/worldserver.exe").exists());
}
#[test]
fn startup_qualification_refuses_real_server_folders_before_writes() {
let directory = tempfile::tempdir().unwrap();
let server = directory.path().join("live-server");
std::fs::create_dir(&server).unwrap();
fsx::atomic_write(&server.join("owner-data"), b"untouched").unwrap();
assert!(validate_startup(&server, directory.path(), directory.path(), "unused").is_err());
assert_eq!(
std::fs::read(server.join("owner-data")).unwrap(),
b"untouched"
);
assert!(!crate::registry::metadata_dir_for(&server).unwrap().exists());
}
#[test]
fn signed_packages_must_carry_a_real_complete_schema_contract() {
let dir = tempfile::tempdir().unwrap();
let tree = dir.path().join("tree");
let out = dir.path().join("out");
fsx::atomic_write(&tree.join("Core/worldserver.exe"), b"fixture").unwrap();
let key = SigningKey::from_bytes(&[7; 32]);
let public = STANDARD.encode(key.verifying_key().as_bytes());
let opts = package::BuildOptions {
kind: Kind::Update,
version: "1.0.0".into(),
core_commit: None,
bots_commit: None,
built_at: "test".into(),
part_size: 1024 * 1024,
migrations: vec![],
};
let sign = || {
let bytes = std::fs::read(out.join("manifest.json")).unwrap();
fsx::atomic_write(
&out.join("manifest.json.sig"),
STANDARD.encode(key.sign(&bytes).to_bytes()).as_bytes(),
)
.unwrap();
};
package::build(&tree, &out, &opts, &|_| {}).unwrap();
sign();
assert!(verify_package(&out, &public).is_err());
fsx::atomic_write(
&tree.join(schema_check::CONTRACT),
br#"{"schema":1,"columns":{}}"#,
)
.unwrap();
package::build(&tree, &out, &opts, &|_| {}).unwrap();
sign();
assert!(verify_package(&out, &public).is_err());
fsx::atomic_write(&tree.join(schema_check::CONTRACT), br#"{"schema":1,"columns":{"auth":{"account":{"id":"int"}},"characters":{"characters":{"guid":"int"}},"world":{"creature":{"id":"int"}}}}"#).unwrap();
package::build(&tree, &out, &opts, &|_| {}).unwrap();
sign();
verify_package(&out, &public).unwrap();
}
#[test]
fn repair_sql_has_new_ids_and_runs_after_original_sql() {
let dir = tempfile::tempdir().unwrap();
let core = dir.path().join("core");
let repairs = dir.path().join("repairs");
fsx::atomic_write(
&core.join("data/sql/updates/pending_db_characters/old.sql"),
b"SELECT 1;",
)
.unwrap();
fsx::atomic_write(
&repairs.join("characters/20261005_wildcard.sql"),
b"SELECT 2;",
)
.unwrap();
let files = collect(&core, None, Some(&repairs)).unwrap();
assert_eq!(
files.iter().map(|f| f.id.as_str()).collect::<Vec<_>>(),
["old", "manager_repair__20261005_wildcard"]
);
assert_eq!(files[1].db, "characters");
}
#[test]
fn existing_server_cannot_be_used_for_schema_generation() {
let dir = tempfile::tempdir().unwrap();
assert!(extract_base(dir.path(), dir.path(), "irrelevant").is_err());
assert!(capture_release(dir.path(), dir.path(), &[]).is_err());
assert!(
qualify_upgrade(dir.path(), dir.path(), dir.path(), dir.path(), "irrelevant").is_err()
);
assert!(!dir.path().join(schema_check::CONTRACT).exists());
}
#[test]
fn only_legacy_base_fixtures_may_omit_the_schema_contract() {
let dir = tempfile::tempdir().unwrap();
let tree = dir.path().join("tree");
let out = dir.path().join("package");
fsx::atomic_write(&tree.join("Core/example.txt"), b"fixture").unwrap();
let key = SigningKey::from_bytes(&[29; 32]);
let public = STANDARD.encode(key.verifying_key().as_bytes());
let options = package::BuildOptions {
kind: Kind::Base,
version: "0.2.0".into(),
core_commit: None,
bots_commit: None,
built_at: "test".into(),
part_size: 1024 * 1024,
migrations: vec![],
};
package::build(&tree, &out, &options, &|_| {}).unwrap();
let sign = || {
let bytes = std::fs::read(out.join("manifest.json")).unwrap();
fsx::atomic_write(
&out.join("manifest.json.sig"),
STANDARD.encode(key.sign(&bytes).to_bytes()).as_bytes(),
)
.unwrap();
};
sign();
verify_upgrade_fixture(&out, &public).unwrap();
assert!(verify_package(&out, &public).is_err());
let mut manifest: serde_json::Value = fsx::read_json(&out.join("manifest.json")).unwrap();
manifest["kind"] = "update".into();
fsx::atomic_write_json(&out.join("manifest.json"), &manifest).unwrap();
sign();
assert!(verify_upgrade_fixture(&out, &public).is_err());
}
}