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
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