AJ
0054386700
- Add ProjectOperationsService.cs to project file compilation - Update System.Text.Json from 8.0.0 to 8.0.5 to fix security vulnerabilities - Fix .NET Framework 4.8 compatibility (remove entireProcessTree parameter from Process.Kill) - Remove ExcludeAssets restriction from Microsoft.VisualStudio.SDK package - Add project operation endpoints (NuGet, build, clean, restore, directory creation) - Update AGENTS.md with MSBuild build instructions and warnings - Replace roslyn-api skill with roslyn-bridge skill - Update settings with additional auto-approvals Build now completes successfully with MSBuild (0 errors, 34 warnings). 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2.7 KiB
2.7 KiB
Repository Guidelines
Project Structure & Module Organization
RoslynBridge/– VSIX source (C#). Key folders:Server/(HTTP host),Services/(Roslyn queries, refactorings),Models/,Constants/.- Build artifacts:
RoslynBridge/bin/andRoslynBridge/obj/. - Claude skills:
.claude/skills/roslyn-api/SKILL.md(HTTP query reference for local discovery/testing).
Build, Test, and Development Commands
- IMPORTANT: This VSIX project MUST be built with MSBuild, NOT
dotnet build. Usingdotnet buildwill fail with missing namespace errors. - Build (CLI):
msbuild RoslynBridge.sln /p:Configuration=Debugor with full path:& 'C:\Program Files\Microsoft Visual Studio\2022\Community\MSBuild\Current\Bin\MSBuild.exe' RoslynBridge.sln /t:Restore /t:Build /p:Configuration=Debug - Build (VS): Open
RoslynBridge.sln, setRoslynBridgeas startup, press F5 to launch the Experimental Instance. - Health check (server running in VS):
- PowerShell:
$b=@{queryType='getprojects'}|ConvertTo-Json; Invoke-RestMethod -Uri 'http://localhost:59123/query' -Method Post -Body $b -ContentType 'application/json' - curl (Windows):
curl -X POST http://localhost:59123/query -H "Content-Type: application/json" -d "{\"queryType\":\"getprojects\"}"
- PowerShell:
Coding Style & Naming Conventions
- Language: C# (net48 VSIX). Use 4‑space indentation; braces on new lines.
- Naming:
PascalCasefor types/methods;camelCasefor locals; private fields as_camelCase. - Prefer
async/await, avoid blocking the UI thread; useJoinableTaskFactorywhen switching. - Keep nullable annotations consistent with project settings.
- Run Format Document and Organize Usings before commits.
Testing Guidelines
- No unit test project yet. Validate via HTTP endpoints (see SKILL.md):
getprojects,getdiagnostics,getsolutionoverview,getsymbol, etc. - Expected response shape:
{ success, message, data, error }(JSON). - Lines are 1‑based; columns 0‑based. File paths in JSON require escaped backslashes.
Commit & Pull Request Guidelines
- Commits: concise, imperative subject (e.g., "Add diagnostics endpoint"), with short body explaining rationale and scope.
- PRs: include description, linked issues, sample requests/responses, and screenshots when UI/VS behavior is affected.
- Checklist: builds clean,
getdiagnosticsshows no new errors, code formatted, usings organized.
Security & Configuration Tips
- Server binds to
http://localhost:59123/and accepts only POST; CORS is permissive for local tooling. Do not expose externally. - Endpoints:
/query(main),/healthroute exists but still requires POST. - Adjust port/paths in
RoslynBridge/Constants/ServerConstants.csif needed.