sharpninja · sharpninja · Mar 21, 2026 · Mar 7, 2026 · Mar 7, 2026 · Mar 7, 2026
diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
@@ -1,6 +1,6 @@
 # Copilot Instructions — McpServer
 
-**Agent Identity:** When posting to the MCP session log, use `sourceType: copilotcli`.
+**Agent Identity:** When posting to the MCP session log, use the agent's actual identity in Pascal-Case for `sourceType` and the session ID prefix. Do not use inaccurate aliases, lowercase names, or legacy placeholders. Example: `Codex`.
 For specific operational instructions (session bootstrap, turn logging lifecycle, helper command order), follow `AGENTS-README-FIRST.yaml`.
 
 ## Response Formatting

diff --git a/.github/workflows/mcp-server-ci.yml b/.github/workflows/mcp-server-ci.yml
@@ -30,7 +30,6 @@ on:
       - "scripts/Start-McpServer.ps1"
       - "scripts/Package-McpServerMsix.ps1"
       - "scripts/Migrate-McpTodoStorage.ps1"
-      - "scripts/Validate-McpConfig.ps1"
       - "scripts/Test-McpMultiInstance.ps1"
       - ".github/workflows/mcp-server-ci.yml"
       - "GitVersion.yml"
@@ -55,7 +54,6 @@ on:
       - "scripts/Start-McpServer.ps1"
       - "scripts/Package-McpServerMsix.ps1"
       - "scripts/Migrate-McpTodoStorage.ps1"
-      - "scripts/Validate-McpConfig.ps1"
       - "scripts/Test-McpMultiInstance.ps1"
       - ".github/workflows/mcp-server-ci.yml"
       - "GitVersion.yml"
@@ -78,10 +76,6 @@ jobs:
       - name: Restore
         run: dotnet restore tests/McpServer.Support.Mcp.Tests/McpServer.Support.Mcp.Tests.csproj
 
-      - name: Validate MCP config
-        shell: pwsh
-        run: ./scripts/Validate-McpConfig.ps1
-
       - name: Build
         run: dotnet build tests/McpServer.Support.Mcp.Tests/McpServer.Support.Mcp.Tests.csproj -c Release --no-restore
 
@@ -128,6 +122,7 @@ jobs:
   windows-msix:
     runs-on: windows-latest
     needs: build-test-publish
+    continue-on-error: true
     steps:
       - uses: actions/checkout@v4
 
@@ -147,63 +142,10 @@ jobs:
           name: mcp-server-msix
           path: artifacts/msix/*.msix
 
-  multi-instance-smoke:
-    runs-on: windows-latest
-    needs: build-test-publish
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Setup .NET
-        uses: actions/setup-dotnet@v4
-        with:
-          global-json-file: global.json
-
-      - name: Run multi-instance smoke test
-        shell: pwsh
-        run: |
-          ./scripts/Test-McpMultiInstance.ps1 -Configuration Staging -FirstInstance default -SecondInstance alt-local -TimeoutSeconds 180
-
-  docker-smoke:
+  release-main:
     runs-on: ubuntu-latest
-    needs: build-test-publish
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Build Docker image
-        run: docker build -t mcp-server:ci .
-
-      - name: Start container and health check
-        run: |
-          docker run -d --name mcp-ci -p 7147:7147 \
-            -e Mcp__Port=7147 \
-            -e Mcp__DataDirectory=/data \
-            -e VectorIndex__IndexPath=/data/vector.idx \
-            -e Embedding__Enabled=false \
-            -e VectorIndex__Enabled=false \
-            mcp-server:ci
-          for i in {1..30}; do
-            if curl -fsS http://localhost:7147/health; then
-              echo "Health check passed"
-              break
-            fi
-            sleep 1
-          done
-          curl -fsS http://localhost:7147/health | grep -q Healthy
-
-      - name: Test TODO endpoint
-        run: curl -fsS http://localhost:7147/mcpserver/todo | head -c 200
-
-      - name: Test Swagger
-        run: curl -fsS http://localhost:7147/swagger/v1/swagger.json -o /dev/null
-
-      - name: Cleanup
-        if: always()
-        run: docker stop mcp-ci && docker rm mcp-ci || true
-
-  release-main:
-    runs-on: ubuntu-latest
-    needs: [windows-msix, multi-instance-smoke, docker-smoke]
-    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    needs: [windows-msix]
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main' && needs.windows-msix.result == 'success'
     steps:
       - name: Download MSIX artifact
         uses: actions/download-artifact@v4

diff --git a/.gitignore b/.gitignore
@@ -358,6 +358,9 @@ ASALocalRun/
 # MSBuild Binary and Structured Log
 *.binlog
 
+# Build output
+**/bin/
+
 # NVidia Nsight GPU debugger configuration file
 *.nvuser
 
@@ -486,6 +489,7 @@ $RECYCLE.BIN/
 # MCP server marker files (runtime artifacts for agent port discovery)
 .mcp-server.yaml
 .mcp-server.json
+.mcpServer/
 
 # SQLite database files (runtime data)
 *.db
@@ -505,3 +509,5 @@ AGENTS-README-FIRST.yaml
 
 # MCP Data
 mcp-data/
+/src/McpServer.Support.Mcp/Properties/launchSettings.json
+/src/McpServer.AgentFramework.SampleHost/Properties/launchSettings.json
diff --git a/.markdownlint-cli2.yaml b/.markdownlint-cli2.yaml
@@ -7,6 +7,7 @@ config:
   MD032: false
   MD033: false
   MD034: false
+  MD038: false
   MD040: false
   MD042: false
   MD060: false
diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -0,0 +1,3 @@
+{
+    "fusion-360-helper.enabled": false
+}
diff --git a/AGENTS.md b/AGENTS.md
@@ -1,26 +1,27 @@
 # Agent Instructions
 
-## Session Start
-
-1. Read `AGENTS-README-FIRST.yaml` in the repo root for the current API key and endpoints.
-2. For specific operational steps (session bootstrap, session log turn workflow, and helper command sequence), follow `AGENTS-README-FIRST.yaml`.
-
-On every subsequent user message:
-
-1. Follow `AGENTS-README-FIRST.yaml` for specific operational instructions.
-2. Complete the user's request.
-
-## Rules
-
-1. `templates/prompt-templates.yaml` (`default-marker-prompt`) is the source of truth for specific agent instructions. `AGENTS-README-FIRST.yaml` is the rendered runtime instruction set.
-2. Keep this file focused on durable workspace policy and conventions; avoid duplicating marker-file operational procedures.
-3. Use helper modules for session log and TODO operations. Do not make raw API calls.
-4. Persist session log updates immediately after each meaningful change (turn creation, action append, decision, requirement, blocker, file/context update). Do not defer saves.
-5. Capture rich turn detail: interpretation, response, status, actions (type/status/filePath), contextList, filesModified, designDecisions, requirementsDiscovered, blockers, and relevant processing dialog.
-6. Follow workspace conventions in `.github/copilot-instructions.md` for build, test, and architecture guidance.
-7. When you need API schemas, module examples, or compliance rules, load them from `docs/context/` or use `context_search`.
+## Session Start
+
+1. Read `AGENTS-README-FIRST.yaml` in the repo root for the current API key and endpoints.
+2. For specific operational steps (session bootstrap, session log turn workflow, and helper command sequence), follow `AGENTS-README-FIRST.yaml`.
+
+On every subsequent user message:
+
+1. Follow `AGENTS-README-FIRST.yaml` for specific operational instructions.
+2. Complete the user's request.
+
+## Rules
+
+1. `templates/prompt-templates.yaml` (`default-marker-prompt`) is the source of truth for specific agent instructions. `AGENTS-README-FIRST.yaml` is the rendered runtime instruction set.
+2. Keep this file focused on durable workspace policy and conventions; avoid duplicating marker-file operational procedures.
+3. Use helper modules for session log and TODO operations. Do not make raw API calls.
+4. Persist session log updates immediately after each meaningful change (turn creation, action append, decision, requirement, blocker, file/context update). Do not defer saves.
+5. Capture rich turn detail: interpretation, response, status, actions (type/status/filePath), contextList, filesModified, designDecisions, requirementsDiscovered, blockers, and relevant processing dialog.
+6. Follow workspace conventions in `.github/copilot-instructions.md` for build, test, and architecture guidance.
+7. When you need API schemas, module examples, or compliance rules, load them from `docs/context/` or use `context_search`.
 8. Do not fabricate information. If you made a mistake, acknowledge it. Distinguish facts from speculation.
 9. Prioritize correctness over speed. Do not ship code you have not verified compiles and is logically sound.
+10. When writing session logs or other audit records, agents must identify themselves accurately using their real agent identity in Pascal-Case. Do not use placeholder, legacy, or misleading sourceType values.
 
 ## Where Things Live
 
@@ -29,6 +30,9 @@ On every subsequent user message:
 - `docs/context/` — on-demand reference docs (schemas, module docs, compliance rules, action types)
 - `docs/Project/` — requirements docs, TODO.yaml, mapping matrices
 - `templates/` — prompt templates (loaded on demand)
+- `tools/powershell/McpContext.psm1` — PowerShell module for context ingestion/query workflows
+- `tools/powershell/McpContext.USER.md` — user-level guide for the McpContext module
+- `tools/powershell/McpContext.AGENT.md` — agent workflow instructions for the McpContext module
 
 ## Context Loading by Task Type
 
@@ -72,9 +76,9 @@ You represent the workspace owner. Your work directly reflects the owner's profe
 
 ### Source Attribution
 
-- Document all web sources in the session log as actions with type "web_reference" (URL, title, usage).
-- Add source URLs to the turn's contextList array.
-- Attribute external code in both the session log and code comments.
+- Document all web sources in the session log as actions with type "web_reference" (URL, title, usage).
+- Add source URLs to the turn's contextList array.
+- Attribute external code in both the session log and code comments.
 
 ## Requirements Tracking
 
@@ -86,31 +90,31 @@ When you discover or agree on new requirements during a session:
    - `TR-per-FR-Mapping.md` — append mapping rows
    - `Requirements-Matrix.md` — append status rows
    - `Testing-Requirements.md` — append TEST-MCP-* entries
-2. Include the requirement ID in your session log turn's tags.
+2. Include the requirement ID in your session log turn's tags.
 3. Capture requirements as they emerge. Do not defer to later.
 
 ## Design Decision Logging
 
 When a design decision is made:
 
-1. Log it as a session log dialog item with category "decision".
+1. Log it as a session log dialog item with category "decision".
 2. Include: the decision, alternatives considered, rationale, and affected requirements.
 3. Add a session log action with type "design_decision".
 4. If the decision affects existing code or requirements, note what needs updating.
 
-## Session Continuity
-
-At the start of every session:
-
-1. Follow the session-start checklist in `AGENTS-README-FIRST.yaml`.
-2. Read `docs/Project/Requirements-Matrix.md` to understand project state.
-3. If resuming interrupted work, review the last session's pending decisions.
-
-At regular intervals during long sessions (~10 interactions):
-
-1. Follow marker-file update cadence and session logging requirements from `AGENTS-README-FIRST.yaml`.
-2. Ensure all design decisions are captured.
-3. Verify requirements docs are up to date.
+## Session Continuity
+
+At the start of every session:
+
+1. Follow the session-start checklist in `AGENTS-README-FIRST.yaml`.
+2. Read `docs/Project/Requirements-Matrix.md` to understand project state.
+3. If resuming interrupted work, review the last session's pending decisions.
+
+At regular intervals during long sessions (~10 interactions):
+
+1. Follow marker-file update cadence and session logging requirements from `AGENTS-README-FIRST.yaml`.
+2. Ensure all design decisions are captured.
+3. Verify requirements docs are up to date.
 
 ## Glossary
 
@@ -127,4 +131,3 @@ At regular intervals during long sessions (~10 interactions):
 
 - Do not use table-style output in responses.
 - Use concise bullets or short paragraphs instead.
-
diff --git a/Directory.Packages.props b/Directory.Packages.props
@@ -7,10 +7,12 @@
     <PackageVersion Include="bunit" Version="2.6.2" />
     <PackageVersion Include="Microsoft.Extensions.DependencyInjection" Version="10.0.2" />
     <PackageVersion Include="Microsoft.Extensions.DependencyInjection.Abstractions" Version="10.0.2" />
+    <PackageVersion Include="Microsoft.Extensions.Hosting" Version="9.0.12" />
     <PackageVersion Include="Microsoft.Extensions.Logging.Abstractions" Version="10.0.2" />
     <PackageVersion Include="Microsoft.Extensions.Options" Version="10.0.2" />
     <PackageVersion Include="Microsoft.Extensions.Hosting.WindowsServices" Version="9.0.12" />
     <PackageVersion Include="Microsoft.Extensions.Hosting.Abstractions" Version="9.0.0" />
+    <PackageVersion Include="Microsoft.Extensions.AI.OpenAI" Version="10.3.0" />
     <PackageVersion Include="Microsoft.Extensions.Http" Version="9.0.5" />
     <PackageVersion Include="Microsoft.Extensions.Http.Resilience" Version="9.0.0" />
     <PackageVersion Include="Microsoft.Extensions.ServiceDiscovery" Version="9.0.0" />
@@ -26,6 +28,12 @@
     <PackageVersion Include="Microsoft.EntityFrameworkCore.Design" Version="9.0.12" />
     <PackageVersion Include="Microsoft.EntityFrameworkCore.Analyzers" Version="9.0.12" />
     <PackageVersion Include="Microsoft.EntityFrameworkCore.InMemory" Version="9.0.12" />
+    <PackageVersion Include="Microsoft.CodeAnalysis.Common" Version="4.11.0" />
+    <PackageVersion Include="Microsoft.CodeAnalysis.CSharp" Version="4.11.0" />
+    <PackageVersion Include="Microsoft.CodeAnalysis.CSharp.Workspaces" Version="4.11.0" />
+    <PackageVersion Include="Microsoft.CodeAnalysis.Workspaces.Common" Version="4.11.0" />
+    <PackageVersion Include="Microsoft.CodeAnalysis.Workspaces.MSBuild" Version="4.11.0" />
+    <PackageVersion Include="Microsoft.Build.Framework" Version="17.11.4" />
     <PackageVersion Include="Microsoft.AspNetCore.Mvc.Testing" Version="9.0.12" />
     <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="18.0.1" />
     <PackageVersion Include="xunit.v3" Version="3.2.2" />
@@ -43,13 +51,18 @@
     <PackageVersion Include="Swashbuckle.AspNetCore" Version="10.1.2" />
     <PackageVersion Include="Microsoft.AspNetCore.Authentication.JwtBearer" Version="9.0.0" />
     <PackageVersion Include="Microsoft.AspNetCore.Authentication.OpenIdConnect" Version="9.0.0" />
+    <PackageVersion Include="Microsoft.Agents.AI" Version="1.0.0-rc3" />
+    <PackageVersion Include="Microsoft.Agents.AI.OpenAI" Version="1.0.0-rc3" />
+    <PackageVersion Include="Microsoft.Agents.AI.Workflows" Version="1.0.0-rc3" />
+    <PackageVersion Include="Microsoft.PowerShell.SDK" Version="7.5.4" />
     <PackageVersion Include="Avalonia" Version="11.3.12" />
     <PackageVersion Include="CommunityToolkit.Mvvm" Version="8.4.0" />
     <PackageVersion Include="System.CommandLine" Version="2.0.0-beta4.22272.1" />
     <PackageVersion Include="Spectre.Console" Version="0.49.1" />
     <PackageVersion Include="IdentityModel" Version="7.0.0" />
     <PackageVersion Include="IdentityModel.OidcClient" Version="6.0.0" />
     <PackageVersion Include="Newtonsoft.Json" Version="13.0.4" />
+    <PackageVersion Include="OpenAI" Version="2.8.0" />
     <PackageVersion Include="YamlDotNet" Version="16.3.0" />
     <PackageVersion Include="NetEscapades.Configuration.Yaml" Version="3.1.0" />
     <PackageVersion Include="Microsoft.ML.OnnxRuntime" Version="1.24.1" />
@@ -62,7 +75,6 @@
     <PackageVersion Include="Handlebars.Net" Version="2.1.6" />
     <PackageVersion Include="System.IdentityModel.Tokens.Jwt" Version="8.7.0" />
     <PackageVersion Include="Terminal.Gui" Version="2.0.0" />
-    <!-- VS Extension SDK packages -->
     <PackageVersion Include="Microsoft.VSSDK.BuildTools" Version="17.14.2120" />
     <PackageVersion Include="Microsoft.VisualStudio.Shell.15.0" Version="17.14.40264" />
     <PackageVersion Include="Microsoft.VisualStudio.Imaging" Version="17.14.40264" />

diff --git a/GitVersion.yml b/GitVersion.yml
@@ -1,5 +1,5 @@
 mode: ContinuousDelivery
-next-version: 0.2.59
+next-version: 0.2.74
 assembly-versioning-scheme: MajorMinorPatch
 assembly-informational-format: '{SemVer}+Branch.{BranchName}.Sha.{ShortSha}'
 branches: