upleb.uk

Public git repos — served from a NIP-34 GRASP relay at git.upleb.uk

summaryrefslogtreecommitdiff
path: root/grasp-audit/README.md
AgeCommit message (Collapse)Author
2026-02-25update README to document probe subcommand with checks, flags, and timeout ↵DanConwayDev
behaviour
2026-02-24update grasp-audit README port examples and remove stale TAG_MIGRATION docDanConwayDev
2026-02-13fix: add trailing newlines to deterministic commit contentDanConwayDev
The CommitVariant::file_content() methods were returning strings without trailing newlines, but the expected hash constants were calculated with trailing newlines. This caused hash mismatches in tests. Updated all hash constants to match the actual commit hashes produced with trailing newlines in the file content.
2026-02-12refactor(grasp-audit): split ValidRepo into Sent/Served, add tolerant purgatoryDanConwayDev
- Rename ValidRepo to ValidRepoSent (announcement sent, may be in purgatory) - Add ValidRepoServed (announcement queryable after git data pushed) - Add send_event_and_note_purgatory() for tolerant purgatory detection - Update fixtures to use tolerant method instead of strict assertion - Update event_acceptance_policy tests to use ValidRepoServed This enables tests to pass regardless of purgatory implementation status while still having explicit purgatory tests that verify the behavior.
2025-12-04docs: update grasp-audit docsDanConwayDev
2025-12-02refactor: rename AuditMode variants and change CLI default to sharedDanConwayDev
Breaking change: Renamed AuditMode enum variants for clarity: - AuditMode::CI -> AuditMode::Isolated (fresh fixtures per test) - AuditMode::Production -> AuditMode::Shared (reuse fixtures across tests) Config constructors renamed (with deprecated aliases): - AuditConfig::ci() -> AuditConfig::isolated() - AuditConfig::production() -> AuditConfig::shared() CLI default changed from 'ci' to 'shared' mode, which enables fixture caching across tests. This fixes the issue where fixtures were being re-created for every test in CLI mode. Fixture caching behavior: - Shared mode (CLI default): Uses client's cache, fixtures reused - Isolated mode (for cargo test): Local cache per TestContext
2025-12-01better fixtures: update readmeDanConwayDev
2025-12-01better fixtures: clean upDanConwayDev
2025-11-28grasp-audit improve cli output eg. add colors and condenseDanConwayDev
2025-11-27docs: add test design pattern using fixtures to readmeDanConwayDev
2025-11-05tag test events with audit-grasp-test-eventDanConwayDev
2025-11-05Fix cargo test invocation in test-ngit-relay.sh and documentationDanConwayDev
- Changed from 'cargo test --lib test_grasp01_nostr_relay_against_relay' to 'cargo test --lib -- --ignored --nocapture' - This correctly runs ALL library tests marked with #[ignore], not just GRASP-01 - Updated AGENTS.md and grasp-audit/README.md with correct commands - Added examples showing both 'run all ignored tests' and 'run specific test' patterns
2025-11-05feat(grasp-audit): standardize testing with test-ngit-relay.shDanConwayDev
Establish test-ngit-relay.sh as the canonical testing approach for GRASP-01 compliance tests, eliminating manual relay setup and ensuring consistent, reproducible test environments. **Enhanced test-ngit-relay.sh:** - Add command-line argument parsing (--mode, --spec, --help) - Support both audit and test execution modes - Comprehensive inline documentation - Backward compatible (default behavior unchanged) **Documentation updates:** - AGENTS.md: Add "Standard Testing Process" section - AGENTS.md: Update Quick Reference to prioritize test-ngit-relay.sh - AGENTS.md: Add Critical Gotcha #7 about using the test script - grasp-audit/README.md: Add prominent Quick Start section - grasp-audit/README.md: Reorganize testing documentation **Benefits:** - Automatic relay lifecycle management (start, cleanup) - Random port selection prevents conflicts - Isolated temporary directories per run - Guaranteed cleanup on success or failure - Consistent test environment across all developers All changes tested and verified working.
2025-11-05docs: fixed desired grasp-audit behaviour in README.mdDanConwayDev
2025-11-05fix: hardcoded portDanConwayDev
2025-11-05docs: simplify README testing section, point to test scriptDanConwayDev
- Remove duplicated setup/cleanup instructions from README - Point to test-ngit-relay.sh for full details - Add simple one-liner for manual testing - Fix container name bug in test script (was using bare $)
2025-11-05test: improve test script with unique names and random portsDanConwayDev
- Remove python3 dependency for port selection - Use RANDOM for port selection in range 20000-30000 - Use unique container names based on PID: grasp-audit-run-294183 - Use unique temp directories: grasp-audit-run-XXXXXXXXXX - Ensures parallel test runs don't conflict
2025-11-05test: add ngit-relay integration testing instructionsDanConwayDev
- Add RELAY_URL environment variable support to tests - Document expected behavior when testing against ngit-relay - Add test-ngit-relay.sh script for automated testing - Clarify that ngit-relay only accepts Git events (NIP-34) - Note that 4/6 NIP-01 smoke tests passing is expected - Key validation tests (invalid signature/ID) pass correctly - Add instructions for testing against general-purpose relays The validation tests passing confirms ngit-relay implements NIP-01 correctly, even though it has restrictive acceptance policies.
2025-11-04moved to flakesDanConwayDev
2025-11-04created POC grasp-auditorDanConwayDev