Context
During the development of Epic #10186 (Concurrency Audit), we identified that the Twin Language Server bug is amplified by workspace-local .gemini/settings.json files conflicting with the global ~/.gemini/antigravity/mcp_config.json.
The Problem
If an agent accidentally modifies or commits .gemini/settings.json, it can trigger dual-language server initialization in Antigravity, leading to 2x process duplication for MCP servers. Furthermore, stale files like rescueMigration.mjs clutter the operational environment.
The Architectural Reality
Antigravity parses the MCP config twice if both a system-scope and workspace-scope config exist. The codebase should provide a template rather than an active configuration file by default.
The Fix
- Rename
.gemini/settings.json to .gemini/settings.template.json to prevent automatic parsing.
- Update the Antigravity configuration paths referenced in
learn/agentos/tooling/MemoryCoreMcpAuth.md.
- Delete the obsolete
rescueMigration.mjs file.
Acceptance Criteria
Out of Scope
- Fixes to the Antigravity Twin Language Server logic itself (this is a codebase hygiene layer).
Retrieval Hint: antigravity config hardening twin language server settings.template
Context During the development of Epic #10186 (Concurrency Audit), we identified that the Twin Language Server bug is amplified by workspace-local
.gemini/settings.jsonfiles conflicting with the global~/.gemini/antigravity/mcp_config.json.The Problem If an agent accidentally modifies or commits
.gemini/settings.json, it can trigger dual-language server initialization in Antigravity, leading to 2x process duplication for MCP servers. Furthermore, stale files likerescueMigration.mjsclutter the operational environment.The Architectural Reality Antigravity parses the MCP config twice if both a system-scope and workspace-scope config exist. The codebase should provide a template rather than an active configuration file by default.
The Fix
.gemini/settings.jsonto.gemini/settings.template.jsonto prevent automatic parsing.learn/agentos/tooling/MemoryCoreMcpAuth.md.rescueMigration.mjsfile.Acceptance Criteria
.gemini/settings.jsonis renamed to a template file.rescueMigration.mjsis removed from the repository.Out of Scope
Retrieval Hint:
antigravity config hardening twin language server settings.template