Add windows to platform.

cli/README.md

@@ -18,7 +18,7 @@ Build and test the CLI package:
 cd cli
 npm run build
 npm test                 # unit tests only
-npm run test:integration # host integration tests (macOS + cc)
+npm run test:integration # host integration tests (macOS or Windows)
 npm run test:all         # unit + integration
 ```
 
@@ -27,10 +27,12 @@ npm run test:all         # unit + integration
 | Script | Jest project | Location | Notes |
 | :--- | :--- | :--- | :--- |
 | `npm test` | `unit` | `tests/**/*.test.ts` (excludes `integration/`) | Mocks fs, shell, logger, devices |
-| `npm run test:integration` | `integration` | `tests/integration/**/*.test.ts` | Real host `shell` process; macOS only |
+| `npm run test:integration` | `integration` | `tests/integration/**/*.test.ts` | Real host `shell` process; macOS or Windows (MinGW-w64) |
 | `npm run test:all` | both | — | Run before merging CLI changes |
 
-**Integration test requirements:** macOS, `cc`, and the `microcontroller/` tree at the repository root. On first run, tests build `microcontroller/ports/host/build/shell` and `c-runtime.so` if missing. Tests are skipped automatically on non-macOS platforms.
+**Integration test requirements:** macOS (`cc`) or Windows (MinGW-w64: `gcc`, `mingw32-make`), and the `microcontroller/` tree at the repository root. On first run, tests build `microcontroller/ports/host/build/shell` (or `shell.exe`) and `c-runtime.so` (or `c-runtime.dll`) if missing. Tests are skipped automatically on Linux and other unsupported platforms.
+
+**Supported platforms:** macOS and Windows for `host` and `esp32` board setup. Linux is not supported. On Windows, install the Visual C++ Build Environment before `npm install` (node-gyp), and MinGW-w64 for the host runtime. See [Windows prerequisites](https://csg-tokyo.github.io/bluescript/docs/tutorial/get-started/setup-environment-windows) on the website.
 
 **Integration coverage (14 tests):**
 
@@ -61,7 +63,7 @@ bscript -v
 
 Before merging CLI changes or cutting a release:
 
-1. Run `npm run test:all` (or at least `npm test`; on macOS also `npm run test:integration`).
+1. Run `npm run test:all` (or at least `npm test`; on macOS or Windows also `npm run test:integration`).
 2. Follow the manual QA checklist: **[docs/manual-test.md](./docs/manual-test.md)**
 
 - **Daily PRs:** run automated tests plus **Quick smoke (host)** (~15 minutes).

cli/docs/manual-test.md

@@ -39,18 +39,20 @@ Use a clean working directory for project commands (no existing `bsconfig.json`
 | Profile | OS | Node.js | Additional requirements |
 | :--- | :--- | :--- | :--- |
 | **host** | macOS | v18+ (v20+ recommended) | `cc`, `make` |
-| **esp32** | macOS | v18+ (v20+ recommended) | ESP32 board, USB cable, Bluetooth enabled |
+| **host** | Windows | v18+ (v20+ recommended) | Visual C++ Build Environment (for npm install), MinGW-w64 (`gcc`, `mingw32-make`) |
+| **esp32** | macOS | v18+ (v20+ recommended) | Homebrew, Git, Python 3, ESP32 board, USB cable, Bluetooth enabled |
+| **esp32** | Windows | v18+ (v20+ recommended) | Visual C++ Build Environment (for npm install), Git, Python 3, `make` or `mingw32-make`, ESP32 board, USB cable, Bluetooth enabled |
 
-> **Note:** The host runtime currently requires **macOS**. ESP32 setup is also macOS-only in the current CLI implementation.
+> ESP32 on Windows (setup, flash, BLE `project run`) has been manually verified. Linux is not supported by the CLI.
 
 ### Automated integration tests (host)
 
 Host integration tests live in `cli/tests/integration/`. They spawn the real host `shell` binary and exercise `project run` and `repl` end-to-end on disk (no ESP32, no global `bscript` install).
 
 | Requirement | Detail |
 | :--- | :--- |
-| OS | macOS only (tests are skipped on other platforms) |
-| Toolchain | `cc` (builds `microcontroller/ports/host/build/` on first run if missing) |
+| OS | macOS or Windows (tests are skipped on Linux and other platforms) |
+| Toolchain | macOS: `cc`; Windows: MinGW-w64 (`gcc`, `mingw32-make`). Builds `microcontroller/ports/host/build/` on first run if missing. |
 | Repo layout | Run from `cli/` with the `microcontroller/` tree at the repository root |
 
 ```bash
@@ -65,7 +67,7 @@ CLI log output is suppressed during integration runs (`tests/integration-setup.t
 
 ## Quick smoke (host only, ~15 min)
 
-Run this before merging most CLI PRs. No hardware required.
+Run this before merging most CLI PRs. No hardware required. Run on **macOS** or **Windows** (MinGW-w64 for host). The same steps apply on both platforms.
 
 1. **MT-SMOKE-01** — `bscript -v` prints the expected version
 2. **MT-SMOKE-02** — `bscript board list` shows `esp32` and `host`
@@ -734,11 +736,11 @@ For failures, include the item ID (e.g. `MT-PROJ-RUN-03`) in Notes or link to an
 
 ## Coverage map: automated vs manual
 
-Jest **unit** tests in `cli/tests/` mock filesystem, network, and device I/O. **Integration** tests in `cli/tests/integration/` use real host runtime processes on macOS. Use this table to avoid re-testing automated behavior manually while ensuring gaps are covered.
+Jest **unit** tests in `cli/tests/` mock filesystem, network, and device I/O. **Integration** tests in `cli/tests/integration/` use real host runtime processes on macOS or Windows. Use this table to avoid re-testing automated behavior manually while ensuring gaps are covered.
 
-| Area | Unit tests | Integration tests (host, macOS) | Manual testing still needed |
+| Area | Unit tests | Integration tests (host, macOS/Windows) | Manual testing still needed |
 | :--- | :--- | :--- | :--- |
-| `board setup` | Handler logic, macOS paths, skip-if-done | — | Real download, ESP-IDF install, host runtime build |
+| `board setup` | Handler logic, macOS/Windows paths, skip-if-done | — | Real download, ESP-IDF install, host runtime build |
 | `board flash-runtime` | ESP32 handler, host rejection, port prompt mocked, `deviceName` passed to build | — | Actual USB flash on hardware; BLE advertised name after flash |
 | `board remove` / `fullclean` | File removal, prompts mocked | — | Confirm disk state after real removal |
 | `board update` | Update steps, rollback logic | — | End-to-end after real version bump |

cli/src/commands/board/flash-runtime.ts

@@ -1,18 +1,19 @@
 import { Command } from "commander";
 import inquirer from 'inquirer';
 import * as path from 'path';
+import * as os from 'os';
 import { SerialPort } from 'serialport'
 import { BoardName } from "../../config/board-utils";
 import { logger, runStep } from "../../core/logger";
-import { exec } from '../../core/shell';
+import { execShell } from '../../core/command-exec';
 import chalk from "chalk";
-import { CommandHandler } from "../command";
+import { CommandHandlerWithUpdateCheck } from "../command";
 import { DEFAULT_DEVICE_NAME } from "../../config/project-config";
 
 
 const RUNTIME_ESP_PORT_DIR = (runtimeDir: string) => path.join(runtimeDir, 'ports/esp32');
 
-abstract class FlashRuntimeHandler extends CommandHandler {
+abstract class FlashRuntimeHandler extends CommandHandlerWithUpdateCheck {
     abstract isSetup(): boolean;
     abstract flashRuntime(port: string, deviceName?: string): Promise<void>;
 
@@ -41,11 +42,19 @@ class ESP32FlashRuntimeHandler extends FlashRuntimeHandler {
 
         deviceName = deviceName ?? DEFAULT_DEVICE_NAME;
 
-        await exec(
-            `source ${boardConfig.exportFile} && idf.py -D DEVICE_NAME=${deviceName} build flash -p ${port}`,
-            { cwd: RUNTIME_ESP_PORT_DIR(runtimeDir) }
+        await this.runIdfPy(
+            boardConfig.exportFile,
+            ['-D', `DEVICE_NAME=${deviceName}`, 'build', 'flash', '-p', port],
+            RUNTIME_ESP_PORT_DIR(runtimeDir)
         )
     }
+
+    private async runIdfPy(exportFile: string, args: string[], cwd: string) {
+        const osType = os.platform();
+        const preCommand = osType === 'win32' ? `call ${exportFile}` : `source ${exportFile}`;
+
+        await execShell(`${preCommand} && idf.py ${args.join(' ')}`, { cwd });
+    }
 }
 
 function getFlashRuntimeHandler(board: string) {

cli/src/commands/board/full-clean.ts

@@ -1,20 +1,18 @@
 import { Command } from "commander";
 import inquirer from 'inquirer';
 import { logger } from "../../core/logger";
-import * as fs from '../../core/fs';
 import { CommandHandler } from "../command";
-import { GLOBAL_SETTINGS } from "../../config/constants";
+import { CommonBoardEnv } from "../../platforms/board-env";
 
 
 class FullcleanHandler extends CommandHandler {
     constructor() {
-        super(false);
+        super();
     }
 
     fullclean() {
-        if (fs.exists(GLOBAL_SETTINGS.BLUESCRIPT_DIR)) {
-            fs.removeDir(GLOBAL_SETTINGS.BLUESCRIPT_DIR);
-        }
+        const env = new CommonBoardEnv();
+        env.removeBlueScriptDir();
     }
 }
 

cli/src/commands/board/list.ts

@@ -2,10 +2,10 @@ import { Command } from "commander";
 import chalk from 'chalk';
 import { BOARD_NAMES } from "../../config/board-utils";
 import { logger } from "../../core/logger";
-import { CommandHandler } from "../command";
+import { CommandHandlerWithUpdateCheck } from "../command";
 
 
-class ListHandler extends CommandHandler {
+class ListHandler extends CommandHandlerWithUpdateCheck {
     list() {
         const supportedBoards = BOARD_NAMES;
         logger.log('Available boards:');

cli/src/commands/board/remove.ts

@@ -1,73 +1,38 @@
 import { Command } from "commander";
 import inquirer from 'inquirer';
-import { BoardName } from "../../config/board-utils";
+import { BoardName, isValidBoard } from "../../config/board-utils";
 import { logger, runStep } from "../../core/logger";
-import * as fs from '../../core/fs';
-import { CommandHandler } from "../command";
+import { CommandHandlerWithUpdateCheck } from "../command";
+import { BoardEnv, createBoardEnv } from "../../platforms/board-env";
 
 
-abstract class RemoveHandler extends CommandHandler {
-    async remove() {
-        await runStep('Removing...', () => this.removeBoard());
-        this.globalConfigHandler.save();
-    }
-    abstract isSetup(): boolean;
-    abstract removeBoard(): Promise<void>;
-}
+class RemoveHandler extends CommandHandlerWithUpdateCheck {
+    boardName: BoardName;
+    boardEnv: BoardEnv;
 
-class HostRemoveHandler extends RemoveHandler {
-    readonly boardName: BoardName = 'host';
-
-    isSetup(): boolean {
-        return this.globalConfigHandler.isBoardSetup(this.boardName);
+    constructor(boardName: BoardName) {
+        super();
+        this.boardName = boardName;
+        this.boardEnv = createBoardEnv(boardName);
     }
 
-    async removeBoard() {
-        const boardConfig = this.globalConfigHandler.getBoardConfig('host');
-        if (boardConfig === undefined) {
-            throw new Error(`Cannot find config for ${this.boardName}.`);
-        }
-        if (fs.exists(boardConfig.buildDir)) {
-            fs.removeDir(boardConfig.buildDir);
-        }
-
+    async remove() {
+        await runStep('Removing...', async () => this.boardEnv.removeBoardRoot());
         this.globalConfigHandler.removeBoardConfig(this.boardName);
+        this.globalConfigHandler.save();
     }
-}
-
-class ESP32RemoveHandler extends RemoveHandler {
-    readonly boardName: BoardName = 'esp32';
-
+
     isSetup(): boolean {
         return this.globalConfigHandler.isBoardSetup(this.boardName);
     }
-
-    async removeBoard() {
-        const boardConfig = this.globalConfigHandler.getBoardConfig('esp32');
-        if (boardConfig === undefined) {
-            throw new Error(`Cannot find config for ${this.boardName}.`);
-        }
-        if (fs.exists(boardConfig.rootDir)) {
-            fs.removeDir(boardConfig.rootDir);
-        }
-
-        this.globalConfigHandler.removeBoardConfig(this.boardName);
-    }
-}
-
-function getRemoveHandler(board: string) {
-    if (board === 'esp32') {
-        return new ESP32RemoveHandler();
-    }
-    if (board === 'host') {
-        return new HostRemoveHandler();
-    }
-    throw new Error(`Unsupported board name: ${board}`);
 }
 
 export async function handleRemoveCommand(board: string, options: { force?: boolean }) {
     try {
-        const removeHandler = getRemoveHandler(board);
+        if (!isValidBoard(board)) {
+            throw new Error(`Unsupported board name: ${board}`);
+        }
+        const removeHandler = new RemoveHandler(board);
 
         // Check if setup has already been completed.
         if (!removeHandler.isSetup()) {