From 076826dc38245cca9e5a989c53b3c4b533d54715 Mon Sep 17 00:00:00 2001
From: Gale W <mail@galewilliams.com>
Date: Tue, 28 Apr 2026 14:50:13 -0400
Subject: [PATCH 1/2] release: refresh patch release notes template

---
 scripts/repo-maintenance/version-bump.sh | 15 +++++++--------
 1 file changed, 7 insertions(+), 8 deletions(-)

diff --git a/scripts/repo-maintenance/version-bump.sh b/scripts/repo-maintenance/version-bump.sh
index 7704371..dc28e2e 100755
--- a/scripts/repo-maintenance/version-bump.sh
+++ b/scripts/repo-maintenance/version-bump.sh
@@ -43,20 +43,19 @@ cat >"$release_notes_path" <<EOF
 
 ## What Changed
 
-- added the first conventional-search foundation through \`FetchCore\`, \`FetchKit\`, and the new \`FetchKitLibrary\` facade
-- shipped the first Core Data-backed durable corpus store, persisted pending index-sync queue, and thin macOS Search Kit backend
-- added the polished persistent-library construction surface plus the local Search Kit helper lane for opt-in macOS verification
-- documented the \`SwiftlyFetch\` / \`FetchKit\` / \`RAGKit\` package-family split more clearly in public and maintainer docs
-- stabilized hosted CI by moving the Core Data-backed verification path to XCTest and aligning the durable store with a private-queue Core Data context
+- refined conventional-search ranking so title hits get a modest boost, Search Kit scores normalize per field, and cross-field matches accumulate more intentionally
+- replaced the old single-term snippet behavior with shared query-aware snippets that can highlight multiple query terms and show visible truncation markers when context is cropped
+- added stronger default-path and opt-in Search Kit coverage for ranking preference, phrase behavior, and snippet presentation
+- documented the new conventional-search refinement state in the README, roadmap, and maintainer notes
 
 ## Breaking Changes
 
-- None. This is a backward-compatible patch release on top of \`v0.1.0\`.
+- None. This is a backward-compatible patch release on top of \`v0.1.1\`.
 
 ## Migration Or Upgrade Notes
 
-- \`RAGCore\` and \`RAGKit\` continue to provide the shipped semantic retrieval surface from \`v0.1.0\`.
-- \`FetchCore\` and \`FetchKit\` now expose the first conventional-search foundation, including \`FetchKitLibrary\` for in-memory and macOS-persistent library construction.
+- \`RAGCore\` and \`RAGKit\` continue to provide the shipped semantic retrieval surface from \`v0.1.1\`.
+- \`FetchCore\` and \`FetchKit\` still expose the same conventional-search foundation, but \`FetchKitLibrary\` search results now rank title and phrase matches more intentionally and return richer snippets by default.
 - Real Natural Language integration coverage remains opt-in and requires \`RUN_NL_INTEGRATION_TESTS=1\`.
 - The Search Kit verification lane remains local-only for now through \`scripts/repo-maintenance/run-searchkit-tests.sh\`.
 

From 6ff560f2db028b7b48eb177ff880f3387ffeb8bb Mon Sep 17 00:00:00 2001
From: Gale W <mail@galewilliams.com>
Date: Tue, 28 Apr 2026 14:50:27 -0400
Subject: [PATCH 2/2] release: bump versions for v0.1.2

---
 README.md               |  2 +-
 docs/releases/v0.1.2.md | 25 +++++++++++++++++++++++++
 2 files changed, 26 insertions(+), 1 deletion(-)
 create mode 100644 docs/releases/v0.1.2.md

diff --git a/README.md b/README.md
index 5da3c9c..07b02e8 100644
--- a/README.md
+++ b/README.md
@@ -15,7 +15,7 @@ An Apple-first Swift Package family for local document search and semantic retri
 
 ### Status
 
-`v0.1.1` is the current tagged package release and is stable enough to try locally.
+`v0.1.2` is the current tagged package release and is stable enough to try locally.
 
 ### What This Project Is
 
diff --git a/docs/releases/v0.1.2.md b/docs/releases/v0.1.2.md
new file mode 100644
index 0000000..f2c57bd
--- /dev/null
+++ b/docs/releases/v0.1.2.md
@@ -0,0 +1,25 @@
+# SwiftlyFetch v0.1.2
+
+## What Changed
+
+- refined conventional-search ranking so title hits get a modest boost, Search Kit scores normalize per field, and cross-field matches accumulate more intentionally
+- replaced the old single-term snippet behavior with shared query-aware snippets that can highlight multiple query terms and show visible truncation markers when context is cropped
+- added stronger default-path and opt-in Search Kit coverage for ranking preference, phrase behavior, and snippet presentation
+- documented the new conventional-search refinement state in the README, roadmap, and maintainer notes
+
+## Breaking Changes
+
+- None. This is a backward-compatible patch release on top of `v0.1.1`.
+
+## Migration Or Upgrade Notes
+
+- `RAGCore` and `RAGKit` continue to provide the shipped semantic retrieval surface from `v0.1.1`.
+- `FetchCore` and `FetchKit` still expose the same conventional-search foundation, but `FetchKitLibrary` search results now rank title and phrase matches more intentionally and return richer snippets by default.
+- Real Natural Language integration coverage remains opt-in and requires `RUN_NL_INTEGRATION_TESTS=1`.
+- The Search Kit verification lane remains local-only for now through `scripts/repo-maintenance/run-searchkit-tests.sh`.
+
+## Verification Performed
+
+- `swift test`
+- `scripts/repo-maintenance/validate-all.sh`
+- `scripts/repo-maintenance/run-searchkit-tests.sh`