Release v1.2.0: Exact Artifact Matching with foName Filter

- Add foName filter for exact artifact matching
- Enhanced MCP tool schema with filters.foName parameter
- Updated API documentation and examples
- Improved AI assistant integration with foName examples
- Perfect for precise F&O artifact discovery when exact names are known

Author: xplusplusai

CHANGELOG.md

@@ -5,6 +5,34 @@ All notable changes to FO Semantic MCP Server 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).
 
+## [1.2.0] - 2025-10-01
+
+**New Feature: Exact Artifact Matching**
+
+### Added
+- **foName Filter**: New exact match filter for finding specific F&O artifacts by name
+- **MCP Tool Enhancement**: Added `filters.foName` parameter to `search_fo_artifacts` tool
+- **AI Assistant Integration**: Updated MCP server instructions with foName filter examples
+- **API Documentation**: Added foName filter usage examples and documentation
+
+### Enhanced
+- **Search Precision**: When you know the exact F&O artifact name (e.g., "CustTable", "SalesTable"), use foName filter for precise results
+- **MCP Server Instructions**: Added examples showing how AI assistants should use foName for exact matches
+- **Tool Schema**: Updated MCP tool input schema to include filters.foName parameter
+
+### Use Cases
+- **Exact Artifact Lookup**: `search_fo_artifacts({ query: "currency table", filters: { foName: "Currency" } })`
+- **AI Assistant Guidance**: When AI knows specific artifact names, use foName for guaranteed exact matches
+- **Development Workflow**: Faster artifact discovery when exact names are known from requirements
+
+### Technical Changes
+- Updated `SearchFOArtifactsInput` interface to include filters.foName
+- Enhanced `SearchApiClient` to pass foName filter to backend API
+- Added foName parameter to MCP tool schema with proper Zod validation
+- Comprehensive documentation updates across API docs and MCP server instructions
+
+---
+
 ## [1.1.2] - 2025-10-01
 
 **Critical Bug Fix**

README.md

@@ -29,15 +29,22 @@ Transform your F&O development workflow with AI-powered semantic search over 50,
 - **Architects** understanding system patterns
 - **Teams** accelerating development cycles
 
-## ⚠️ Current Version Note (v1.1.2)
+## 🆕 New in v1.2.0
 
-**Cursor IDE Compatibility**: This version temporarily returns search results in **two formats simultaneously** to ensure compatibility across all Cursor IDE versions:
+**Exact Artifact Matching**: Added `foName` filter for precise artifact lookup when you know the exact F&O artifact name.
+
+**Key Features:**
+- **foName Filter**: Find specific artifacts by exact name (e.g., "CustTable", "SalesTable")
+- **AI Assistant Integration**: Enhanced MCP server instructions for exact matching
+- **Improved Precision**: Perfect for when you know exact artifact names from requirements
+
+## ⚠️ Compatibility Note
+
+**Cursor IDE Compatibility**: This version maintains dual-format response support to ensure compatibility across all Cursor IDE versions:
 
 1. **Structured Content** - For older clients with structured content display and MCP protocol compliance
 2. **Embedded JSON in Text** - For newer clients with structured content display issues
 
-This dual-format approach ensures the MCP server works reliably with both legacy and current Cursor IDE installations. Future versions may optimize this once MCP client standardization improves.
-
 ---
 
 ## 🔥 Real-World AI Assistant Scenarios
@@ -153,6 +160,7 @@ Update your MCP client configuration (replace `C:\\Downloads\\` with your extrac
 
 ## 💡 Example Queries
 
+### Natural Language Search
 ```
 "Find customer payment processing examples"
 "Show me sales order validation patterns"
@@ -161,6 +169,27 @@ Update your MCP client configuration (replace `C:\\Downloads\\` with your extrac
 "Show purchase order approval workflows"
 ```
 
+### Exact Artifact Matching (New in v1.2.0)
+```javascript
+// When you know the exact artifact name
+search_fo_artifacts({
+  query: "currency table",
+  filters: { foName: "Currency" }
+})
+
+// Find specific table by exact name
+search_fo_artifacts({
+  query: "customer data",
+  filters: { foName: "CustTable" }
+})
+
+// Locate exact form
+search_fo_artifacts({
+  query: "sales order form",
+  filters: { foName: "SalesTable" }
+})
+```
+
 ## 🔍 Search Features
 
 ### Adaptive Threshold Strategy
@@ -172,9 +201,15 @@ AI automatically retries searches with lower thresholds when no results found:
 
 ### Filter Options
 - **Artifact Types**: Table, Form, Class, EDT, Enum, DataEntity, View, Query
+- **foName Filter**: Exact match by specific F&O artifact name (e.g., "CustTable", "SalesTable")
 - **Result Limits**: 1-50 results per search
 - **Relevance Scoring**: 0-1 semantic similarity scores
 
+### When to Use foName Filter
+- **Known Artifact Names**: When you have exact F&O artifact names from requirements or documentation
+- **Precise Lookup**: Skip semantic matching and get the exact artifact you need
+- **Development Workflow**: Faster artifact discovery when exact names are specified
+
 ## 📖 Documentation
 
 - **Getting Started**: See `docs/GETTING_STARTED.md`

RELEASE_INSTRUCTIONS.md

@@ -0,0 +1,102 @@
+# Creating FO Semantic MCP v1.2.0 Release
+
+This directory contains scripts to automate the creation of the v1.2.0 release for the FO Semantic MCP project.
+
+## Quick Start
+
+### Option 1: Double-click (Windows)
+Simply double-click `create-release.bat` to run the release process.
+
+### Option 2: PowerShell (Windows)
+```powershell
+.\create-release-v1.2.0.ps1
+```
+
+### Option 3: Bash (Git Bash, Linux, macOS)
+```bash
+bash create-release-v1.2.0.sh
+```
+
+## What the Scripts Do
+
+1. **Verify Environment**: Check that you're in the correct directory and version is 1.2.0
+2. **Commit Changes**: Stage and commit all current v1.2.0 changes
+3. **Create Tag**: Create an annotated git tag for v1.2.0
+4. **Push to GitHub**: Push both the commit and tag to the remote repository
+5. **Create Release**:
+   - If GitHub CLI (`gh`) is available: Automatically create the GitHub release with assets
+   - If GitHub CLI not available: Provide detailed manual instructions
+
+## Prerequisites
+
+- Git configured with push access to the repository
+- (Optional) GitHub CLI (`gh`) installed and authenticated for automatic release creation
+
+## Release Assets
+
+The following files will be included as release assets:
+- `dist/` (entire folder with compiled JavaScript)
+- `package.json`
+- `package-lock.json`
+- `README.md`
+- `CHANGELOG.md`
+- `LICENSE`
+- `CONTRIBUTING.md`
+- `docs/` (documentation folder)
+- `examples/` (examples folder)
+
+## Manual Release (if GitHub CLI not available)
+
+If the GitHub CLI is not available, the script will provide you with:
+1. Complete step-by-step instructions
+2. Pre-formatted release notes saved to `release-notes-v1.2.0.txt`
+3. List of files to upload as assets
+
+You can then:
+1. Go to https://github.com/xplusplusai/fo-semantic-mcp/releases/new
+2. Follow the provided instructions
+3. Copy the release notes from the generated file
+4. Upload the specified asset files
+
+## Release Details
+
+- **Tag**: v1.2.0
+- **Title**: v1.2.0: Exact Artifact Matching with foName Filter
+- **Target Branch**: main
+- **Release Type**: Latest release (not pre-release)
+
+## Key Features in v1.2.0
+
+- **foName Filter**: Exact artifact matching by name
+- **Enhanced MCP Tool**: Updated schema with filters.foName parameter
+- **AI Assistant Integration**: Better integration with foName examples
+- **Production Ready**: Real integrations with comprehensive documentation
+
+## Troubleshooting
+
+### "GitHub CLI not found"
+- Install GitHub CLI from https://cli.github.com/
+- Or follow the manual release instructions provided by the script
+
+### "Permission denied" errors
+- Ensure you have push access to the repository
+- Run `git remote -v` to verify you're connected to the correct repository
+
+### "Version mismatch" errors
+- Verify that `package.json` shows version "1.2.0"
+- Check that you're in the correct directory
+
+## Post-Release Steps
+
+After the release is created:
+1. Verify the release appears at https://github.com/xplusplusai/fo-semantic-mcp/releases
+2. Test downloading and installing the release package
+3. Update any external documentation that references the version number
+4. Announce the release to users and stakeholders
+
+## Support
+
+For issues with the release process, check:
+- Repository permissions and authentication
+- Git configuration and remote setup
+- GitHub CLI installation and authentication (if using automatic mode)

create-release-simple.ps1

@@ -0,0 +1,171 @@
+# FO Semantic MCP v1.2.0 Release Script (PowerShell)
+# Simple version that avoids PowerShell parsing issues
+
+param(
+    [switch]$DryRun = $false
+)
+
+Write-Host "🚀 Creating FO Semantic MCP v1.2.0 Release" -ForegroundColor Cyan
+Write-Host "==========================================" -ForegroundColor Cyan
+
+# Check if we're in the right directory
+if (-not (Test-Path "package.json")) {
+    Write-Host "❌ Error: package.json not found. Please run this script from the fo-semantic-mcp-release directory." -ForegroundColor Red
+    exit 1
+}
+
+# Check if version in package.json is 1.2.0
+$packageJson = Get-Content "package.json" | ConvertFrom-Json
+$version = $packageJson.version
+if ($version -ne "1.2.0") {
+    Write-Host "❌ Error: package.json version is $version, expected 1.2.0" -ForegroundColor Red
+    exit 1
+}
+
+Write-Host "✅ Version check passed: $version" -ForegroundColor Green
+
+if ($DryRun) {
+    Write-Host "🔍 DRY RUN MODE - No actual changes will be made" -ForegroundColor Yellow
+}
+
+# Commit the current changes
+Write-Host "📝 Committing v1.2.0 changes..." -ForegroundColor Blue
+
+$commitMessage = "Release v1.2.0: Exact Artifact Matching with foName Filter
+
+- Add foName filter for exact artifact matching
+- Enhanced MCP tool schema with filters.foName parameter
+- Updated API documentation and examples
+- Improved AI assistant integration with foName examples
+- Perfect for precise F&O artifact discovery when exact names are known"
+
+if (-not $DryRun) {
+    git add .
+    git commit -m $commitMessage
+    if ($LASTEXITCODE -ne 0) {
+        Write-Host "❌ Error: Failed to commit changes" -ForegroundColor Red
+        exit 1
+    }
+}
+
+Write-Host "✅ Changes committed" -ForegroundColor Green
+
+# Create and push the tag
+Write-Host "🏷️  Creating v1.2.0 tag..." -ForegroundColor Blue
+
+$tagMessage = "v1.2.0: Exact Artifact Matching with foName Filter
+
+New Feature: Precise F&O Artifact Discovery with foName filter for exact artifact matching.
+Perfect for when you know the specific F&O artifact name and want guaranteed precise results.
+
+Key Features:
+- foName Filter for exact artifact matching
+- Enhanced MCP tool schema
+- AI Assistant Integration improvements
+- Production Ready with comprehensive documentation"
+
+if (-not $DryRun) {
+    git tag -a v1.2.0 -m $tagMessage
+    if ($LASTEXITCODE -ne 0) {
+        Write-Host "❌ Error: Failed to create tag" -ForegroundColor Red
+        exit 1
+    }
+}
+
+Write-Host "✅ Tag created" -ForegroundColor Green
+
+# Push the commit and tag
+Write-Host "📤 Pushing to GitHub..." -ForegroundColor Blue
+
+if (-not $DryRun) {
+    git push origin main
+    if ($LASTEXITCODE -eq 0) {
+        Write-Host "✅ Pushed commit to main" -ForegroundColor Green
+    } else {
+        Write-Host "❌ Error: Failed to push commit" -ForegroundColor Red
+        exit 1
+    }
+
+    git push origin v1.2.0
+    if ($LASTEXITCODE -eq 0) {
+        Write-Host "✅ Pushed tag v1.2.0" -ForegroundColor Green
+    } else {
+        Write-Host "❌ Error: Failed to push tag" -ForegroundColor Red
+        exit 1
+    }
+}
+
+# Create the GitHub Release
+Write-Host "🎉 Creating GitHub Release..." -ForegroundColor Blue
+
+# Check if GitHub CLI is available
+$ghAvailable = Get-Command gh -ErrorAction SilentlyContinue
+
+if ($ghAvailable -and -not $DryRun) {
+    Write-Host "📋 Using GitHub CLI to create release..." -ForegroundColor Blue
+
+    try {
+        $releaseNotesPath = "release-notes-v1.2.0.txt"
+
+        # Create release using GitHub CLI
+        gh release create v1.2.0 --title "v1.2.0: Exact Artifact Matching with foName Filter" --notes-file $releaseNotesPath --target main --latest
+
+        if ($LASTEXITCODE -eq 0) {
+            Write-Host "✅ GitHub release created successfully!" -ForegroundColor Green
+
+            # Upload assets
+            Write-Host "📦 Uploading release assets..." -ForegroundColor Blue
+            gh release upload v1.2.0 package.json package-lock.json README.md CHANGELOG.md LICENSE CONTRIBUTING.md
+
+            if ($LASTEXITCODE -eq 0) {
+                Write-Host "✅ Release assets uploaded successfully!" -ForegroundColor Green
+            } else {
+                Write-Host "⚠️  Release created but some assets failed to upload" -ForegroundColor Yellow
+            }
+        } else {
+            Write-Host "❌ Error: Failed to create GitHub release" -ForegroundColor Red
+            exit 1
+        }
+    } catch {
+        Write-Host "❌ Error creating release: $($_.Exception.Message)" -ForegroundColor Red
+        Write-Host "⚠️  Please create the release manually..." -ForegroundColor Yellow
+        $ghAvailable = $false
+    }
+}
+
+if (-not $ghAvailable) {
+    Write-Host "⚠️  GitHub CLI not available. Please create the release manually:" -ForegroundColor Yellow
+    Write-Host ""
+    Write-Host "📋 Manual Release Instructions:" -ForegroundColor Cyan
+    Write-Host "1. Go to: https://github.com/xplusplusai/fo-semantic-mcp/releases/new" -ForegroundColor White
+    Write-Host "2. Tag: v1.2.0" -ForegroundColor White
+    Write-Host "3. Title: v1.2.0: Exact Artifact Matching with foName Filter" -ForegroundColor White
+    Write-Host "4. Target: main" -ForegroundColor White
+    Write-Host "5. Copy release notes from: release-notes-v1.2.0.txt" -ForegroundColor White
+    Write-Host "6. Upload these files as release assets:" -ForegroundColor White
+    Write-Host "   - dist/ (entire folder)" -ForegroundColor Gray
+    Write-Host "   - package.json" -ForegroundColor Gray
+    Write-Host "   - package-lock.json" -ForegroundColor Gray
+    Write-Host "   - README.md" -ForegroundColor Gray
+    Write-Host "   - CHANGELOG.md" -ForegroundColor Gray
+    Write-Host "   - LICENSE" -ForegroundColor Gray
+    Write-Host "   - CONTRIBUTING.md" -ForegroundColor Gray
+    Write-Host "   - docs/ (entire folder)" -ForegroundColor Gray
+    Write-Host "   - examples/ (entire folder)" -ForegroundColor Gray
+    Write-Host "7. Check 'Set as the latest release'" -ForegroundColor White
+    Write-Host "8. Click 'Publish release'" -ForegroundColor White
+    Write-Host ""
+    Write-Host "📄 Release notes are saved in: release-notes-v1.2.0.txt" -ForegroundColor Cyan
+}
+
+Write-Host ""
+Write-Host "🎉 Release process completed!" -ForegroundColor Green
+Write-Host "📦 Version: v1.2.0" -ForegroundColor Cyan
+Write-Host "🔗 Repository: https://github.com/xplusplusai/fo-semantic-mcp" -ForegroundColor Cyan
+Write-Host "📋 Releases: https://github.com/xplusplusai/fo-semantic-mcp/releases" -ForegroundColor Cyan
+
+if ($DryRun) {
+    Write-Host ""
+    Write-Host "ℹ️  This was a dry run. To execute the release, run:" -ForegroundColor Blue
+    Write-Host "   .\create-release-simple.ps1" -ForegroundColor White
+}