ADR-0063: manifest v2 (360 bytes) binds a per-tick validation trace object and a canonical decision block by SHA-256. Publication replays the trace from the committed predecessor's verified payload and requires every report and the candidate bytes, derives deaths deterministically, uploads payload and trace with verified read-back, then sends manifest and decisions to one fenced statement. RegionBatch seals at a terminal transition or 64 ticks and refuses ticks until durable confirmation. Schema v5 records the checkpoint, its decisions and outbox rows atomically; a unique index keeps one terminal outcome per actor (EVL08), triggers make commits/decisions immutable (EVL09), an exact retry of a committed ID returns the original receipt, changed bytes conflict, and read-only resolve_region_commit answers committed/absent/ conflict. Outbox pending/acknowledge give idempotent at-least-once delivery. Recovery reconciles durable deaths with restored lifecycle (and archive deaths for the lineage profile). Validated: Windows CTest 58/58; Linux GCC Debug/Release, clang-tidy and ASan/UBSan CTest 58/58 each; PostgreSQL suites Release, analysis, ASan (lost response, committed-after-timeout, terminated orphan retry, changed bytes, repeated/partial/reordered decisions, gap, outbox redelivery, history quarantine); five mutations each caught. No Docker/Gitea CI, process kill, broker or deployment. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
116 lines
8.5 KiB
Bash
116 lines
8.5 KiB
Bash
#!/usr/bin/env bash
|
|
set -euo pipefail
|
|
root="$(cd "$(dirname "$0")/../.." && pwd)"
|
|
prefix="$root/.cache/postgres/install"
|
|
export PATH="$prefix/bin:$PATH"
|
|
export LD_LIBRARY_PATH="$prefix/lib${LD_LIBRARY_PATH:+:$LD_LIBRARY_PATH}"
|
|
test_dir="$(mktemp -d /tmp/evo-pg-test.XXXXXXXX)"
|
|
chmod 700 "$test_dir"
|
|
export PGHOST="$test_dir" PGPORT=55432 PGDATABASE=postgres PGUSER="$(id -un)"
|
|
unset PGHOSTADDR PGPASSWORD PGSERVICE PGSERVICEFILE
|
|
initdb -D "$test_dir/data" --no-locale --encoding=UTF8 --auth-local=trust --auth-host=reject > "$test_dir/init.log"
|
|
trap 'pg_ctl -D "$test_dir/data" -m immediate stop > /dev/null || true' EXIT
|
|
pg_ctl -D "$test_dir/data" -l "$test_dir/server.log" -o "-k $test_dir -p 55432 -c listen_addresses=''" -w start
|
|
# Runtime group role receives grants; a separate login inherits only that role.
|
|
psql -X -v ON_ERROR_STOP=1 -c 'CREATE ROLE evo_runtime_test NOLOGIN' \
|
|
-c 'CREATE ROLE evo_runtime_login LOGIN IN ROLE evo_runtime_test'
|
|
export EVO_PG_RUNTIME_ROLE=evo_runtime_test EVO_PG_RUNTIME_USER=evo_runtime_login
|
|
bash "$root/tools/migrate-postgres.sh"
|
|
bash "$root/tools/migrate-postgres.sh" # exact supported upgrade/restart is a no-op
|
|
"${1:?path to evo-postgres-tests}"
|
|
v1_sha="$(sha256sum "$root/migrations/0001_region_bootstrap.sql")"
|
|
v1_sha="${v1_sha%% *}"
|
|
# Migration failure must not publish a partial schema.
|
|
createdb migration_rollback
|
|
if (export PGDATABASE=migration_rollback; psql -X -v ON_ERROR_STOP=1 -1 \
|
|
-v migration_sha=invalid -f "$root/migrations/0001_region_bootstrap.sql"); then
|
|
echo 'Expected failed migration' >&2; exit 1
|
|
fi
|
|
test "$(PGDATABASE=migration_rollback psql -XAtc "SELECT count(*) FROM pg_namespace WHERE nspname='evolution'")" = 0
|
|
# A privileged or owner runtime role is refused and leaves no schema behind.
|
|
if (export PGDATABASE=migration_rollback EVO_PG_RUNTIME_ROLE="$PGUSER"; \
|
|
bash "$root/tools/migrate-postgres.sh"); then
|
|
echo 'Expected privileged runtime role rejection' >&2; exit 1
|
|
fi
|
|
if (export PGDATABASE=migration_rollback EVO_PG_RUNTIME_ROLE=no_such_evo_role; \
|
|
bash "$root/tools/migrate-postgres.sh"); then
|
|
echo 'Expected missing runtime role rejection' >&2; exit 1
|
|
fi
|
|
test "$(PGDATABASE=migration_rollback psql -XAtc "SELECT count(*) FROM pg_namespace WHERE nspname='evolution'")" = 0
|
|
# Supported upgrade path: an existing exact v1 database migrates to the latest.
|
|
createdb upgrade_path
|
|
PGDATABASE=upgrade_path psql -X -v ON_ERROR_STOP=1 -1 -v "migration_sha=$v1_sha" \
|
|
-f "$root/migrations/0001_region_bootstrap.sql" > /dev/null
|
|
test "$(PGDATABASE=upgrade_path psql -XAtc "SELECT string_agg(version::text, ',') FROM evolution.schema_migrations")" = 1
|
|
PGDATABASE=upgrade_path bash "$root/tools/migrate-postgres.sh"
|
|
test "$(PGDATABASE=upgrade_path psql -XAtc "SELECT string_agg(version::text, ',' ORDER BY version) FROM evolution.schema_migrations")" = 1,2,3,4,5
|
|
# v2 heads have no payload binding: v2->v3 fails closed and leaves history at v2.
|
|
v2_sha="$(sha256sum "$root/migrations/0002_region_fencing.sql")"
|
|
v2_sha="${v2_sha%% *}"
|
|
createdb v2_heads
|
|
PGDATABASE=v2_heads psql -X -v ON_ERROR_STOP=1 -1 -v "migration_sha=$v1_sha" -v "migration_sha_2=$v2_sha" -v runtime_role=evo_runtime_test -f "$root/migrations/0001_region_bootstrap.sql" -f "$root/migrations/0002_region_fencing.sql" > /dev/null
|
|
PGDATABASE=v2_heads psql -X -v ON_ERROR_STOP=1 -c "SELECT evolution.provision_region(1, 1, 1, gen_random_uuid(), decode(repeat('00', 32), 'hex'))" > /dev/null
|
|
if PGDATABASE=v2_heads bash "$root/tools/migrate-postgres.sh"; then
|
|
echo 'Expected v2 heads to block v3' >&2; exit 1
|
|
fi
|
|
v3_sha="$(sha256sum "$root/migrations/0003_region_checkpoints.sql")"
|
|
v3_sha="${v3_sha%% *}"
|
|
createdb v3_commits
|
|
PGDATABASE=v3_commits psql -X -v ON_ERROR_STOP=1 -1 -v "migration_sha=$v1_sha" \
|
|
-v "migration_sha_2=$v2_sha" -v "migration_sha_3=$v3_sha" -v runtime_role=evo_runtime_test \
|
|
-f "$root/migrations/0001_region_bootstrap.sql" -f "$root/migrations/0002_region_fencing.sql" \
|
|
-f "$root/migrations/0003_region_checkpoints.sql" > /dev/null
|
|
PGDATABASE=v3_commits psql -X -v ON_ERROR_STOP=1 \
|
|
-c "INSERT INTO evolution.retained_builds VALUES (decode(repeat('b1', 32), 'hex'))" \
|
|
-c "SELECT evolution.provision_region_checkpoint(decode('4145564f52434d31' || '01000000' || '01000000' || '0100000000000000' || '0100000000000000' || '0900000000000000' || repeat('11', 16) || repeat('00', 8) || repeat('00', 16) || repeat('00', 32) || repeat('00', 16) || repeat('00', 16) || repeat('00', 8) || '50c3000000000000' || '020000000200000001000000010000000100000001000000010000000100000001000000' || repeat('b1', 32) || '00000000' || '00000000' || '01000000' || '6400000000000000' || repeat('a0', 32), 'hex'))" > /dev/null
|
|
PGDATABASE=v3_commits bash "$root/tools/migrate-postgres.sh"
|
|
test "$(PGDATABASE=v3_commits psql -XAtc "SELECT count(*) || ':' || string_agg(version::text, ',' ORDER BY version) FROM evolution.schema_migrations")" = 5:1,2,3,4,5
|
|
test "$(PGDATABASE=v3_commits psql -XAtc "SELECT count(*) FROM evolution.region_commits")" = 1
|
|
test "$(PGDATABASE=v2_heads psql -XAtc "SELECT string_agg(version::text, ',' ORDER BY version) FROM evolution.schema_migrations")" = 1,2
|
|
# Inherited privileges bypass fencing, so every migrate run audits effective rights.
|
|
psql -X -v ON_ERROR_STOP=1 -c 'CREATE ROLE evo_bad_runtime NOLOGIN IN ROLE pg_write_all_data'
|
|
if (export PGDATABASE=migration_rollback EVO_PG_RUNTIME_ROLE=evo_bad_runtime; \
|
|
bash "$root/tools/migrate-postgres.sh"); then
|
|
echo 'Expected inherited-privilege runtime rejection' >&2; exit 1
|
|
fi
|
|
test "$(PGDATABASE=migration_rollback psql -XAtc "SELECT count(*) FROM pg_namespace WHERE nspname='evolution'")" = 0
|
|
expect_audit_failure() {
|
|
psql -X -v ON_ERROR_STOP=1 -c "$1"
|
|
if bash "$root/tools/migrate-postgres.sh"; then
|
|
echo "Expected runtime audit failure after: $1" >&2; exit 1
|
|
fi
|
|
psql -X -v ON_ERROR_STOP=1 -c "$2"
|
|
}
|
|
# The reviewed scenario: the login inherits pg_write_all_data and can bypass the guard.
|
|
psql -X -v ON_ERROR_STOP=1 -c 'GRANT pg_write_all_data TO evo_runtime_login'
|
|
PGUSER=evo_runtime_login psql -X -v ON_ERROR_STOP=1 \
|
|
-c 'UPDATE evolution.region_leases SET epoch = 99 WHERE false' > /dev/null
|
|
psql -X -v ON_ERROR_STOP=1 -c 'REVOKE pg_write_all_data FROM evo_runtime_login'
|
|
expect_audit_failure 'GRANT pg_write_all_data TO evo_runtime_login' \
|
|
'REVOKE pg_write_all_data FROM evo_runtime_login'
|
|
expect_audit_failure 'GRANT pg_write_all_data TO evo_runtime_test WITH INHERIT FALSE' \
|
|
'REVOKE pg_write_all_data FROM evo_runtime_test'
|
|
expect_audit_failure 'GRANT UPDATE ON evolution.region_heads TO PUBLIC' \
|
|
'REVOKE UPDATE ON evolution.region_heads FROM PUBLIC'
|
|
expect_audit_failure 'GRANT EXECUTE ON FUNCTION evolution.check_region_lease(evolution.u64, evolution.u64, uuid, evolution.u64) TO evo_runtime_test' \
|
|
'REVOKE EXECUTE ON FUNCTION evolution.check_region_lease(evolution.u64, evolution.u64, uuid, evolution.u64) FROM evo_runtime_test'
|
|
expect_audit_failure 'ALTER ROLE evo_runtime_login CREATEDB' 'ALTER ROLE evo_runtime_login NOCREATEDB'
|
|
expect_audit_failure 'GRANT EXECUTE ON FUNCTION evolution.provision_region_checkpoint(bytea) TO evo_runtime_test' 'REVOKE EXECUTE ON FUNCTION evolution.provision_region_checkpoint(bytea) FROM evo_runtime_test'
|
|
expect_audit_failure 'GRANT SELECT ON evolution.region_commits TO evo_runtime_test' 'REVOKE SELECT ON evolution.region_commits FROM evo_runtime_test'
|
|
bash "$root/tools/migrate-postgres.sh" # Restored configuration passes the audit again.
|
|
# Unknown future versions and checksum drift must not be repaired silently.
|
|
psql -X -v ON_ERROR_STOP=1 -c 'UPDATE evolution.schema_migrations SET version=6 WHERE version=5'
|
|
if bash "$root/tools/migrate-postgres.sh"; then exit 1; fi
|
|
psql -X -v ON_ERROR_STOP=1 -c "UPDATE evolution.schema_migrations SET version=5 WHERE version=6"
|
|
psql -X -v ON_ERROR_STOP=1 -c "UPDATE evolution.schema_migrations SET sha256=repeat('0',64) WHERE version=5"
|
|
if bash "$root/tools/migrate-postgres.sh"; then exit 1; fi
|
|
psql -X -v ON_ERROR_STOP=1 -c "UPDATE evolution.schema_migrations SET sha256=repeat('0',64) WHERE version=4"
|
|
if bash "$root/tools/migrate-postgres.sh"; then exit 1; fi
|
|
psql -X -v ON_ERROR_STOP=1 -c "UPDATE evolution.schema_migrations SET sha256=repeat('0',64) WHERE version=3"
|
|
if bash "$root/tools/migrate-postgres.sh"; then exit 1; fi
|
|
psql -X -v ON_ERROR_STOP=1 -c "UPDATE evolution.schema_migrations SET sha256=repeat('0',64) WHERE version=2"
|
|
if bash "$root/tools/migrate-postgres.sh"; then exit 1; fi
|
|
psql -X -v ON_ERROR_STOP=1 -c "UPDATE evolution.schema_migrations SET sha256=repeat('0',64)"
|
|
if bash "$root/tools/migrate-postgres.sh"; then exit 1; fi
|
|
echo 'postgres migrations, rollback, constraints, permissions, fencing, checkpoints and outcomes passed'
|