npub1tkq8unhsd5jqx6ueex5lcpsgknrpquxuk44ftpjlpm3ulaake7xs76txrw/ngit-grasp-mirror/docs/learnings, branch masterUnnamed repository; edit this file 'description' to name the repository.
https://upleb.uk/npub1tkq8unhsd5jqx6ueex5lcpsgknrpquxuk44ftpjlpm3ulaake7xs76txrw/ngit-grasp-mirror/atom?h=master2026-02-25T15:07:40+00:00drop nostr-db backend support, keep only lmdb and memory2026-02-25T15:07:40+00:00DanConwayDevDanConwayDev@protonmail.com2026-02-25T15:07:40+00:00urn:sha1:5ad9d9093fcbe7037e5474a9d8fa20a0b64fb79aChange default port from 8080 to 7334 (NGIT on phone keypad)2026-01-12T22:51:43+00:00DanConwayDevDanConwayDev@protonmail.com2026-01-12T22:51:43+00:00urn:sha1:51751d59f30a0c0f396afd1873ece9f4f77b44de
- Update default bind address in src/config.rs to 127.0.0.1:7334
- Update all four critical config sources per AGENTS.md:
- src/config.rs (code default and tests)
- .env.example (development template)
- docs/reference/configuration.md (user documentation)
- nix/module.nix (NixOS deployment)
- Update all documentation examples and references:
- README.md (with note about phone keypad mnemonic)
- docs/how-to/*.md (deploy, prometheus-setup, test-compliance)
- docs/explanation/*.md (architecture, comparison)
- docs/learnings/grasp-audit.md
Port 7334 spells NGIT on a phone keypad, making it memorable and
project-specific.
All tests pass (336 lib tests + 51 integration tests).
feat: add uploadpack.allowFilter support for GRASP-01 compliance2026-01-12T14:05:51+00:00DanConwayDevDanConwayDev@protonmail.com2026-01-12T14:05:51+00:00urn:sha1:817ce37a5ee8d6279a44cf8cce3cc6a1e4bab576
Add mandatory uploadpack.allowFilter capability to support partial clones
and fetches as required by GRASP-01 specification. This enables efficient
git operations for bandwidth-constrained clients (e.g., browser-based git
clients like git-natural-api).
Changes:
- Add uploadpack.allowFilter=true to git subprocess configuration
- Update SmartGitServer test helper with filter support
- Add integration tests for filter capability advertisement and functionality
- Update documentation to reflect filter as required capability
Tests verify:
- Filter capability is advertised in info/refs
- Filtered clones with blob:none work correctly
- Filtered fetches with tree:0 work correctly
docs: add guidance to keep architecture docs updated2025-12-04T15:45:48+00:00DanConwayDevDanConwayDev@protonmail.com2025-12-04T15:45:48+00:00urn:sha1:8c129a4aeab3288f8193ccb820adf00860c50d74
- 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.
refactor: split Nip34WritePolicy into focused sub-policies2025-12-04T15:42:00+00:00DanConwayDevDanConwayDev@protonmail.com2025-12-04T15:42:00+00:00urn:sha1:819866330c7e2f535a155d1d7efaf2e12dc15dc2
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
docs: update based on current implementation2025-12-04T13:02:59+00:00DanConwayDevDanConwayDev@protonmail.com2025-12-04T12:34:20+00:00urn:sha1:d9bc5ed7fddef3a26de8e69a7124e1dbe5b8602fdocs: add llm review of implemenation vs plan2025-12-04T12:18:11+00:00DanConwayDevDanConwayDev@protonmail.com2025-12-04T12:18:11+00:00urn:sha1:40831a9025d05fa354b7d8386eeebd902092ea86remove depricated audit mode label ci / production ~> isolated / shared2025-12-03T11:38:07+00:00DanConwayDevDanConwayDev@protonmail.com2025-12-03T11:38:07+00:00urn:sha1:e30dfd5e5abb96cdc89b80f1d085466e55c347e0docs: use Diátaxis structure2025-11-04T10:25:53+00:00DanConwayDevDanConwayDev@protonmail.com2025-11-04T10:25:53+00:00urn:sha1:52bad9954cdddf55ab749fd0c6387edbc766632fdocs: major cleanup and reorganization2025-11-04T09:31:57+00:00DanConwayDevDanConwayDev@protonmail.com2025-11-04T09:31:57+00:00urn:sha1:22557f15d6a7b77f72d4597fc05aa06346495a33
- 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