feat: remove MCP injection, integrate context-stewardship into CLI, cleanup dead code

- Remove all MCP config injection (13 configure*Mcp functions, MCP interfaces, MCP path helpers)
- Delete antigravity-scope.ts (100% MCP)
- Delete shared/index.ts barrel file (unused)
- Remove 11 dead exports from scope files and validators
- Make 5 internal exports private (template-source, traceability, ears, mermaid)
- Deduplicate formatError across requirements/design/tasks validators
- Remove 3 no-op Mermaid validators (flowchart, classDiagram, erDiagram)
- Rename mcp-context-injector to phase-context-injector
- Create sds stewardship CLI command with 7 subcommands (capabilities, retrieve, store, extract, trace, inject, manage)
- Wire stewardship into CLI entry point
- Update 4 spec-driven skills with stewardship references (inject mode, richer domains, context sections)
- Update template skills and agent guidance
- Fix all tests for MCP removal

-1796 lines, +216 lines. 157 tests passing.

Author: lindoelio

.changeset/release-0-11-0.json

@@ -0,0 +1,8 @@
+{
+  "packages": {
+    "spec-driven-steroids": {
+      "version": "0.11.0",
+      "type": "minor"
+    }
+  }
+}

packages/cli/src/cli/antigravity-scope.ts

@@ -1,95 +1,39 @@
 import os from "os"
 import path from "path"
 
-/**
- * Injection scope options for Gemini CLI platform.
- */
 export enum GeminiCliInjectionScope {
   USER = "user",
   PROJECT = "project",
 }
 
-/**
- * Result of Gemini CLI injection operation.
- */
-export interface GeminiCliInjectionResult {
-  scope: GeminiCliInjectionScope
-  mcpConfigPath: string
-  skillsPath: string
-  templatesCopied: boolean
-}
-
-/**
- * Returns the Gemini CLI global settings file path.
- * MCP servers are configured under mcpServers in ~/.gemini/settings.json.
- */
-export function getGeminiCliGlobalMcpPath(): string {
-  return path.join(os.homedir(), ".gemini", "settings.json")
-}
-
-/**
- * Returns the Gemini CLI global configuration directory path.
- */
 export function getGeminiCliGlobalConfigDir(): string {
   return path.join(os.homedir(), ".gemini")
 }
 
-/**
- * Returns the Gemini CLI user-level skills directory.
- * Skills are stored in ~/.gemini/skills/ for user-level access.
- */
 export function getGeminiCliUserSkillsDir(): string {
   return path.join(os.homedir(), ".gemini", "skills")
 }
 
-/**
- * Returns the Gemini CLI agents alias directory.
- * This is an alternative location some Gemini CLI versions check.
- */
 export function getGeminiCliAgentsAliasDir(): string {
   return path.join(os.homedir(), ".agents", "skills")
 }
 
-/**
- * Returns the Gemini CLI project-level skills directory path.
- */
 export function getGeminiCliProjectSkillsDir(targetDir: string): string {
   return path.join(targetDir, ".gemini", "skills")
 }
 
-/**
- * Returns the Gemini CLI project-level settings file path.
- */
-export function getGeminiCliProjectMcpPath(targetDir: string): string {
-  return path.join(targetDir, ".gemini", "settings.json")
-}
-
-/**
- * Returns the Gemini CLI user-level agents directory.
- * Agents are stored in ~/.gemini/agents/ for user-level access.
- */
 export function getGeminiCliUserAgentsDir(): string {
   return path.join(os.homedir(), ".gemini", "agents")
 }
 
-/**
- * Returns the Gemini CLI user-level commands directory.
- * Commands are stored in ~/.gemini/commands/ for user-level access.
- */
 export function getGeminiCliUserCommandsDir(): string {
   return path.join(os.homedir(), ".gemini", "commands")
 }
 
-/**
- * Returns the Gemini CLI project-level agents directory path.
- */
 export function getGeminiCliProjectAgentsDir(targetDir: string): string {
   return path.join(targetDir, ".gemini", "agents")
 }
 
-/**
- * Returns the Gemini CLI project-level commands directory path.
- */
 export function getGeminiCliProjectCommandsDir(targetDir: string): string {
   return path.join(targetDir, ".gemini", "commands")
 }

packages/cli/src/cli/gemini-cli-scope.ts

@@ -1,39 +1,11 @@
 import os from "os"
 import path from "path"
 
-/**
- * Injection scope options for GitHub Copilot CLI platform.
- */
 export enum GitHubCopilotCliInjectionScope {
   USER = "user",
   PROJECT = "project",
 }
 
-/**
- * Result of GitHub Copilot CLI injection operation.
- */
-export interface GitHubCopilotCliInjectionResult {
-  scope: GitHubCopilotCliInjectionScope
-  mcpConfigPath: string
-  skillsPath: string
-  templatesCopied: boolean
-}
-
-/**
- * Returns the GitHub Copilot CLI global MCP configuration file path.
- * Uses ~/.config/github-copilot/mcp.json
- */
-export function getGitHubCopilotCliGlobalMcpPath(): string {
-  if (process.platform === "win32") {
-    const appData = process.env.APPDATA || path.join(os.homedir(), "AppData", "Roaming")
-    return path.join(appData, "github-copilot", "mcp.json")
-  }
-  return path.join(os.homedir(), ".config", "github-copilot", "mcp.json")
-}
-
-/**
- * Returns the GitHub Copilot CLI global configuration directory path.
- */
 export function getGitHubCopilotCliGlobalConfigDir(): string {
   if (process.platform === "win32") {
     const appData = process.env.APPDATA || path.join(os.homedir(), "AppData", "Roaming")
@@ -42,10 +14,6 @@ export function getGitHubCopilotCliGlobalConfigDir(): string {
   return path.join(os.homedir(), ".config", "github-copilot")
 }
 
-/**
- * Returns the GitHub Copilot CLI user-level skills directory.
- * Skills are stored in ~/.copilot/skills/ for user-level access.
- */
 export function getGitHubCopilotCliUserSkillsDir(): string {
   if (process.platform === "win32") {
     const userProfile = process.env.USERPROFILE || os.homedir()
@@ -54,16 +22,6 @@ export function getGitHubCopilotCliUserSkillsDir(): string {
   return path.join(os.homedir(), ".copilot", "skills")
 }
 
-/**
- * Returns the GitHub Copilot CLI project-level skills directory path.
- */
 export function getGitHubCopilotCliProjectSkillsDir(targetDir: string): string {
   return path.join(targetDir, ".github", "skills")
 }
-
-/**
- * Returns the GitHub Copilot CLI project-level MCP configuration file path.
- */
-export function getGitHubCopilotCliProjectMcpPath(targetDir: string): string {
-  return path.join(targetDir, ".github", "mcp.json")
-}

packages/cli/src/cli/github-copilot-cli-scope.ts

@@ -1,51 +1,12 @@
 import os from "os";
 import path from "path";
 
-/**
- * Injection scope options for GitHub Copilot platforms.
- */
 export enum GitHubCopilotInjectionScope {
   PROJECT = "project",
   GLOBAL = "global",
 }
 
-/**
- * Result of GitHub Copilot injection operation.
- */
-export interface GitHubCopilotInjectionResult {
-  scope: GitHubCopilotInjectionScope;
-  mcpConfigPath: string;
-  artifactsPath: string;
-  templatesCopied: boolean;
-}
-
-/**
- * Returns the VS Code user profile MCP configuration file path.
- * On VS Code, global MCP servers are defined in User/mcp.json.
- */
-export function getVSCodeUserProfileMcpPath(): string {
-  if (process.platform === "win32") {
-    const appData =
-      process.env.APPDATA || path.join(os.homedir(), "AppData", "Roaming");
-    return path.join(appData, "Code", "User", "mcp.json");
-  }
-  if (process.platform === "darwin") {
-    return path.join(
-      os.homedir(),
-      "Library",
-      "Application Support",
-      "Code",
-      "User",
-      "mcp.json",
-    );
-  }
-  return path.join(os.homedir(), ".config", "Code", "User", "mcp.json");
-}
-
-/**
- * Returns the VS Code user profile directory.
- */
-export function getVSCodeUserProfileDir(): string {
+function getVSCodeUserProfileDir(): string {
   if (process.platform === "win32") {
     const appData =
       process.env.APPDATA || path.join(os.homedir(), "AppData", "Roaming");
@@ -63,67 +24,14 @@ export function getVSCodeUserProfileDir(): string {
   return path.join(os.homedir(), ".config", "Code", "User");
 }
 
-/**
- * Returns the VS Code global prompts directory for GitHub Copilot.
- * Custom prompts for Chat UI are stored in User/prompts/.
- */
 export function getVSCodeGlobalPromptsDir(): string {
   return path.join(getVSCodeUserProfileDir(), "prompts");
 }
 
-/**
- * Returns the global GitHub Copilot skills directory.
- * Skills are stored in ~/.copilot/skills/ regardless of VS Code platform.
- */
 export function getCopilotGlobalSkillsDir(): string {
   if (process.platform === "win32") {
     const userProfile = process.env.USERPROFILE || os.homedir();
     return path.join(userProfile, ".copilot", "skills");
   }
   return path.join(os.homedir(), ".copilot", "skills");
 }
-
-/**
- * Returns the global GitHub Copilot configuration directory for VS Code.
- * DEPRECATED: This path is no longer used for global Copilot injection.
- * Use getVSCodeGlobalPromptsDir() for prompts and getCopilotGlobalSkillsDir() for skills.
- */
-export function getVSCodeGlobalArtifactsDir(): string {
-  return path.join(
-    getVSCodeUserProfileDir(),
-    "globalStorage",
-    "github.copilot",
-  );
-}
-
-/**
- * Returns the JetBrains global MCP configuration file path.
- * Uses the same path as the existing JetBrains MCP configuration.
- */
-export function getJetBrainsGlobalMcpPath(): string {
-  if (process.platform === "win32") {
-    const localAppData =
-      process.env.LOCALAPPDATA || path.join(os.homedir(), "AppData", "Local");
-    return path.join(localAppData, "github-copilot", "intellij", "mcp.json");
-  }
-  return path.join(
-    os.homedir(),
-    ".config",
-    "github-copilot",
-    "intellij",
-    "mcp.json",
-  );
-}
-
-/**
- * Scope selection prompt options for inquirer.
- */
-export const GITHUB_SCOPE_PROMPT_OPTIONS = [
-  { name: "Global (recommended)", value: GitHubCopilotInjectionScope.GLOBAL },
-  { name: "Project-level", value: GitHubCopilotInjectionScope.PROJECT },
-];
-
-/**
- * Default injection scope for GitHub Copilot platforms.
- */
-export const DEFAULT_GITHUB_SCOPE = GitHubCopilotInjectionScope.GLOBAL;