feat: announcement purgatory

Extends purgatory to hold repository announcements until git data arrives,
preventing empty repositories from being served to clients.

When an announcement is received, a bare repo is created immediately and the
announcement is held in purgatory. It is only promoted and served once a git
push confirms real content exists. If no push arrives before expiry, the bare
repo is deleted and the announcement is silently discarded.

Key behaviours:
- Soft expiry: announcements are hidden from clients but kept alive while git
  pushes are in progress, reviving on successful push
- Expiry is extended when a matching state event or git push is observed
- NIP-09 deletion events remove announcements from purgatory
- Purgatory state (announcements, state events, PR events, expired set) is
  persisted to disk on graceful shutdown and restored on startup, with elapsed
  downtime subtracted from expiry deadlines
- Purgatory announcements drive StateOnly sync in the sync system so state
  events are fetched from listed relays before promotion
- SyncLevel added to RepoSyncIndex to distinguish purgatory repos (StateOnly)
  from promoted repos (Full L2+L3 sync)

1 files changed, 89 insertions, 0 deletions

diff --git a/tests/purgatory.rs b/tests/purgatory.rs
new file mode 100644
index 0000000..73f85ca
--- /dev/null
+++ b/tests/purgatory.rs
@@ -0,0 +1,89 @@
+//! Purgatory Integration Tests
+//!
+//! Tests ngit-grasp relay's implementation of GRASP-01 purgatory behavior.
+//! Uses grasp-audit library to avoid code duplication.
+//!
+//! # Test Strategy
+//!
+//! - Each test runs in complete isolation with its own fresh relay instance
+//! - Uses macro to eliminate boilerplate while maintaining test isolation
+//! - Calls individual test methods from grasp-audit for minimal duplication
+//! - Automatic cleanup via TestRelay fixture (removes container and temp dirs)
+//!
+//! # Running Tests
+//!
+//! ```bash
+//! # Run all purgatory tests
+//! cargo test --test purgatory
+//!
+//! # Run specific test
+//! cargo test --test purgatory test_state_event_not_served_before_git_data
+//!
+//! # With output
+//! cargo test --test purgatory -- --nocapture
+//! ```
+
+mod common;
+
+use common::TestRelay;
+use grasp_audit::specs::grasp01::PurgatoryTests;
+use grasp_audit::{AuditClient, AuditConfig};
+
+/// Macro to generate isolated integration tests for purgatory
+///
+/// Each test runs with its own fresh relay instance to ensure complete isolation.
+/// This eliminates issues with leftover repositories and ensures clean state.
+macro_rules! isolated_purgatory_test {
+    ($test_name:ident) => {
+        #[tokio::test]
+        async fn $test_name() {
+            let relay = TestRelay::start().await;
+            let config = AuditConfig::isolated();
+            let client = AuditClient::new(relay.url(), config)
+                .await
+                .expect("Failed to create audit client");
+
+            let result = PurgatoryTests::$test_name(&client).await;
+
+            relay.stop().await;
+
+            assert!(
+                result.passed,
+                "{} failed: {}",
+                stringify!($test_name),
+                result.error.as_deref().unwrap_or("unknown error")
+            );
+        }
+    };
+}
+
+// ============================================================
+// Announcement Purgatory Tests
+// ============================================================
+
+isolated_purgatory_test!(test_announcement_not_served_before_git_data);
+isolated_purgatory_test!(test_announcement_served_after_git_push);
+isolated_purgatory_test!(test_bare_repo_exists_for_purgatory_announcement);
+isolated_purgatory_test!(test_state_event_accepted_for_purgatory_announcement);
+
+// ============================================================
+// Deletion Event Tests (NIP-09)
+// ============================================================
+
+isolated_purgatory_test!(test_deletion_by_event_id_removes_purgatory_state_event);
+isolated_purgatory_test!(test_deletion_by_coordinate_removes_purgatory_state_event);
+
+// ============================================================
+// State Event Purgatory Tests (already implemented)
+// ============================================================
+
+isolated_purgatory_test!(test_state_event_not_served_before_git_data);
+isolated_purgatory_test!(test_state_event_served_after_git_push);
+
+// ============================================================
+// PR Purgatory Tests
+// ============================================================
+
+isolated_purgatory_test!(test_pr_event_accepted_into_purgatory_and_isnt_served);
+isolated_purgatory_test!(test_pr_event_in_purgatory_git_push_accepted);
+isolated_purgatory_test!(test_pr_event_served_after_git_push);