Fix Code-OSS setup the right way: Spectre, Node 24.19, VS 2026 patch

Install Spectre-mitigated libs, require Node matching .nvmrc, patch preinstall for VS 2026, and drop ignore-scripts workarounds so native modules build correctly.

Author: Vitor Castro

docs/code-oss-integration.md

@@ -4,7 +4,7 @@
 
 Run OpenCodeIDE as a **branded Code-OSS** with the embedded AI extension loaded.
 
-## Architecture (current)
+## Architecture
 
 ```
 CodeForge/
@@ -13,69 +13,98 @@ CodeForge/
 ├── extensions/opencodeide-ai/   # AI sidebar + VS Code bridge
 ├── src/ai/                      # Embedded AI Platform (shared logic)
 └── scripts/
-    ├── setup-vscode.mjs         # clone + brand + npm install
+    ├── setup-vscode.mjs         # clone + brand + patches + npm install
     ├── apply-branding.mjs       # product.json branding
+    ├── apply-vscode-patches.mjs # VS 2026 toolchain recognition, etc.
     └── dev-vscode.mjs           # launch Code-OSS + extension
 ```
 
+## Prerequisites (Windows)
+
+| Requirement | Details |
+|-------------|---------|
+| **Node.js** | Exact major from `vscode/.nvmrc` (currently **24.x ≥ 24.18.0**). Use [Node.js LTS](https://nodejs.org/) / `winget install OpenJS.NodeJS.LTS` |
+| **npm** | < 13 (comes with Node 24 LTS) |
+| **Python 3** | For node-gyp |
+| **Visual Studio** | C++ desktop workload + **MSVC Spectre-mitigated libs** (x64/x86) |
+
+### Install Spectre libs (required)
+
+Visual Studio Installer → Modify → Individual components → search **Spectre**:
+
+- MSVC v14x - VS 202x C++ x64/x86 Spectre-mitigated libs
+- C++ ATL / MFC Spectre-mitigated libs (if prompted)
+
+Or via elevated installer:
+
+```powershell
+$setup = "${env:ProgramFiles(x86)}\Microsoft Visual Studio\Installer\setup.exe"
+$vs = "C:\Program Files\Microsoft Visual Studio\18\Community"  # adjust path
+Start-Process $setup -Verb RunAs -Wait -ArgumentList @(
+  "modify","--installPath",$vs,
+  "--add","Microsoft.VisualStudio.Component.VC.Runtimes.x86.x64.Spectre",
+  "--add","Microsoft.VisualStudio.Component.VC.ATL.Spectre",
+  "--add","Microsoft.VisualStudio.Component.VC.ATLMFC.Spectre",
+  "--passive","--norestart"
+)
+```
+
+> OpenCodeIDE patches Code-OSS `preinstall.ts` to accept **Visual Studio 2026** (`18`), which upstream does not list yet.
+
 ## One-time setup
 
 ```bash
 npm run vscode:setup
 ```
 
 This will:
+
 1. Clone `microsoft/vscode` into `vscode/` (shallow)
-2. Apply OpenCodeIDE branding to `product.json`
-3. Run `npm install` inside `vscode/` (10–20+ minutes)
+2. Apply OpenCodeIDE branding
+3. Apply toolchain patches (VS 2026)
+4. Run full `npm install` (native modules included)
 
 If Code-OSS is already cloned:
 
 ```bash
 npm run vscode:brand
+node scripts/apply-vscode-patches.mjs
 npm run vscode:install
 ```
 
 ## Develop / launch
 
 ```bash
-# Compile AI extension
-npm run build:extensions
-
-# Compile Code-OSS (first time is slow)
-npm run vscode:compile
-
-# Launch branded IDE with AI extension in development mode
-npm run vscode:dev
+npm run build:extensions   # compile AI extension
+npm run vscode:compile     # compile editor (first time is slow)
+npm run vscode:dev         # launch OpenCodeIDE with AI sidebar
 ```
 
 What you should see:
-- Window title / product name: **OpenCodeIDE**
-- Activity bar: **AI Agent** icon
-- Chat sidebar can run:
-  - `list files`
-  - `read README.md`
-  - `search TODO`
-- Configure LLM: Command Palette → **OpenCodeIDE AI: Configure AI Provider**
-
-## Branding fields applied
-
-| Field | Value |
-|-------|--------|
-| nameShort | OpenCodeIDE |
-| applicationName | opencodeide |
-| dataFolderName | .opencodeide |
-| urlProtocol | opencodeide |
-| darwinBundleIdentifier | com.kortexio.opencodeide |
+
+- Product name: **OpenCodeIDE**
+- Activity bar: **AI Agent**
+- Chat: `list files` · `read README.md` · `search TODO`
+- Command Palette → **OpenCodeIDE AI: Configure AI Provider**
+
+## Scripts
+
+| Script | Purpose |
+|--------|---------|
+| `npm run vscode:setup` | Clone + brand + patch + install |
+| `npm run vscode:brand` | Re-apply product.json branding |
+| `npm run vscode:install` | `npm install` inside `vscode/` |
+| `npm run vscode:compile` | `compile-client` |
+| `npm run vscode:dev` | Launch with `--extensionDevelopmentPath` |
 
 ## Next hardening steps
 
-1. Register `opencodeide-ai` as a **built-in** extension (add to `gulpfile.extensions.ts` compilations)
-2. Replace Electron placeholder packaging with Code-OSS gulp packaging
-3. Wire full Agent Runtime (`src/ai`) into the extension host (not only chat/LLM shortcuts)
-4. Continuous rebase workflow against upstream `microsoft/vscode`
+1. Register `opencodeide-ai` in `gulpfile.extensions.ts` as built-in
+2. Package via Code-OSS gulp (replace Electron placeholder)
+3. Wire full `src/ai` Agent Runtime into the extension host
+4. Continuous rebase against upstream `microsoft/vscode`
 
 ## Notes
 
 - `vscode/` is **not committed** (too large). Use `npm run vscode:setup` on each machine.
-- Upstream Code-OSS uses its own Node/npm toolchain; prefer Node 20 LTS if install fails on newer Node.
+- Do **not** use `--ignore-scripts` for vscode install — native modules must build.

package.json

@@ -50,9 +50,10 @@
     "verify": "npm run build && npm run test:unit",
     "vscode:setup": "node scripts/setup-vscode.mjs",
     "vscode:setup:skip-install": "node scripts/setup-vscode.mjs --skip-install",
-    "vscode:brand": "node scripts/apply-branding.mjs",
+    "vscode:brand": "node scripts/apply-branding.mjs && node scripts/apply-vscode-patches.mjs",
     "vscode:install": "npm --prefix vscode install",
-    "vscode:compile": "npm --prefix vscode run compile",
+    "vscode:compile": "npm --prefix vscode run compile-client",
+    "vscode:compile:all": "npm --prefix vscode run compile",
     "vscode:watch": "npm --prefix vscode run watch",
     "vscode:dev": "node scripts/dev-vscode.mjs",
     "package": "npm run clean && npm run build && electron-builder --dir",

scripts/apply-vscode-patches.mjs

@@ -0,0 +1,44 @@
+/**
+ * Apply OpenCodeIDE patches on top of Code-OSS.
+ * Currently:
+ * - Allow Visual Studio 2026 (folder "18") in Windows toolchain check
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const root = path.resolve(__dirname, '..');
+const preinstallPath = path.join(root, 'vscode', 'build', 'npm', 'preinstall.ts');
+
+if (!fs.existsSync(preinstallPath)) {
+	console.error('vscode/build/npm/preinstall.ts not found. Run vscode setup first.');
+	process.exit(1);
+}
+
+let source = fs.readFileSync(preinstallPath, 'utf8');
+
+const oldVersions = `const supportedVersions = ['2022', '2019'];`;
+const newVersions = `const supportedVersions = ['2022', '2019', '18', '2026'];`;
+
+if (!source.includes(oldVersions) && source.includes(newVersions)) {
+	console.log('VS toolchain patch already applied');
+	process.exit(0);
+}
+
+if (!source.includes(oldVersions)) {
+	console.error('Could not find supportedVersions marker in preinstall.ts — upstream may have changed.');
+	process.exit(1);
+}
+
+source = source.replace(oldVersions, newVersions);
+
+// Also teach the custom-location hint about VS 2026
+source = source.replace(
+	'set vs2022_install=<path> (or vs2019_install for older versions)',
+	'set vs2022_install=<path> (or vs2019_install / vs18_install / vs2026_install)'
+);
+
+fs.writeFileSync(preinstallPath, source, 'utf8');
+console.log('Patched vscode/build/npm/preinstall.ts to accept Visual Studio 2026 (18)');

scripts/setup-vscode.mjs

@@ -38,9 +38,11 @@ if (!fs.existsSync(vscodeDir)) {
 }
 
 run('node', [path.join('scripts', 'apply-branding.mjs')], root);
+run('node', [path.join('scripts', 'apply-vscode-patches.mjs')], root);
 
 if (!skipInstall) {
 	console.log('\nInstalling Code-OSS dependencies (this can take 10–20 minutes)...');
+	console.log('Requires: Node matching vscode/.nvmrc, VS C++ tools + Spectre libs');
 	run('npm', ['install'], vscodeDir);
 } else {
 	console.log('\nSkipped npm install (--skip-install)');