From 890cf4649fe9b66ecd457acfd1be61d4b8c8d3d0 Mon Sep 17 00:00:00 2001
From: DanConwayDev <DanConwayDev@protonmail.com>
Date: Mon, 20 Oct 2025 13:51:07 +0100
Subject: docs: add CHANGELOG.md

and maintain this going fowards
---
 CHANGELOG.md | 70 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 70 insertions(+)
 create mode 100644 CHANGELOG.md

diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..fa1655d
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,70 @@
+# Changelog
+
+All notable changes to ngit will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [2.0.0] - Pull Request support
+
+### Breaking Changes
+
+- **SSH Key Authentication in nostr:// URLs**: The user field in nostr git URLs (e.g., `nym1@ssh/npub123/identifier`) is now treated as an SSH key file location rather than an SSH user. SSH key can be specified as a file within `~/.ssh` (e.g., `~/.ssh/nym1`) or as a full/relative path. Most git servers expect the SSH user to be 'git', so specifying a different SSH key is the idiomatic way to use different credentials.
+
+### Added
+
+- **Pull Requests Support**: Introduced complete PR functionality for large contributions that would be too big for relays as patches:
+
+  - Generate PR events for oversized patches automatically
+  - Support PR updates and PR as patch revision
+  - List open/draft proposals on repo relays/servers as `pr/*` branches and all proposals as `refs/pr/*` and `refs/pr/pr-by-id/head`
+  - Push PRs to custom clone URLs with auto-fork creation fallback
+  - Add `--force-pr` and `--force-patch` flags for manual control
+  - Full NIP-34 compliance with `merge-base` tags
+
+- **NIP-22 Status Events Support**: Read and process NIP-22 style status events for proposals and PRs
+
+- **ngit sync command**: New command to synchronize git servers with nostr state
+
+  - Optional `--force` flag for forced synchronization eg deleting refs on non-GRASP servers
+  - `--ref-name` parameter to limit sync to a single reference
+
+- **ngit init improvements** (simple model for non-grasp servers):
+
+  - Use user's grasp list for defaults instead of hardcoded options
+  - List and allow selection/deselection of non-grasp servers
+  - Check and fetch origin refs when missing locally
+  - Publish state event and sync when existing origin matches tip
+
+- Allow specifying non-default SSH key in `nostr://` address
+
+### Fixed
+
+- **Git server timeouts**: More robust timeout enforcement in both ngit binary and remote helper
+- **Annotated and lightweight tags**: Proper handling and pushing of all tag types
+- **nostr:// URLs with NIP-05**:
+  - Fixed URLs with NIP-05 addresses without local part
+  - Allow NIP-05 domain without `_@` prefix
+- **Sync and fetch improvements**:
+  - Don't fetch tags already available locally
+  - Fetch refs missing locally before sync, fail gracefully
+  - Include all valid nostr state (was incorrectly filtering)
+- **Repository state**: Only use state and announcements from authorized maintainers
+- **Status events**: Only use status events from author and maintainers
+- **Grasp server detection**: Fix to ensure no SSH fallback when not needed
+- **NIP compliance updates**:
+  - Fix `t` tag: `revision-root` → `root-revision` (NIP-34)
+  - Fix mention marker → `q` tag (NIP-10 update)
+- **Error handling**: Capture more errors when updating refs
+- Suppress warnings for poorly formatted proposals (only show to maintainers/author)
+
+### Changed
+
+- Updated to latest rust-nostr v0.43
+- Updated gitworkshop.dev URL format (now uses nevent)
+- Removed blossom from grasp server detection (removed from grasp spec)
+- Print event description before publishing for clearer terminal UI
+
+## [1.7.4] - Previous Release
-- 
cgit v1.2.3