docs: major cleanup and reorganization

- Archive 30 completed session documents to docs/archive/
- Extract learnings to docs/learnings/ (nix-flakes, nostr-sdk, grasp-audit)
- Create CURRENT_STATUS.md as single source of truth
- Create AGENTS.md with documentation guidelines
- Create docs/archive/README.md for archive organization
- Clean root directory: 32 files → 4 files

Root directory now contains only:
- README.md (project overview)
- AGENTS.md (documentation guidelines)
- CURRENT_STATUS.md (current state)
- CLEANUP_SUMMARY.md (cleanup report)

All historical documents preserved in docs/archive/ with proper dating.
All reusable knowledge extracted to docs/learnings/.

Benefits:
- Easy to find current information
- Clear document lifecycle
- No more documentation sprawl
- Learnings are accessible and reusable
- Better onboarding for new developers/agents

File counts:
- Root: 4 (was 32)
- Permanent docs: 7
- Learnings: 3 (new)
- Archive: 32 (new)
- Total: 49 well-organized docs

1 files changed, 0 insertions, 356 deletions

diff --git a/FILES_CREATED.md b/FILES_CREATED.md
deleted file mode 100644
index 2bdb0f4..0000000
--- a/FILES_CREATED.md
+++ /dev/null
@@ -1,356 +0,0 @@
-# Files Created - GRASP Audit Implementation
-
-**Session Date:** November 4, 2025  
-**Task:** Implement grasp-audit crate with smoke tests
-
----
-
-## Source Code Files (9 files, 1,079 lines)
-
-### Core Library
-
-1. **grasp-audit/src/lib.rs** (35 lines)
-   - Public API exports
-   - Module declarations
-   - Re-exports for convenience
-
-2. **grasp-audit/src/audit.rs** (178 lines)
-   - `AuditConfig` struct and implementations
-   - `AuditMode` enum (CI/Production)
-   - `AuditEventBuilder` for tagged events
-   - Audit tag generation
-   - Unit tests (4 tests)
-
-3. **grasp-audit/src/client.rs** (137 lines)
-   - `AuditClient` struct
-   - Connection management
-   - Event sending with automatic tagging
-   - Query filtering for isolation
-   - Unit tests (2 tests)
-
-4. **grasp-audit/src/isolation.rs** (61 lines)
-   - Test ID generation utilities
-   - Run ID generators (CI/Production)
-   - Atomic counter for uniqueness
-   - Unit tests (3 tests)
-
-5. **grasp-audit/src/result.rs** (166 lines)
-   - `TestResult` struct
-   - `AuditResult` collection
-   - Pretty-printing and reporting
-   - Statistics calculation
-   - Unit tests (3 tests)
-
-### Test Specifications
-
-6. **grasp-audit/src/specs/mod.rs** (4 lines)
-   - Module exports for test specs
-
-7. **grasp-audit/src/specs/nip01_smoke.rs** (365 lines)
-   - `Nip01SmokeTests` implementation
-   - 6 smoke tests:
-     * websocket_connection
-     * send_receive_event
-     * create_subscription
-     * close_subscription
-     * reject_invalid_signature
-     * reject_invalid_event_id
-   - Integration test (1 test, ignored by default)
-
-### Binary/Examples
-
-8. **grasp-audit/src/bin/grasp-audit.rs** (94 lines)
-   - CLI tool implementation
-   - `audit` command with options
-   - Pretty output formatting
-   - Exit code handling
-
-9. **grasp-audit/examples/simple_audit.rs** (39 lines)
-   - Example usage of the library
-   - Connection and test execution
-   - Result reporting
-
----
-
-## Configuration Files (3 files)
-
-1. **grasp-audit/Cargo.toml**
-   - Package metadata
-   - Dependencies (12 crates)
-   - Binary configuration
-   - Dev dependencies
-
-2. **grasp-audit/Cargo.lock**
-   - Locked dependency versions
-   - Generated by cargo
-
-3. **grasp-audit/flake.nix**
-   - NixOS development environment (flake-based)
-   - Build tools (rust, pkg-config, openssl)
-   - Shell hook with helpful messages
-
----
-
-## Documentation Files (7 files)
-
-### In grasp-audit/
-
-1. **grasp-audit/README.md** (~200 lines)
-   - Main documentation
-   - Features overview
-   - Quick start guide
-   - API documentation
-   - Usage examples
-   - Architecture overview
-
-2. **grasp-audit/QUICK_START.md** (~180 lines)
-   - Prerequisites
-   - Setup instructions (NixOS and other systems)
-   - Running tests
-   - Using as library
-   - Troubleshooting
-   - Examples
-
-### In Project Root
-
-3. **GRASP_AUDIT_PLAN.md** (~600 lines)
-   - Original implementation plan
-   - Audit event strategy
-   - Test structure design
-   - Parallel development plan
-   - Created in previous session
-
-4. **SMOKE_TEST_REPORT.md** (~600 lines)
-   - Detailed implementation report
-   - Design decisions explained
-   - Code quality metrics
-   - Testing plan
-   - Build instructions
-
-5. **GRASP_AUDIT_IMPLEMENTATION_SUMMARY.md** (~400 lines)
-   - High-level summary
-   - What was built
-   - Key decisions
-   - Usage examples
-   - Next steps
-
-6. **FINAL_AUDIT_REPORT.md** (~800 lines)
-   - Complete implementation report
-   - Statistics and metrics
-   - Test coverage details
-   - Comparison with plan
-   - Success criteria checklist
-
-7. **NEXT_SESSION_QUICKSTART.md** (~200 lines)
-   - Quick reference for next session
-   - Commands cheat sheet
-   - Expected results
-   - File locations
-   - Next steps
-
-8. **IMPLEMENTATION_COMPLETE.md** (~150 lines)
-   - Summary announcement
-   - Quick start (20 minutes)
-   - Files created
-   - Next steps
-   - Handoff information
-
-9. **FILES_CREATED.md** (this file)
-   - Complete list of all files created
-   - Descriptions and line counts
-
----
-
-## File Statistics
-
-### By Type
-
-| Type | Files | Lines |
-|------|-------|-------|
-| Source Code (.rs) | 9 | 1,079 |
-| Documentation (.md) | 9 | ~3,130 |
-| Configuration | 3 | ~100 |
-| **Total** | **21** | **~4,309** |
-
-### By Category
-
-| Category | Files | Lines |
-|----------|-------|-------|
-| Core Library | 5 | 577 |
-| Test Specs | 2 | 369 |
-| Binary/Examples | 2 | 133 |
-| Configuration | 3 | ~100 |
-| Documentation | 9 | ~3,130 |
-| **Total** | **21** | **~4,309** |
-
----
-
-## Directory Structure
-
-```
-grasp-audit/
-├── Cargo.toml
-├── Cargo.lock
-├── README.md
-├── QUICK_START.md
-├── shell.nix
-├── src/
-│   ├── lib.rs
-│   ├── audit.rs
-│   ├── client.rs
-│   ├── isolation.rs
-│   ├── result.rs
-│   ├── specs/
-│   │   ├── mod.rs
-│   │   └── nip01_smoke.rs
-│   └── bin/
-│       └── grasp-audit.rs
-└── examples/
-    └── simple_audit.rs
-
-Project Root:
-├── GRASP_AUDIT_PLAN.md
-├── SMOKE_TEST_REPORT.md
-├── GRASP_AUDIT_IMPLEMENTATION_SUMMARY.md
-├── FINAL_AUDIT_REPORT.md
-├── NEXT_SESSION_QUICKSTART.md
-├── IMPLEMENTATION_COMPLETE.md
-└── FILES_CREATED.md
-```
-
----
-
-## Test Files
-
-### Unit Tests (13 tests)
-
-Embedded in source files:
-- `audit.rs`: 4 tests
-- `client.rs`: 2 tests
-- `isolation.rs`: 3 tests
-- `result.rs`: 3 tests
-- `nip01_smoke.rs`: 1 test
-
-### Integration Tests (6 tests)
-
-In `nip01_smoke.rs`:
-1. websocket_connection
-2. send_receive_event
-3. create_subscription
-4. close_subscription
-5. reject_invalid_signature
-6. reject_invalid_event_id
-
----
-
-## Dependencies (12 crates)
-
-From `Cargo.toml`:
-
-1. nostr-sdk = "0.35"
-2. tokio = "1" (with features)
-3. futures = "0.3"
-4. serde = "1" (with derive)
-5. serde_json = "1"
-6. anyhow = "1"
-7. thiserror = "1"
-8. clap = "4" (with derive)
-9. uuid = "1" (with v4)
-10. chrono = "0.4"
-11. tracing = "0.1"
-12. tracing-subscriber = "0.3"
-
-Dev dependency:
-- tokio-test = "0.4"
-
----
-
-## Key Files by Purpose
-
-### For Building
-- `grasp-audit/flake.nix` - Development environment
-- `grasp-audit/Cargo.toml` - Dependencies
-
-### For Understanding
-- `NEXT_SESSION_QUICKSTART.md` - Start here!
-- `grasp-audit/README.md` - API docs
-- `FINAL_AUDIT_REPORT.md` - Complete details
-
-### For Testing
-- `grasp-audit/src/specs/nip01_smoke.rs` - Test implementations
-- `grasp-audit/examples/simple_audit.rs` - Example usage
-
-### For Development
-- `grasp-audit/src/client.rs` - Main API
-- `grasp-audit/src/audit.rs` - Configuration
-- `GRASP_AUDIT_PLAN.md` - Original plan
-
----
-
-## What Each File Does
-
-### Core Functionality
-
-**lib.rs**: Entry point, exports public API  
-**audit.rs**: Manages audit configuration and event tagging  
-**client.rs**: Provides AuditClient for connecting and testing  
-**isolation.rs**: Generates unique IDs for test isolation  
-**result.rs**: Collects and reports test results  
-
-### Tests
-
-**nip01_smoke.rs**: Implements 6 basic relay smoke tests  
-**simple_audit.rs**: Shows how to use the library  
-
-### Tools
-
-**grasp-audit.rs**: CLI tool for running audits from command line  
-
-### Documentation
-
-**README.md**: Main documentation with API reference  
-**QUICK_START.md**: Setup and running guide  
-**SMOKE_TEST_REPORT.md**: Implementation details  
-**FINAL_AUDIT_REPORT.md**: Complete report with statistics  
-**NEXT_SESSION_QUICKSTART.md**: Quick reference for next time  
-
----
-
-## Files to Read First
-
-For next session, read in this order:
-
-1. **NEXT_SESSION_QUICKSTART.md** (5 min)
-   - Quick commands to get started
-
-2. **grasp-audit/QUICK_START.md** (10 min)
-   - Detailed setup instructions
-
-3. **grasp-audit/README.md** (15 min)
-   - Understand the API
-
-4. **grasp-audit/src/specs/nip01_smoke.rs** (20 min)
-   - See how tests are structured
-
-5. **SMOKE_TEST_REPORT.md** (30 min)
-   - Deep dive into implementation
-
----
-
-## Summary
-
-**Total Files Created:** 21 files  
-**Total Lines of Code:** ~4,309 lines  
-**Source Code:** 1,079 lines of Rust  
-**Documentation:** ~3,130 lines of markdown  
-**Time to Create:** ~2-3 hours  
-**Time to Test:** ~20 minutes (pending)  
-
-All files are ready for use. The implementation is complete and waiting for:
-1. Build environment setup (nix-shell)
-2. Initial build (cargo build)
-3. Test execution (cargo test)
-
----
-
-*Files created during GRASP Audit implementation session - November 4, 2025*