Skip to content

feat: multi-client support + server-side enforcement#3

Merged
CLCrawford-dev merged 4 commits intomainfrom
feature/multi-client-distribution
Feb 17, 2026
Merged

feat: multi-client support + server-side enforcement#3
CLCrawford-dev merged 4 commits intomainfrom
feature/multi-client-distribution

Conversation

@nTEG-dev
Copy link
Member

Summary

  • Multi-client wizard: Added VS Code (Copilot), Windsurf, and Generic MCP client support to npx gitmem-mcp init. Auto-detects IDE, creates correct config paths and instruction files.
  • Server-side enforcement: Advisory warnings prepended to tool responses when agents skip the recall→confirm→act protocol. Works in ALL MCP clients without IDE hooks.
  • README updated: Expanded supported clients table, added --client flag docs.

What changed

File Change
bin/init-wizard.js 3 new client configs (vscode, windsurf, generic) with auto-detection
copilot-instructions.template New — VS Code Copilot instructions
windsurfrules.template New — Windsurf instructions
src/services/enforcement.ts New — 3 advisory checks (no session, no recall, unconfirmed scars)
src/server.ts 3 lines: import + check + prepend warning
tests/unit/services/enforcement.test.ts 30 new tests
package.json Added templates to files[], new keywords
README.md Multi-client docs

Test plan

  • 865 unit tests passing (zero regressions)
  • 4 smoke tests passing
  • Dry-run tested all 5 clients (claude, cursor, vscode, windsurf, generic)
  • Live enforcement demo: all 3 warning types fire correctly
  • Human: test MCP Inspector on Mac (npx @modelcontextprotocol/inspector node dist/index.js)
  • Human: test wizard in VS Code or Windsurf project

🤖 Generated with Claude Code

Claude and others added 4 commits February 17, 2026 07:46
Remove possessive language ("our Docker setup", "our container") and
specific internal container metrics that shouldn't be in public docs.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Add vscode client: .vscode/mcp.json + .github/copilot-instructions.md
- Add windsurf client: ~/.codeium/windsurf/mcp_config.json (user-level) + .windsurfrules
- Add generic client: .mcp.json fallback for any MCP-compatible tool
- Auto-detect new clients based on directory/file presence
- Handle user-level vs project-level MCP config scoping
- Create parent directories for nested config paths (.github/, .vscode/)
- Skip hooks step gracefully for clients without hook support
- Dynamic step count based on client capabilities (4-6 steps)
- Updated package.json files array and keywords for discoverability

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Updated hero line to list VS Code and Windsurf
- Quick Start now shows auto-detection and --client flag
- Supported Clients table expanded with hooks column
- Added manual config paths table for all clients
- CLI Commands table includes --client option

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Advisory enforcement that works in ALL MCP clients, not just Claude Code/Cursor.
Prepends warnings to tool responses when agents skip the recall→confirm→act protocol.

Three checks:
- No active session: warns when session-dependent tools called without session_start
- No recall: warns when consequential actions (create_learning, create_decision, etc.)
  are attempted without first calling recall()
- Unconfirmed scars: warns when recalled scars haven't been confirmed via confirm_scars()

Design: advisory (warnings), not blocking (errors). Zero overhead on compliant calls.

+30 unit tests covering all enforcement paths.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@CLCrawford-dev CLCrawford-dev merged commit 007347f into main Feb 17, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants