vectorforce 0.3.2 → 0.3.3

package/CHANGELOG.md

@@ -7,6 +7,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [0.3.2] - 2026-11-01
+
+### Added
+- **First-Class Support for 4 Additional AI Harnesses**:
+  - **Cursor IDE**: Added automated configuration for `.cursor/mcp.json` and `.cursorrules` in `HarnessConfig.installCursor`.
+  - **Windsurf (Codeium Cascade)**: Added automated configuration for `.windsurf/mcp_config.json` and `.windsurfrules` in `HarnessConfig.installWindsurf`.
+  - **GitHub Copilot / VS Code**: Added automated workspace configuration for `.vscode/mcp.json` and `.github/copilot-instructions.md` in `HarnessConfig.installCopilot`.
+  - **Kiro IDE**: Added automated configuration for `.kiro/mcp.json`, `kiro.json`, and `.kiro/rules.md` in `HarnessConfig.installKiro`.
+- **Harness Policy & Tool Schema Expansion**:
+  - Updated `APPROVED_DESTINATIONS` in `Authorizer` to approve `cursor`, `windsurf`, `github-copilot`, `copilot`, `kiro`, and `kiro-ide`.
+  - Updated MCP tool schemas for `get_resume_briefing`, `export_handoff`, `get_timeline`, and `reason_about_task` to accept all newly supported harnesses.
+- **Universal MCP Configuration Guide in Documentation**:
+  - Added dedicated installation instructions to `README.md` for Cline / Roo Code, Zed Editor, JetBrains IDEs (IntelliJ, WebStorm, PyCharm), Sourcegraph Cody, Aider, and generic stdio MCP clients.
+- **Comprehensive Unit & Security Test Coverage**:
+  - Added automated reversible install/uninstall tests for Cursor, Windsurf, GitHub Copilot, and Kiro IDE (test suite expanded to 79 tests).
+
+### Changed
+- `vf init`, `vf config install all`, `vf config doctor`, and `vf status` now inspect and provision all 9 AI coding harnesses.
+- Pruned `package.json` package `files` whitelist to strictly include runtime artifacts (`bin/`, `src/`, `studio/dist/`, `CHANGELOG.md`, `LICENSE`, `README.md`).
+
+---
+
 ## [0.2.0] - 2026-10-31
 
 ### Added

package/README.md

@@ -137,7 +137,7 @@ node bin/vf.js studio
 
 ## Model Context Protocol (MCP)
 
-VectorForce exposes a standard stdio JSON-RPC MCP server for direct integration into **Google Antigravity**, **Claude Code**, **Command Code**, **Meta Muse**, and **OpenAI Codex**.
+VectorForce exposes a standard stdio JSON-RPC MCP server for direct integration into **Google Antigravity**, **Claude Code**, **Command Code**, **Meta Muse**, **OpenAI Codex**, **Cursor**, **Windsurf**, **GitHub Copilot**, and **Kiro IDE**.
 
 > **How MCP Starts:** You **never** need to run `vf mcp` manually in a terminal. Each AI coding agent reads its configuration file below and automatically spawns VectorForce in the background over `stdio`.
 
@@ -148,17 +148,21 @@ VectorForce exposes a standard stdio JSON-RPC MCP server for direct integration
 | **Command Code (`cmd`)** | `.mcp.json` & `commandcode.json` | `node bin/vf.js config install command-code` |
 | **Meta Muse (`muse`)** | `.muse/mcp_config.json` & `~/.config/muse/settings.json` | `node bin/vf.js config install muse` |
 | **OpenAI Codex (`codex`)** | `.codex/config.toml` & `~/.codex/config.toml` | `node bin/vf.js config install codex` |
+| **Cursor IDE** | `.cursor/mcp.json` & `.cursorrules` | `node bin/vf.js config install cursor` |
+| **Windsurf (Codeium)** | `.windsurf/mcp_config.json` & `.windsurfrules` | `node bin/vf.js config install windsurf` |
+| **GitHub Copilot / VS Code** | `.vscode/mcp.json` & `.github/copilot-instructions.md` | `node bin/vf.js config install copilot` |
+| **Kiro IDE** | `.kiro/mcp.json` & `kiro.json` | `node bin/vf.js config install kiro` |
 
 ### Automated Configuration & Health Check
 ```bash
-# Auto-configure all supported AI harnesses at once:
+# Auto-configure all 9 supported AI harnesses at once:
 node bin/vf.js config install all
 
 # Verify SQLite DB, AGENTS.md, and all MCP client configs:
 node bin/vf.js status
 ```
 
-### JSON Configuration (Antigravity, Claude Code, Command Code, Muse)
+### JSON Configuration (Antigravity, Claude Code, Command Code, Muse, Cursor, Windsurf, VS Code, Kiro)
 ```json
 {
   "mcpServers": {
@@ -179,6 +183,96 @@ args = ["/absolute/path/to/VectorForce/bin/vf.js", "mcp"]
 VF_HARNESS = "codex"
 ```
 
+---
+
+## How to Configure & Update MCP for Any Other AI Coding Harness
+
+If your AI assistant or IDE is not in the auto-configured list above, you can connect it to VectorForce in seconds using standard MCP configuration:
+
+### 1. Cline & Roo Code (VS Code Extension)
+Open VS Code Settings or click the **MCP** icon in the Cline panel:
+- Open `cline_mcp_settings.json` (or `roo-cline_mcp_settings.json`) located at:
+  - **macOS:** `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
+  - **Linux:** `~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
+  - **Windows:** `%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
+- Add the VectorForce entry:
+```json
+{
+  "mcpServers": {
+    "vectorforce": {
+      "command": "npx",
+      "args": ["-y", "vectorforce", "mcp"],
+      "disabled": false,
+      "autoApprove": [
+        "list_tasks",
+        "check_workspace_drift",
+        "get_resume_briefing",
+        "save_checkpoint",
+        "reason_about_task"
+      ]
+    }
+  }
+}
+```
+
+### 2. Zed Editor
+Zed natively supports MCP context servers. Open your Zed configuration (`~/.config/zed/settings.json` or `cmd-,`):
+```json
+{
+  "context_servers": {
+    "vectorforce": {
+      "command": {
+        "path": "npx",
+        "args": ["-y", "vectorforce", "mcp"]
+      }
+    }
+  }
+}
+```
+
+### 3. JetBrains IDEs (IntelliJ IDEA, WebStorm, PyCharm, RustRover)
+For JetBrains IDEs supporting MCP or AI Assistant:
+1. Open **Settings / Preferences** (`Ctrl+Alt+S` or `Cmd+,`).
+2. Search for **Model Context Protocol** or **AI Assistant → Context Providers**.
+3. Click **Add Stdio Server**:
+   - **Name:** `vectorforce`
+   - **Command:** `node` (or `npx`)
+   - **Arguments:** `/path/to/VectorForce/bin/vf.js mcp` (or `-y vectorforce mcp`)
+   - **Environment Variables:** `VF_HARNESS=jetbrains`
+
+### 4. Sourcegraph Cody
+In Sourcegraph Cody settings (`cody.experimental.mcp.servers` in VS Code or JetBrains):
+```json
+{
+  "cody.experimental.mcp.servers": {
+    "vectorforce": {
+      "command": "node",
+      "args": ["/path/to/VectorForce/bin/vf.js", "mcp"]
+    }
+  }
+}
+```
+
+### 5. Aider (`aider-chat`)
+Aider integrates directly with Git and can ingest VectorForce's immutable architectural briefings:
+```bash
+# Pipe VectorForce briefing directly to Aider on session start:
+node bin/vf.js resume --task <task_id> --dest cli --raw | aider
+
+# Or generate project conventions before running aider:
+node bin/vf.js resume --task <task_id> --dest cli --raw > CONVENTIONS.md
+aider
+```
+
+### 6. Generic MCP Client (Any Tool Speaking JSON-RPC 2.0 over Stdio)
+For any agent running locally, pass:
+- **Executable:** `node`
+- **Arguments:** `["/path/to/bin/vf.js", "mcp"]`
+- **Working Directory:** Path to your project workspace
+- **Environment:** `VF_WORKSPACE=/path/to/project` (optional if working directory matches)
+
+Whenever you update VectorForce (`npm update -g vectorforce`), simply restart your AI agent or IDE window to immediately use the latest MCP tools.
+
 ### Available MCP Tools
 | Tool | Purpose |
 |---|---|

package/bin/vf.js

@@ -334,11 +334,15 @@ async function main() {
         HarnessConfig.installCommandCode(cwd);
         HarnessConfig.installMuseCode(cwd);
         HarnessConfig.installCodex(cwd);
+        HarnessConfig.installCursor(cwd);
+        HarnessConfig.installWindsurf(cwd);
+        HarnessConfig.installCopilot(cwd);
+        HarnessConfig.installKiro(cwd);
         const agentsMdPath = join(cwd, 'AGENTS.md');
         if (!existsSync(agentsMdPath)) {
           writeFileSync(
             agentsMdPath,
-            `# Agent Continuity Protocol — ${project.name}\n\nThis repository uses **VectorForce** ("Git for AI Context") across Google Antigravity, Meta Muse, Claude Code, Command Code, and OpenAI Codex.\n\n## Workflow\n1. **Start/Resume Task**: Run \`vf tasks active\`, \`vf drift --task <id>\`, and \`vf resume --task <id> --dest <harness>\` (or MCP tools \`list_tasks\`, \`check_workspace_drift\`, \`get_resume_briefing\`, \`reason_about_task\`).\n2. **Save Checkpoint Before Switching IDE**: Run \`vf checkpoint --task <id> --summary "<summary>" --goal "<goal>" --constraint "<constraint>" --decision "<ID>:<Title>:<Rationale>" --next "<next>" --doc "AGENTS.md"\` (or MCP tool \`save_checkpoint\`).\n`,
+            `# Agent Continuity Protocol — ${project.name}\n\nThis repository uses **VectorForce** ("Git for AI Context") across Google Antigravity, Meta Muse, Claude Code, Command Code, OpenAI Codex, Cursor, Windsurf, GitHub Copilot, and Kiro IDE.\n\n## Workflow\n1. **Start/Resume Task**: Run \`vf tasks active\`, \`vf drift --task <id>\`, and \`vf resume --task <id> --dest <harness>\` (or MCP tools \`list_tasks\`, \`check_workspace_drift\`, \`get_resume_briefing\`, \`reason_about_task\`).\n2. **Save Checkpoint Before Switching IDE**: Run \`vf checkpoint --task <id> --summary "<summary>" --goal "<goal>" --constraint "<constraint>" --decision "<ID>:<Title>:<Rationale>" --next "<next>" --doc "AGENTS.md"\` (or MCP tool \`save_checkpoint\`).\n`,
             'utf8'
           );
         }
@@ -582,6 +586,22 @@ async function main() {
             const p = HarnessConfig.installCodex(cwd);
             installed.push(`Codex -> ${p} (+ ~/.codex/config.toml)`);
           }
+          if (target === 'cursor' || target === 'all') {
+            const p = HarnessConfig.installCursor(cwd);
+            installed.push(`Cursor -> ${p} (+ .cursorrules)`);
+          }
+          if (target === 'windsurf' || target === 'all') {
+            const p = HarnessConfig.installWindsurf(cwd);
+            installed.push(`Windsurf -> ${p} (+ .windsurfrules)`);
+          }
+          if (target === 'copilot' || target === 'github-copilot' || target === 'vscode' || target === 'all') {
+            const p = HarnessConfig.installCopilot(cwd);
+            installed.push(`GitHub Copilot / VS Code -> ${p} (+ .github/copilot-instructions.md)`);
+          }
+          if (target === 'kiro' || target === 'kiro-ide' || target === 'all') {
+            const p = HarnessConfig.installKiro(cwd);
+            installed.push(`Kiro IDE -> ${p} (+ kiro.json)`);
+          }
           console.log(`\n✔ Configured harness integration(s):\n  - ${installed.join('\n  - ')}`);
           console.log(`\n💡 Next step: Restart or reload your AI agent, then ask in chat:\n   "List active VectorForce tasks and check workspace drift"`);
           break;
@@ -594,7 +614,11 @@ async function main() {
             { name: 'Google Antigravity (.agents/mcp_config.json)', ok: existsSync(join(cwd, '.agents', 'mcp_config.json')), path: join(cwd, '.agents', 'mcp_config.json') },
             { name: 'Claude Code & Command Code (.mcp.json)', ok: existsSync(join(cwd, '.mcp.json')), path: join(cwd, '.mcp.json') },
             { name: 'Meta Muse (.muse/mcp_config.json)', ok: existsSync(join(cwd, '.muse', 'mcp_config.json')), path: join(cwd, '.muse', 'mcp_config.json') },
-            { name: 'OpenAI Codex (.codex/config.toml)', ok: existsSync(join(cwd, '.codex', 'config.toml')), path: join(cwd, '.codex', 'config.toml') }
+            { name: 'OpenAI Codex (.codex/config.toml)', ok: existsSync(join(cwd, '.codex', 'config.toml')), path: join(cwd, '.codex', 'config.toml') },
+            { name: 'Cursor (.cursor/mcp.json)', ok: existsSync(join(cwd, '.cursor', 'mcp.json')), path: join(cwd, '.cursor', 'mcp.json') },
+            { name: 'Windsurf (.windsurf/mcp_config.json)', ok: existsSync(join(cwd, '.windsurf', 'mcp_config.json')), path: join(cwd, '.windsurf', 'mcp_config.json') },
+            { name: 'GitHub Copilot / VS Code (.vscode/mcp.json)', ok: existsSync(join(cwd, '.vscode', 'mcp.json')), path: join(cwd, '.vscode', 'mcp.json') },
+            { name: 'Kiro IDE (.kiro/mcp.json)', ok: existsSync(join(cwd, '.kiro', 'mcp.json')), path: join(cwd, '.kiro', 'mcp.json') }
           ];
           console.log(`\nVectorForce Workspace & MCP Health Check (${cwd}):\n`);
           for (const c of checks) {
@@ -621,6 +645,18 @@ async function main() {
           if (target === 'codex' || target === 'all') {
             if (HarnessConfig.uninstallCodex(cwd)) uninstalled.push('Codex');
           }
+          if (target === 'cursor' || target === 'all') {
+            if (HarnessConfig.uninstallCursor(cwd)) uninstalled.push('Cursor');
+          }
+          if (target === 'windsurf' || target === 'all') {
+            if (HarnessConfig.uninstallWindsurf(cwd)) uninstalled.push('Windsurf');
+          }
+          if (target === 'copilot' || target === 'github-copilot' || target === 'vscode' || target === 'all') {
+            if (HarnessConfig.uninstallCopilot(cwd)) uninstalled.push('GitHub Copilot / VS Code');
+          }
+          if (target === 'kiro' || target === 'kiro-ide' || target === 'all') {
+            if (HarnessConfig.uninstallKiro(cwd)) uninstalled.push('Kiro IDE');
+          }
           console.log(`\n✔ Removed harness integration(s): ${uninstalled.length ? uninstalled.join(', ') : 'none found'}`);
           break;
         }
@@ -1101,7 +1137,11 @@ VectorForce Harness Configuration:
           { name: 'Google Antigravity (.agents/mcp_config.json)', ok: existsSync(join(cwd, '.agents', 'mcp_config.json')) },
           { name: 'Claude Code & Command Code (.mcp.json)', ok: existsSync(join(cwd, '.mcp.json')) },
           { name: 'Meta Muse (.muse/mcp_config.json or musecode.json)', ok: existsSync(join(cwd, '.muse', 'mcp_config.json')) || existsSync(join(cwd, 'musecode.json')) },
-          { name: 'OpenAI Codex (.codex/config.toml)', ok: existsSync(join(cwd, '.codex', 'config.toml')) }
+          { name: 'OpenAI Codex (.codex/config.toml)', ok: existsSync(join(cwd, '.codex', 'config.toml')) },
+          { name: 'Cursor (.cursor/mcp.json)', ok: existsSync(join(cwd, '.cursor', 'mcp.json')) },
+          { name: 'Windsurf (.windsurf/mcp_config.json)', ok: existsSync(join(cwd, '.windsurf', 'mcp_config.json')) },
+          { name: 'GitHub Copilot / VS Code (.vscode/mcp.json)', ok: existsSync(join(cwd, '.vscode', 'mcp.json')) },
+          { name: 'Kiro IDE (.kiro/mcp.json)', ok: existsSync(join(cwd, '.kiro', 'mcp.json')) }
         ];
         console.log(`\nVectorForce Workspace & MCP Status (${cwd}):\n`);
         for (const c of checks) {
@@ -1109,7 +1149,7 @@ VectorForce Harness Configuration:
         }
         console.log(`\n💡 How it works:`);
         console.log(`  1. You do NOT need to run "vf mcp" manually.`);
-        console.log(`  2. Your AI agent (Antigravity, Claude Code, Command Code, Muse, Codex) reads its config file above and automatically spawns "vf mcp" over stdio.`);
+        console.log(`  2. Your AI agent (Antigravity, Claude Code, Command Code, Muse, Codex, Cursor, Windsurf, Copilot, Kiro) reads its config file above and automatically spawns "vf mcp" over stdio.`);
         console.log(`  3. To verify in your AI chat, ask: "List active VectorForce tasks and check workspace drift"\n`);
         break;
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vectorforce",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Portable engineering context platform - Git for AI context",
   "type": "module",
   "main": "src/index.js",

package/src/mcp/harness-config.js

@@ -543,4 +543,478 @@ export class HarnessConfig {
 
     return removed;
   }
+
+  // ==========================================
+  // Cursor IDE Integration
+  // ==========================================
+
+  /**
+   * Generate configuration object for Cursor (.cursor/mcp.json).
+   */
+  static getCursorServerEntry() {
+    return {
+      command: 'node',
+      args: [HarnessConfig.getBinPath(), 'mcp'],
+      env: {
+        VF_HARNESS: 'cursor'
+      }
+    };
+  }
+
+  /**
+   * Preview changes to Cursor configuration.
+   * @param {string} workspacePath
+   */
+  static previewCursor(workspacePath) {
+    const dir = join(workspacePath, '.cursor');
+    const filePath = join(dir, 'mcp.json');
+    let current = null;
+    if (existsSync(filePath)) {
+      try {
+        current = JSON.parse(readFileSync(filePath, 'utf8'));
+      } catch {
+        current = {};
+      }
+    }
+    const mergedContent = {
+      ...(current || {}),
+      mcpServers: {
+        ...(current?.mcpServers || {}),
+        vectorforce: HarnessConfig.getCursorServerEntry()
+      }
+    };
+    return {
+      filePath,
+      exists: existsSync(filePath),
+      currentContent: current,
+      mergedContent
+    };
+  }
+
+  /**
+   * Install Cursor MCP configuration and rules reversibly.
+   * @param {string} workspacePath
+   * @returns {string} filePath
+   */
+  static installCursor(workspacePath) {
+    const { filePath, mergedContent } = HarnessConfig.previewCursor(workspacePath);
+    const dir = join(workspacePath, '.cursor');
+    if (!existsSync(dir)) {
+      mkdirSync(dir, { recursive: true, mode: 0o755 });
+    }
+    writeFileSync(filePath, JSON.stringify(mergedContent, null, 2) + '\n', 'utf8');
+
+    // Create .cursorrules if missing
+    const cursorRulesPath = join(workspacePath, '.cursorrules');
+    if (!existsSync(cursorRulesPath)) {
+      writeFileSync(
+        cursorRulesPath,
+        `# VectorForce Agent Protocol (Cursor)\n\nThis workspace uses VectorForce for architectural continuity and drift verification.\n- Check active tasks & drift: Use MCP tools 'list_tasks' & 'check_workspace_drift'\n- Retrieve briefing: Use MCP tool 'get_resume_briefing'\n- Save checkpoint: Use MCP tool 'save_checkpoint'\n`,
+        'utf8'
+      );
+    }
+
+    if (!isTempWorkspace(workspacePath)) {
+      try {
+        const globalCursorDir = join(homedir(), '.cursor');
+        if (existsSync(globalCursorDir)) {
+          const globalMcpPath = join(globalCursorDir, 'mcp.json');
+          let globalConfig = {};
+          if (existsSync(globalMcpPath)) {
+            try {
+              globalConfig = JSON.parse(readFileSync(globalMcpPath, 'utf8'));
+            } catch {
+              globalConfig = {};
+            }
+          }
+          globalConfig.mcpServers = {
+            ...(globalConfig.mcpServers || {}),
+            vectorforce: {
+              command: 'node',
+              args: [HarnessConfig.getBinPath(), 'mcp', '--workspace', workspacePath],
+              env: {
+                VF_WORKSPACE: workspacePath,
+                VF_HARNESS: 'cursor'
+              }
+            }
+          };
+          writeFileSync(globalMcpPath, JSON.stringify(globalConfig, null, 2) + '\n', 'utf8');
+        }
+      } catch {}
+    }
+
+    return filePath;
+  }
+
+  /**
+   * Reversibly uninstall VectorForce from Cursor configuration.
+   * @param {string} workspacePath
+   * @returns {boolean} whether removed
+   */
+  static uninstallCursor(workspacePath) {
+    const filePath = join(workspacePath, '.cursor', 'mcp.json');
+    let removed = false;
+    if (existsSync(filePath)) {
+      try {
+        const config = JSON.parse(readFileSync(filePath, 'utf8'));
+        if (config?.mcpServers?.vectorforce) {
+          delete config.mcpServers.vectorforce;
+          writeFileSync(filePath, JSON.stringify(config, null, 2) + '\n', 'utf8');
+          removed = true;
+        }
+      } catch {}
+    }
+    return removed;
+  }
+
+  // ==========================================
+  // Windsurf Cascade Integration
+  // ==========================================
+
+  /**
+   * Generate configuration object for Windsurf (.windsurf/mcp_config.json).
+   */
+  static getWindsurfServerEntry() {
+    return {
+      command: 'node',
+      args: [HarnessConfig.getBinPath(), 'mcp'],
+      env: {
+        VF_HARNESS: 'windsurf'
+      }
+    };
+  }
+
+  /**
+   * Preview changes to Windsurf configuration.
+   * @param {string} workspacePath
+   */
+  static previewWindsurf(workspacePath) {
+    const dir = join(workspacePath, '.windsurf');
+    const filePath = join(dir, 'mcp_config.json');
+    let current = null;
+    if (existsSync(filePath)) {
+      try {
+        current = JSON.parse(readFileSync(filePath, 'utf8'));
+      } catch {
+        current = {};
+      }
+    }
+    const mergedContent = {
+      ...(current || {}),
+      mcpServers: {
+        ...(current?.mcpServers || {}),
+        vectorforce: HarnessConfig.getWindsurfServerEntry()
+      }
+    };
+    return {
+      filePath,
+      exists: existsSync(filePath),
+      currentContent: current,
+      mergedContent
+    };
+  }
+
+  /**
+   * Install Windsurf MCP configuration and rules reversibly.
+   * @param {string} workspacePath
+   * @returns {string} filePath
+   */
+  static installWindsurf(workspacePath) {
+    const { filePath, mergedContent } = HarnessConfig.previewWindsurf(workspacePath);
+    const dir = join(workspacePath, '.windsurf');
+    if (!existsSync(dir)) {
+      mkdirSync(dir, { recursive: true, mode: 0o755 });
+    }
+    writeFileSync(filePath, JSON.stringify(mergedContent, null, 2) + '\n', 'utf8');
+
+    // Create .windsurfrules if missing
+    const windsurfRulesPath = join(workspacePath, '.windsurfrules');
+    if (!existsSync(windsurfRulesPath)) {
+      writeFileSync(
+        windsurfRulesPath,
+        `# VectorForce Agent Protocol (Windsurf Cascade)\n\nThis workspace uses VectorForce for architectural continuity and drift verification.\n- Check tasks & drift: Call MCP tools 'list_tasks' and 'check_workspace_drift'\n- Resume briefing: Call MCP tool 'get_resume_briefing'\n- Save checkpoint: Call MCP tool 'save_checkpoint'\n`,
+        'utf8'
+      );
+    }
+
+    if (!isTempWorkspace(workspacePath)) {
+      try {
+        const globalWindsurfDir = join(homedir(), '.codeium', 'windsurf');
+        if (existsSync(globalWindsurfDir)) {
+          const globalMcpPath = join(globalWindsurfDir, 'mcp_config.json');
+          let globalConfig = {};
+          if (existsSync(globalMcpPath)) {
+            try {
+              globalConfig = JSON.parse(readFileSync(globalMcpPath, 'utf8'));
+            } catch {
+              globalConfig = {};
+            }
+          }
+          globalConfig.mcpServers = {
+            ...(globalConfig.mcpServers || {}),
+            vectorforce: {
+              command: 'node',
+              args: [HarnessConfig.getBinPath(), 'mcp', '--workspace', workspacePath],
+              env: {
+                VF_WORKSPACE: workspacePath,
+                VF_HARNESS: 'windsurf'
+              }
+            }
+          };
+          writeFileSync(globalMcpPath, JSON.stringify(globalConfig, null, 2) + '\n', 'utf8');
+        }
+      } catch {}
+    }
+
+    return filePath;
+  }
+
+  /**
+   * Reversibly uninstall VectorForce from Windsurf configuration.
+   * @param {string} workspacePath
+   * @returns {boolean} whether removed
+   */
+  static uninstallWindsurf(workspacePath) {
+    const filePath = join(workspacePath, '.windsurf', 'mcp_config.json');
+    let removed = false;
+    if (existsSync(filePath)) {
+      try {
+        const config = JSON.parse(readFileSync(filePath, 'utf8'));
+        if (config?.mcpServers?.vectorforce) {
+          delete config.mcpServers.vectorforce;
+          writeFileSync(filePath, JSON.stringify(config, null, 2) + '\n', 'utf8');
+          removed = true;
+        }
+      } catch {}
+    }
+    return removed;
+  }
+
+  // ==========================================
+  // GitHub Copilot & VS Code Integration
+  // ==========================================
+
+  /**
+   * Generate configuration object for VS Code / GitHub Copilot (.vscode/mcp.json).
+   */
+  static getCopilotServerEntry() {
+    return {
+      command: 'node',
+      args: [HarnessConfig.getBinPath(), 'mcp'],
+      env: {
+        VF_HARNESS: 'copilot'
+      }
+    };
+  }
+
+  /**
+   * Preview changes to Copilot / VS Code configuration.
+   * @param {string} workspacePath
+   */
+  static previewCopilot(workspacePath) {
+    const dir = join(workspacePath, '.vscode');
+    const filePath = join(dir, 'mcp.json');
+    let current = null;
+    if (existsSync(filePath)) {
+      try {
+        current = JSON.parse(readFileSync(filePath, 'utf8'));
+      } catch {
+        current = {};
+      }
+    }
+    const mergedContent = {
+      ...(current || {}),
+      mcpServers: {
+        ...(current?.mcpServers || {}),
+        vectorforce: HarnessConfig.getCopilotServerEntry()
+      }
+    };
+    return {
+      filePath,
+      exists: existsSync(filePath),
+      currentContent: current,
+      mergedContent
+    };
+  }
+
+  /**
+   * Install GitHub Copilot workspace instructions & VS Code MCP configuration.
+   * @param {string} workspacePath
+   * @returns {string} filePath
+   */
+  static installCopilot(workspacePath) {
+    const { filePath, mergedContent } = HarnessConfig.previewCopilot(workspacePath);
+    const vscodeDir = join(workspacePath, '.vscode');
+    if (!existsSync(vscodeDir)) {
+      mkdirSync(vscodeDir, { recursive: true, mode: 0o755 });
+    }
+    writeFileSync(filePath, JSON.stringify(mergedContent, null, 2) + '\n', 'utf8');
+
+    // Create .github/copilot-instructions.md if missing
+    const githubDir = join(workspacePath, '.github');
+    if (!existsSync(githubDir)) {
+      mkdirSync(githubDir, { recursive: true, mode: 0o755 });
+    }
+    const copilotMdPath = join(githubDir, 'copilot-instructions.md');
+    if (!existsSync(copilotMdPath)) {
+      writeFileSync(
+        copilotMdPath,
+        `# VectorForce Context Protocol (GitHub Copilot)\n\nThis workspace uses VectorForce for architectural continuity and drift protection.\n- Architectural decisions (ADRs) and invariant constraints are tracked in VectorForce.\n- Check tasks and drift via VectorForce MCP or \`node bin/vf.js drift\`.\n- Always capture progress with \`node bin/vf.js checkpoint\`.\n`,
+        'utf8'
+      );
+    }
+
+    return filePath;
+  }
+
+  /**
+   * Reversibly uninstall VectorForce from Copilot / VS Code configuration.
+   * @param {string} workspacePath
+   * @returns {boolean} whether removed
+   */
+  static uninstallCopilot(workspacePath) {
+    const filePath = join(workspacePath, '.vscode', 'mcp.json');
+    let removed = false;
+    if (existsSync(filePath)) {
+      try {
+        const config = JSON.parse(readFileSync(filePath, 'utf8'));
+        if (config?.mcpServers?.vectorforce) {
+          delete config.mcpServers.vectorforce;
+          writeFileSync(filePath, JSON.stringify(config, null, 2) + '\n', 'utf8');
+          removed = true;
+        }
+      } catch {}
+    }
+    return removed;
+  }
+
+  // ==========================================
+  // Kiro IDE Integration
+  // ==========================================
+
+  /**
+   * Generate configuration object for Kiro IDE (.kiro/mcp.json).
+   */
+  static getKiroServerEntry() {
+    return {
+      command: 'node',
+      args: [HarnessConfig.getBinPath(), 'mcp'],
+      env: {
+        VF_HARNESS: 'kiro'
+      }
+    };
+  }
+
+  /**
+   * Preview changes to Kiro IDE configuration.
+   * @param {string} workspacePath
+   */
+  static previewKiro(workspacePath) {
+    const dir = join(workspacePath, '.kiro');
+    const filePath = join(dir, 'mcp.json');
+    const kiroJsonPath = join(workspacePath, 'kiro.json');
+
+    let current = null;
+    if (existsSync(filePath)) {
+      try {
+        current = JSON.parse(readFileSync(filePath, 'utf8'));
+      } catch {
+        current = {};
+      }
+    }
+    const mergedContent = {
+      ...(current || {}),
+      mcpServers: {
+        ...(current?.mcpServers || {}),
+        vectorforce: HarnessConfig.getKiroServerEntry()
+      }
+    };
+
+    let currentKiroJson = null;
+    if (existsSync(kiroJsonPath)) {
+      try {
+        currentKiroJson = JSON.parse(readFileSync(kiroJsonPath, 'utf8'));
+      } catch {
+        currentKiroJson = {};
+      }
+    }
+    const mergedKiroJson = {
+      ...(currentKiroJson || {}),
+      mcpServers: {
+        ...(currentKiroJson?.mcpServers || {}),
+        vectorforce: HarnessConfig.getKiroServerEntry()
+      }
+    };
+
+    return {
+      filePath,
+      kiroJsonPath,
+      exists: existsSync(filePath) || existsSync(kiroJsonPath),
+      currentContent: current,
+      mergedContent,
+      mergedKiroJson
+    };
+  }
+
+  /**
+   * Install Kiro IDE MCP configuration and rules reversibly.
+   * @param {string} workspacePath
+   * @returns {string} filePath
+   */
+  static installKiro(workspacePath) {
+    const { filePath, kiroJsonPath, mergedContent, mergedKiroJson } = HarnessConfig.previewKiro(workspacePath);
+    const dir = join(workspacePath, '.kiro');
+    if (!existsSync(dir)) {
+      mkdirSync(dir, { recursive: true, mode: 0o755 });
+    }
+    writeFileSync(filePath, JSON.stringify(mergedContent, null, 2) + '\n', 'utf8');
+    writeFileSync(kiroJsonPath, JSON.stringify(mergedKiroJson, null, 2) + '\n', 'utf8');
+
+    // Create .kiro/rules.md if missing
+    const rulesPath = join(dir, 'rules.md');
+    if (!existsSync(rulesPath)) {
+      writeFileSync(
+        rulesPath,
+        `# VectorForce Agent Steering (Kiro IDE)\n\nThis workspace uses VectorForce for architectural continuity and drift prevention.\n- Use VectorForce MCP tools: 'list_tasks', 'check_workspace_drift', 'get_resume_briefing', 'save_checkpoint'.\n- Strictly adhere to invariant constraints and architectural decisions.\n`,
+        'utf8'
+      );
+    }
+
+    return filePath;
+  }
+
+  /**
+   * Reversibly uninstall VectorForce from Kiro IDE configuration.
+   * @param {string} workspacePath
+   * @returns {boolean} whether removed
+   */
+  static uninstallKiro(workspacePath) {
+    const filePath = join(workspacePath, '.kiro', 'mcp.json');
+    const kiroJsonPath = join(workspacePath, 'kiro.json');
+    let removed = false;
+
+    if (existsSync(filePath)) {
+      try {
+        const config = JSON.parse(readFileSync(filePath, 'utf8'));
+        if (config?.mcpServers?.vectorforce) {
+          delete config.mcpServers.vectorforce;
+          writeFileSync(filePath, JSON.stringify(config, null, 2) + '\n', 'utf8');
+          removed = true;
+        }
+      } catch {}
+    }
+
+    if (existsSync(kiroJsonPath)) {
+      try {
+        const config = JSON.parse(readFileSync(kiroJsonPath, 'utf8'));
+        if (config?.mcpServers?.vectorforce) {
+          delete config.mcpServers.vectorforce;
+          writeFileSync(kiroJsonPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
+          removed = true;
+        }
+      } catch {}
+    }
+
+    return removed;
+  }
 }

package/src/mcp/mcp-server.js

@@ -44,7 +44,7 @@ export const MCP_TOOLS = [
         task_id: { type: 'string' },
         checkpoint_id: { type: 'string', description: 'Optional specific checkpoint ID. Defaults to latest head.' },
         max_tokens: { type: 'integer', default: 4000, maximum: 8000 },
-        destination_harness: { type: 'string', enum: ['antigravity', 'command-code', 'muse', 'muse-code', 'pi', 'codex', 'cli'] }
+        destination_harness: { type: 'string', enum: ['antigravity', 'command-code', 'muse', 'muse-code', 'pi', 'codex', 'cli', 'cursor', 'windsurf', 'github-copilot', 'copilot', 'kiro', 'kiro-ide'] }
       }
     }
   },
@@ -91,7 +91,7 @@ export const MCP_TOOLS = [
         task_id: { type: 'string', description: 'Kebab-case task slug' },
         recipient: { type: 'string', description: 'Target developer or audience identity' },
         checkpoint_id: { type: 'string', description: 'Optional specific checkpoint ID to export' },
-        destination_harness: { type: 'string', enum: ['antigravity', 'command-code', 'muse', 'muse-code', 'pi', 'codex', 'cli', 'any'], default: 'any' },
+        destination_harness: { type: 'string', enum: ['antigravity', 'command-code', 'muse', 'muse-code', 'pi', 'codex', 'cli', 'cursor', 'windsurf', 'github-copilot', 'copilot', 'kiro', 'kiro-ide', 'any'], default: 'any' },
         preview: { type: 'boolean', default: false, description: 'Dry run preview without writing file' },
         out_path: { type: 'string', description: 'Optional custom bundle file destination' }
       }
@@ -117,7 +117,7 @@ export const MCP_TOOLS = [
       properties: {
         days: { type: 'integer', default: 7, description: 'Number of past days to include in the recap (defaults to 7)' },
         task_id: { type: 'string', description: 'Optional specific task ID to filter by' },
-        destination_harness: { type: 'string', enum: ['antigravity', 'command-code', 'muse', 'muse-code', 'pi', 'codex', 'cli'] }
+        destination_harness: { type: 'string', enum: ['antigravity', 'command-code', 'muse', 'muse-code', 'pi', 'codex', 'cli', 'cursor', 'windsurf', 'github-copilot', 'copilot', 'kiro', 'kiro-ide'] }
       }
     }
   },
@@ -130,7 +130,7 @@ export const MCP_TOOLS = [
       properties: {
         task_id: { type: 'string', description: 'Kebab-case task slug' },
         checkpoint_id: { type: 'string', description: 'Optional specific checkpoint ID. Defaults to latest head.' },
-        destination_harness: { type: 'string', enum: ['antigravity', 'command-code', 'muse', 'muse-code', 'pi', 'codex', 'cli'] },
+        destination_harness: { type: 'string', enum: ['antigravity', 'command-code', 'muse', 'muse-code', 'pi', 'codex', 'cli', 'cursor', 'windsurf', 'github-copilot', 'copilot', 'kiro', 'kiro-ide'] },
         model: { type: 'string', description: 'Optional model override (e.g. a Meta Llama or Muse model id)' },
         focus: { type: 'string', description: 'Optional question or focus for the reasoning pass' },
         include_code: { type: 'boolean', default: true, description: 'Ground reasoning in the live codebase index' }

package/src/policy/authorizer.js

@@ -5,7 +5,21 @@ import { ErrorCode, VectorForceError } from '../core/errors.js';
 export const MAX_FILE_BYTES = 8192; // 8 KiB per file
 export const MAX_TOTAL_DOCUMENT_BYTES = 65536; // 64 KiB total
 export const ALLOWED_EXTENSIONS = ['.md', '.txt'];
-export const APPROVED_DESTINATIONS = ['antigravity', 'command-code', 'muse', 'muse-code', 'pi', 'codex', 'cli'];
+export const APPROVED_DESTINATIONS = [
+  'antigravity',
+  'command-code',
+  'muse',
+  'muse-code',
+  'pi',
+  'codex',
+  'cli',
+  'cursor',
+  'windsurf',
+  'github-copilot',
+  'copilot',
+  'kiro',
+  'kiro-ide'
+];
 
 export class Authorizer {
   /**