Extract MSBuild evaluation to separate build server process with dedicated protocol project

.github/copilot-instructions.md

@@ -0,0 +1,245 @@
+# FsAutoComplete Copilot Instructions
+
+## Project Overview
+
+FsAutoComplete (FSAC) is a Language Server Protocol (LSP) backend service that provides rich editing and intellisense features for F# development. It serves as the core engine behind F# support in various editors including Visual Studio Code (Ionide), Emacs, Neovim, Vim, Sublime Text, and Zed.
+
+## Supported Editors
+
+FsAutoComplete currently provides F# support for:
+- **Visual Studio Code** (via [Ionide](https://github.com/ionide/ionide-vscode-fsharp))
+- **Emacs** (via [emacs-fsharp-mode](https://github.com/fsharp/emacs-fsharp-mode))
+- **Neovim** (via [nvim-lspconfig](https://github.com/neovim/nvim-lspconfig/blob/master/doc/server_configurations.md#fsautocomplete))
+- **Vim** (via [vim-fsharp](https://github.com/fsharp/vim-fsharp))
+- **Sublime Text** (via [LSP package](https://lsp.sublimetext.io/language_servers/#f))
+- **Zed** (via [zed-fsharp](https://github.com/nathanjcollins/zed-fsharp))
+
+## Architecture
+
+### Core Components
+
+- **FsAutoComplete.Core**: Contains the core functionality, including:
+  - F# compiler service interfaces
+  - Code generation and refactoring utilities
+  - Symbol resolution and type checking
+  - Signature formatting and documentation
+  - File system abstractions
+
+- **FsAutoComplete**: Main LSP server implementation with:
+  - LSP protocol handlers and endpoints
+  - Code fixes and quick actions
+  - Parser for LSP requests/responses
+  - Program entry point
+
+- **FsAutoComplete.Logging**: Centralized logging infrastructure
+
+### Key Dependencies
+
+- **FSharp.Compiler.Service** (>= 43.9.300): Core F# compiler APIs for language analysis
+- **Ionide.ProjInfo** (>= 0.71.2): Project and solution file parsing, with separate packages for FCS integration and project system
+- **FSharpLint.Core**: Code linting and static analysis
+- **Fantomas.Client** (>= 0.9): F# code formatting
+- **Microsoft.Build** (>= 17.2): MSBuild integration for project loading
+- **Serilog** (>= 2.10.0): Structured logging infrastructure
+- **Language Server Protocol**: Communication with editors
+
+#### Target Frameworks
+- **netstandard2.0 & netstandard2.1**: For broader compatibility
+- **net8.0 & net9.0**: For latest .NET features and performance
+
+## Development Workflow
+
+### Building the Project
+
+Requirements:
+- .NET SDK (see `global.json` for exact version - minimum >= 6.0, recommended >= 7.0)
+
+```bash
+# Restore .NET tools (including Paket)
+dotnet tool restore
+
+# Build the entire solution
+dotnet build
+
+# Run tests
+dotnet test
+
+# Run specific test project
+dotnet test -f net8.0 ./test/FsAutoComplete.Tests.Lsp/FsAutoComplete.Tests.Lsp.fsproj
+
+# Format code
+dotnet fantomas src/ test/
+```
+
+#### Development Environment Options
+- **DevContainer**: Use with VSCode's Remote Containers extension for stable development environment
+- **Gitpod**: Web-based VSCode IDE available at https://gitpod.io/#https://github.com/fsharp/fsautocomplete
+
+### Project Dependencies
+
+This project uses **Paket** for dependency management instead of NuGet directly:
+- Dependencies are declared in `paket.dependencies`
+- Lock file is `paket.lock`
+- Each project has its own `paket.references` file
+
+### Code Organization
+
+#### Code Fixes
+- Located in `src/FsAutoComplete/CodeFixes/`
+- Each code fix is typically a separate F# module
+- Follow the pattern: analyze issue → generate fix → apply transformation
+- **Scaffolding**: Use `dotnet fsi build.fsx -- -p ScaffoldCodeFix YourCodeFixName` to create new code fixes
+- This generates implementation file, signature file, and unit test, plus updates registration files
+- Examples include: `ImplementInterface.fs`, `GenerateUnionCases.fs`, `AddMissingEqualsToTypeDefinition.fs`
+
+#### LSP Endpoints
+- Standard LSP endpoints in `src/FsAutoComplete/LspServers/`
+- Key server files: `AdaptiveFSharpLspServer.fs`, `AdaptiveServerState.fs`, `ProjectWorkspace.fs`
+- Custom F#-specific endpoints prefixed with `fsharp/`
+- Request/response types in `CommandResponse.fs`
+- Interface definitions in `IFSharpLspServer.fs`
+
+#### Testing
+- Main test suite in `test/FsAutoComplete.Tests.Lsp/`
+- Tests organized by feature area (CompletionTests, CodeFixTests, etc.)
+- Uses F# testing frameworks with custom helpers in `Helpers.fs`
+- Test cases often in `TestCases/` subdirectories
+
+## F# Language Conventions
+
+### Coding Style
+- Follow F# community conventions
+- Use `fantomas` for code formatting (configured in the project)
+- Prefer immutable data structures and functional programming patterns
+- Use explicit type annotations where they improve clarity
+
+### Module Organization
+- One primary type/feature per file
+- Use `.fs` and `.fsi` pairs for public APIs
+- Organize related functionality into modules
+- Follow naming conventions: `CamelCase` for types, `camelCase` for values
+
+### Error Handling
+- Use F# Result types for error handling where appropriate
+- Use FsToolkit.ErrorHandling for railway-oriented programming
+- Prefer explicit error types over generic exceptions
+
+## LSP Implementation Details
+
+### Supported Standard LSP Features
+- `textDocument/completion` with `completionItem/resolve`
+- `textDocument/hover`, `textDocument/definition`, `textDocument/references`
+- `textDocument/codeAction`, `textDocument/codeLens`
+- `textDocument/formatting` (via Fantomas)
+- `textDocument/rename`, `textDocument/signatureHelp`
+- Workspace management and file watching
+
+### Custom F# Extensions
+- `fsharp/signature`: Get formatted signature at position
+- `fsharp/compile`: Compile project and return diagnostics  
+- `fsharp/workspacePeek`: Discover available projects/solutions
+- `fsharp/workspaceLoad`: Load specific projects
+- `fsproj/addFile`, `fsproj/removeFile`: Project file manipulation
+- `fsharp/documentationForSymbol`: Get documentation for symbols
+- `fsharp/f1Help`: F1 help functionality
+- `fsharp/fsi`: F# Interactive integration
+
+## Testing Guidelines
+
+### Test Structure
+- Tests are organized by feature area
+- Use descriptive test names that explain the scenario
+- Include both positive and negative test cases
+- Test with realistic F# code examples
+
+### Adding New Tests
+1. Identify the appropriate test file (e.g., `CompletionTests.fs` for completion features)
+2. Follow existing patterns for test setup and assertions
+3. Use the helpers in `Helpers.fs` for common operations
+4. Include edge cases and error conditions
+5. For code fixes: Run focused tests with `dotnet run -f net8.0 --project ./test/FsAutoComplete.Tests.Lsp/FsAutoComplete.Tests.Lsp.fsproj`
+6. Remove focused test markers before submitting PRs (they cause CI failures)
+
+### Test Data
+- Sample F# projects in `TestCases/` directories
+- Use minimal, focused examples that demonstrate specific features
+- Avoid overly complex test scenarios that are hard to debug
+
+## Performance Considerations
+
+### Memory Management
+- Be mindful of memory usage in long-running language server scenarios
+- Dispose of compiler service resources appropriately
+- Use caching judiciously to balance performance and memory
+
+### Responsiveness
+- LSP operations should be fast and non-blocking
+- Use async/await patterns for I/O operations
+- Consider cancellation tokens for long-running operations
+
+## Debugging and Telemetry
+
+### OpenTelemetry Integration
+- Tracing is available with `--otel-exporter-enabled` flag
+- Use Jaeger for trace visualization during development
+- Activity tracing helps debug performance issues
+
+### Logging
+- Structured logging via Serilog
+- Use appropriate log levels (Debug, Info, Warning, Error)
+- Include relevant context in log messages
+
+## Common Patterns
+
+### Working with FCS (F# Compiler Service)
+- Always work with `FSharpCheckFileResults` and `FSharpParseFileResults`
+- Handle both parsed and typed ASTs appropriately
+- Be aware of file dependencies and project context
+
+### LSP Request Handling
+- Validate input parameters
+- Handle exceptions gracefully
+- Return appropriate error responses for invalid requests
+- Use proper JSON serialization
+
+### Code Generation
+- Use the F# AST utilities in `TypedAstUtils.fs` and `UntypedAstUtils.fs`
+- Consider both syntactic and semantic correctness
+- Test generated code compiles and has expected behavior
+
+## Contributing Guidelines
+
+### Before Submitting Changes
+1. Ensure all tests pass: `dotnet test`
+2. Run code formatting: `dotnet fantomas src/ test/`
+3. Verify the solution builds cleanly
+4. Test your changes with a real F# project if possible
+
+### Code Review Focus Areas
+- Correctness of F# language analysis
+- Performance impact on language server operations
+- Compatibility with different F# project types
+- LSP protocol compliance
+- Test coverage for new features
+
+## Resources
+
+### Core Documentation
+- [FsAutoComplete GitHub Repository](https://github.com/ionide/FsAutoComplete)
+- [LSP Specification](https://microsoft.github.io/language-server-protocol/)
+- [F# Compiler Service Documentation](https://fsharp.github.io/FSharp.Compiler.Service/)
+
+### F# Development Guidelines
+- [F# Style Guide](https://docs.microsoft.com/en-us/dotnet/fsharp/style-guide/)
+- [F# Formatting Guidelines](https://docs.microsoft.com/en-us/dotnet/fsharp/style-guide/formatting)
+- [F# Component Design Guidelines](https://docs.microsoft.com/en-us/dotnet/fsharp/style-guide/component-design-guidelines)
+
+### Project-Specific Guides
+- [Creating a New Code Fix Guide](./docs/Creating%20a%20new%20code%20fix.md)
+- [Ionide.ProjInfo Documentation](https://github.com/ionide/proj-info)
+- [Fantomas Configuration](https://fsprojects.github.io/fantomas/)
+
+### Related Tools
+- [FSharpLint](https://github.com/fsprojects/FSharpLint/) - Static analysis tool
+- [Paket](https://fsprojects.github.io/Paket/) - Dependency management
+- [FAKE](https://fake.build/) - Build automation (used for scaffolding)

.github/workflows/copilot-setup-steps.yml

@@ -0,0 +1,61 @@
+name: Copilot Setup Steps
+
+# This workflow is designed to be used by GitHub Copilot coding agents
+# to set up the environment needed to work with the FsAutoComplete repository
+
+on:
+  workflow_dispatch:
+  push:
+    paths:
+      - .github/workflows/copilot-setup-steps.yml
+  pull_request:
+    paths:
+      - .github/workflows/copilot-setup-steps.yml
+
+jobs:
+  copilot-setup-steps:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Setup .NET SDK
+      uses: actions/setup-dotnet@v4
+      with:
+        global-json-file: global.json
+
+    - name: Announce .NET version
+      run: dotnet --info
+
+    - name: Restore tools
+      run: dotnet tool restore
+
+    - name: Restore packages
+      run: dotnet restore
+
+    - name: Build solution
+      run: dotnet build -c Release --no-restore
+
+    - name: Verify Fantomas formatting
+      run: dotnet fantomas --check build.fsx src
+      env:
+        DOTNET_ROLL_FORWARD: LatestMajor
+        DOTNET_ROLL_FORWARD_TO_PRERELEASE: 1
+
+    - name: Run quick tests
+      run: dotnet test -c Release -f net8.0 --no-restore --no-build --logger "console;verbosity=minimal" -- Expecto.fail-on-focused-tests=true
+      working-directory: test/FsAutoComplete.Tests.Lsp
+      timeout-minutes: 5
+      continue-on-error: true # Don't fail the setup if tests fail
+
+    - name: Setup completed
+      run: |
+        echo "✅ Copilot setup completed successfully!"
+        echo "📦 Dependencies restored"
+        echo "🔨 Build verified"
+        echo "📝 Code formatting checked"
+        echo "🧪 Basic tests run"
+        echo ""
+        echo "The environment is ready for Copilot to work with FsAutoComplete."