upleb.uk

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

summaryrefslogtreecommitdiff
path: root/docs
AgeCommit message (Collapse)Author
2026-01-07docs: purgatory tweak implementation planDanConwayDev
2026-01-07docs: purgatory update implemenation to to reflect ↵DanConwayDev
process_newly_available_git_data
2026-01-07docs: purgatory add unified process_newly_available_git_data to designDanConwayDev
2026-01-07docs: purgatory sync implemeantion planDanConwayDev
2026-01-07docs: purgatory design improve testing strategyDanConwayDev
2026-01-07docs: purgatory design improve process_satisfiable_eventsDanConwayDev
2026-01-06docs: purgatory design improvementsDanConwayDev
2026-01-06docs: purgatory git sync design with throttle queuingDanConwayDev
2026-01-06docs: purgatory git sync design simplifyDanConwayDev
2026-01-06docs: purgatory git sync designDanConwayDev
2026-01-02docs: remove purgatory implementation planDanConwayDev
2025-12-24feat(purgatory): add broken purgatory implementationDanConwayDev
2025-12-23docs: purgatory designDanConwayDev
2025-12-22docs: proactive sync hand written overview rewrite and AI update of restDanConwayDev
2025-12-19docs: sync updates to reflect changesDanConwayDev
2025-12-19docs: sync add pagination updatesDanConwayDev
2025-12-19docs: cleanupDanConwayDev
2025-12-18docs: archive sync test refactoring options documentDanConwayDev
2025-12-18sync: new connection logicDanConwayDev
2025-12-16proactive sync prep - some helper functions written but not enabledDanConwayDev
2025-12-12docs: fix sync SyncMethod in architecture docDanConwayDev
2025-12-11docs: relay-limitsDanConwayDev
2025-12-11feat: implement NIP-77 negentropy sync for historical dataDanConwayDev
Replace EOSE-based sync completion with negentropy reconciliation for: - Initial connect (fresh sync) - Daily sync (Layer 1 announcements) - Stale reconnect (>15 min) Key changes: - Add NegentropySyncResult struct with remote_only, local_only, received fields - Add supports_negentropy() using try-and-fallback approach - Add negentropy_sync_filter() using nostr-sdk client.sync() API - Modify handle_connect_or_reconnect() to use negentropy for fresh/stale sync - Modify daily_sync() to use negentropy for Layer 1 - Single-warning logging per relay when negentropy fails Quick reconnects (<15 min) unchanged - still use REQ with since filter. If negentropy unsupported, gracefully falls back to REQ+EOSE flow.
2025-12-11docs: simplify grasp-02 docDanConwayDev
2025-12-11docs: remove old grasp-02 design doc versionsDanConwayDev
2025-12-11fix docsDanConwayDev
2025-12-10docs: update sync docs post implementationDanConwayDev
2025-12-10improve sync designDanConwayDev
2025-12-09basic sync stubDanConwayDev
2025-12-08redsign sync - architecture tweaksDanConwayDev
2025-12-08redesign sync - document onlyDanConwayDev
2025-12-08proposed sync change to use self subscribe to trigger everythingDanConwayDev
2025-12-05rename sunc_bootstrap_relay_urlDanConwayDev
2025-12-04feat(sync): Phase 6 - observability and production readinessDanConwayDev
- Add SyncMetrics with full Prometheus integration - Track sync gaps via catchup events - Update Grafana dashboard with sync panels - Document all sync configuration options - Update design doc with implementation notes
2025-12-04docs: update GRASP-02 proactive sync event sync approachDanConwayDev
2025-12-04docs: add guidance to keep architecture docs updatedDanConwayDev
- Added CRITICAL warning section to AGENTS.md about treating architecture docs as living documents - Mark 'Keep Architecture Docs Updated' item as fixed in grasp-01 learnings - Mark 'Document actual architecture' technical debt item as fixed This addresses a key learning from GRASP-01 where docs described plans rather than implementation, causing confusion.
2025-12-04refactor: split Nip34WritePolicy into focused sub-policiesDanConwayDev
Split the ~900 line Nip34WritePolicy into focused sub-policies for improved testability and maintainability: - AnnouncementPolicy - Repository announcement validation - StatePolicy - State event validation + ref alignment - PrEventPolicy - PR/PR Update validation - RelatedEventPolicy - Forward/backward reference checking The main Nip34WritePolicy now delegates to these sub-policies via a shared PolicyContext that provides domain, database, and git_data_path. Also updates: - README.md: Accurate project structure reflecting actual implementation - docs/learnings: Marks this technical debt item as complete
2025-12-04add prometheus metricsDanConwayDev
2025-12-04docs: add monitoring-strategyDanConwayDev
2025-12-04docs: update based on current implementationDanConwayDev
2025-12-04docs: add llm review of implemenation vs planDanConwayDev
2025-12-04docs: planed GRASP-2 proactive sync of just eventsDanConwayDev
2025-12-03remove depricated audit mode label ci / production ~> isolated / sharedDanConwayDev
2025-12-03remove docs archiveDanConwayDev
2025-12-03improved settings cli flags > env vars > defaultsDanConwayDev
2025-11-21feat: add database backend configuration optionsDanConwayDev
Add environment variable configuration for database backend selection: - Added DatabaseBackend enum (memory, nostrdb, lmdb) in src/config.rs - Updated relay builder to use configured backend in src/nostr/builder.rs - Added NGIT_DATABASE_BACKEND to .env.example with documentation - Updated docs/reference/configuration.md with backend comparison table NostrDB and LMDB backends prepared for future implementation when nostr-relay-builder adds support. Currently defaults to in-memory database with warning logs when persistent backends are selected.
2025-11-18docs: switch focus onto grasp implementationDanConwayDev
2025-11-05preparing to build grasp-audit against git-relayDanConwayDev
2025-11-04docs: archive test migration session notesDanConwayDev
Archive valuable session documentation from test migration project: - Phase 1: NIP-01 compliance test migration - Phase 2: NIP-34 announcement test migration - Phase 3: Test compliance documentation - Final summary: Complete project overview Session cleanup complete - work/ directory now clean (only README.md)
2025-11-04test: migrate to TestRelay fixture pattern and add compliance docsDanConwayDev
- Remove unnecessary 'nix' dev dependency (Unix syscalls crate, not needed) - Migrate announcement tests to new TestRelay fixture pattern - Delete legacy test files (announcement_tests.rs, test_relay.sh) - Add comprehensive test documentation (docs/how-to/test-compliance.md) - Update README.md with new test commands - All 18 integration tests passing (NIP-01 + NIP-34) Benefits: - Automatic relay lifecycle management - No manual setup required - Pure Rust integration tests - Better developer experience - CI/CD ready
2025-11-04docs: use Diátaxis structureDanConwayDev
2025-11-04docs: clean up .txt files and add file format guidelinesDanConwayDev
- Archive 5 .txt files to docs/archive/ - AUDIT_FIX_SUMMARY.txt - PROJECT_STATUS_VISUAL.txt - SESSION_SUMMARY.txt - TEST_VISUAL_SUMMARY.txt - CLEANUP_VISUAL_SUMMARY.txt - Update AGENTS.md with file format guidelines: - When to use .txt (ASCII art only) - When to use .md (all documentation) - .txt lifecycle: create → use → archive immediately - Added to cleanup triggers and checklists Root directory now completely clean: - 4 .md files (README, AGENTS, CURRENT_STATUS, CLEANUP_COMPLETE) - 0 .txt files (all archived) Archive contains: - 33 .md files (historical documentation) - 5 .txt files (visual summaries)
2025-11-04docs: archive cleanup summaryDanConwayDev
2025-11-04docs: major cleanup and reorganizationDanConwayDev
- 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
2025-11-03docs: one-prompt architecture planDanConwayDev
ok 2 prompts, the second one was about the test strategy so we could reuse it. I was thinking of a tool like blossom audit. but i didnt mention it specifically.