Add v1.2.1 release documentation and GitHub API tools

Added comprehensive release documentation and GitHub API integration tools
for v1.2.1 threshold fix release:

- GitHub release instructions for manual release creation
- Release notes template for v1.2.1 threshold fixes
- GitHub API payload for automated release creation
- Complete documentation for threshold fix implementation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: xplusplusai

GITHUB_RELEASE_INSTRUCTIONS_v1.2.1.md

@@ -0,0 +1,85 @@
+# GitHub Release Instructions for v1.2.1
+
+## ✅ Prerequisites Completed
+- ✅ Committed all v1.2.1 changes to main branch
+- ✅ Created v1.2.1 tag locally
+- ✅ Release notes prepared in `release-notes-v1.2.1.txt`
+
+## 🚀 Create GitHub Release
+
+### Step 1: Navigate to Releases
+Go to: **https://github.com/xplusplusai/fo-semantic-mcp/releases/new**
+
+### Step 2: Release Configuration
+Fill in the following details:
+
+- **Tag**: `v1.2.1` (create new tag if not yet pushed)
+- **Release title**: `v1.2.1 - Critical Threshold Fix`
+- **Target branch**: `main`
+- **Release type**: ✅ Latest release (checked)
+- **Pre-release**: ❌ Unchecked
+
+### Step 3: Release Description
+Copy the contents from `release-notes-v1.2.1.txt` into the description field.
+
+### Step 4: Upload Release Assets
+
+**Required Files** (upload these individually):
+- `package.json`
+- `package-lock.json`
+- `README.md`
+- `CHANGELOG.md`
+- `LICENSE`
+- `CONTRIBUTING.md`
+
+**Required Folders** (already created as ZIP files):
+- `dist.tar.gz` (contains the entire `dist/` folder)
+- `docs.tar.gz` (contains the entire `docs/` folder)
+- `examples.tar.gz` (contains the entire `examples/` folder)
+
+### Step 5: Complete Release
+1. ✅ Check "Set as the latest release"
+2. ❌ Leave "Set as a pre-release" unchecked
+3. Click **"Publish release"**
+
+## 📋 Release Summary
+
+**What this release fixes:**
+- **Critical Threshold Issue**: Fixed 0.75 threshold filtering out exact foName matches
+- **Better Balance**: 0.5 threshold provides optimal relevance vs. recall balance
+- **Reliable foName Filter**: Exact artifact matching now works consistently
+- **Updated Examples**: All configuration examples use proven 0.5 threshold
+- **Enhanced Documentation**: Clear guidance on threshold usage
+
+**Installation for users:**
+1. Download the release ZIP
+2. Extract to desired location
+3. Update MCP configuration to point to `dist/server.js`
+4. Add `FOINDEX_API_KEY` environment variable
+5. **IMPORTANT**: Set `FO_SEARCH_DEFAULT_THRESHOLD` to `0.5`
+
+## 🔗 Quick Links
+
+- **Repository**: https://github.com/xplusplusai/fo-semantic-mcp
+- **Releases**: https://github.com/xplusplusai/fo-semantic-mcp/releases
+- **API Key Signup**: https://www.xplusplus.ai/
+
+## ✅ Verification Steps
+
+After publishing the release:
+1. Verify the release appears in the releases list
+2. Check that all assets are downloadable
+3. Test the download and installation process
+4. Confirm the release is marked as "Latest"
+5. Test foName filter with 0.5 threshold works correctly
+
+---
+
+**The commit is complete and local tag is created. You need to push the tag and create the release through the GitHub web interface using the instructions above.**
+
+### Manual Push Commands (if needed):
+```bash
+cd "C:\Users\tmpsp\OneDrive\Documents\AI Work\FO-Index-MCP\fo-semantic-mcp-release"
+git push origin main
+git push origin v1.2.1
+```

release-notes-v1.2.1.txt

@@ -0,0 +1,36 @@
+## 🔧 v1.2.1 - Critical Threshold Fix
+
+**Resolved**: Fixed threshold settings that were filtering out exact matches. Updated all examples to use 0.5 threshold for reliable foName filter functionality.
+
+### Fixed
+- **Default Threshold**: Lowered from 0.75 to 0.5 for better result balance
+- **foName Filter Issues**: Fixed exact matches being filtered out by high thresholds
+- **Configuration Examples**: Updated all examples to use proven 0.5 threshold
+- **AI Instructions**: Enhanced guidance for threshold usage with foName filter
+
+### Enhanced
+- **Adaptive Strategy**: Updated to 0.5 → 0.4 → 0.3 → no threshold progression
+- **Debug Logging**: Added request/response logging for troubleshooting
+- **Documentation**: Comprehensive foName filter usage examples
+
+### Why This Fix Matters
+The original 0.75 threshold was too restrictive and filtered out exact artifact matches even when using the foName filter. This patch ensures reliable exact matching while maintaining semantic search quality.
+
+### Download & Installation
+1. Download the latest release and extract it anywhere on your system
+2. Get your API key from: **https://www.xplusplus.ai/**
+3. Configure your MCP client (Cursor IDE, Claude Desktop, VS Code)
+4. Use the provided `fo-semantic-mcp-win.cmd` launcher for Windows or `node dist/server.js` for other platforms
+
+### Configuration Update Required
+If upgrading from v1.2.0, update your MCP client configuration to use threshold 0.5:
+
+```json
+{
+  "env": {
+    "FO_SEARCH_DEFAULT_THRESHOLD": "0.5"
+  }
+}
+```
+
+**Perfect for F&O developers, consultants, and architects building extensions and understanding existing implementations!**

release-payload.json

@@ -0,0 +1,9 @@
+{
+  "tag_name": "v1.2.1",
+  "target_commitish": "main",
+  "name": "v1.2.1 - Critical Threshold Fix",
+  "body": "## 🔧 v1.2.1 - Critical Threshold Fix\n\n**Resolved**: Fixed threshold settings that were filtering out exact matches. Updated all examples to use 0.5 threshold for reliable foName filter functionality.\n\n### Fixed\n- **Default Threshold**: Lowered from 0.75 to 0.5 for better result balance\n- **foName Filter Issues**: Fixed exact matches being filtered out by high thresholds\n- **Configuration Examples**: Updated all examples to use proven 0.5 threshold\n- **AI Instructions**: Enhanced guidance for threshold usage with foName filter\n\n### Enhanced\n- **Adaptive Strategy**: Updated to 0.5 → 0.4 → 0.3 → no threshold progression\n- **Debug Logging**: Added request/response logging for troubleshooting\n- **Documentation**: Comprehensive foName filter usage examples\n\n### Why This Fix Matters\nThe original 0.75 threshold was too restrictive and filtered out exact artifact matches even when using the foName filter. This patch ensures reliable exact matching while maintaining semantic search quality.\n\n### Download & Installation\n1. Download the latest release and extract it anywhere on your system\n2. Get your API key from: **https://www.xplusplus.ai/**\n3. Configure your MCP client (Cursor IDE, Claude Desktop, VS Code)\n4. Use the provided `fo-semantic-mcp-win.cmd` launcher for Windows or `node dist/server.js` for other platforms\n\n### Configuration Update Required\nIf upgrading from v1.2.0, update your MCP client configuration to use threshold 0.5:\n\n```json\n{\n  \"env\": {\n    \"FO_SEARCH_DEFAULT_THRESHOLD\": \"0.5\"\n  }\n}\n```\n\n**Perfect for F&O developers, consultants, and architects building extensions and understanding existing implementations!**",
+  "draft": false,
+  "prerelease": false,
+  "make_latest": true
+}