From 82c45420901ec9e11cbc53d7683218d70fdc488c Mon Sep 17 00:00:00 2001
From: KeiSei84 <2206745@gmail.com>
Date: Wed, 27 May 2026 14:46:33 +0800
Subject: [PATCH] docs: Windows native port is demand-driven, not "never"
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

User feedback: "if there's a lot of requests, we'll make a native Windows
version". Soften the "not on the roadmap" framing in both README Platforms
section and bootstrap.sh's bare-Windows guidance.

- README: rephrase to "demand-driven. WSL gives 100% coverage today with
  0 code duplication. If you want a native .ps1 port, open / 👍 an issue.
  Once demand is real, we'll build it."
- bootstrap.sh: same softening — point users to the issues tracker so
  Windows-native demand becomes visible. WSL still recommended as the
  no-wait path that works today.

No version bump (docs-only, behaviour unchanged for all OS paths).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 README.md    | 15 +++++++++++----
 bootstrap.sh |  8 ++++++--
 2 files changed, 17 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 80f7ea4..40ba4a2 100644
--- a/README.md
+++ b/README.md
@@ -57,18 +57,25 @@ sleep consolidates 30-session windows into morning markdown reports.
 - **macOS** (arm64 + x64) — fully supported, primary dev target.
 - **Linux** (Ubuntu, Debian, Fedora, Arch — x64 + arm64) — fully supported.
 - **Windows** — substrate itself is Bash-only, but the **MCP server binary**
-  ships as `kei-mcp-server-windows-x64.exe` in every release. Two
+  ships as `kei-mcp-server-windows-x64.exe` in every release. Three
   recommended paths:
   - **WSL2** (recommended) — install Windows Subsystem for Linux,
     then run `bootstrap.sh` inside Ubuntu/Debian as normal. Full
-    substrate works.
+    substrate works. `bootstrap.sh` auto-detects WSL2 and Git Bash;
+    on bare Windows it prints a one-time WSL setup guide and copies
+    the `wsl --install` command to your clipboard.
   - **MCP-only** — drop `kei-mcp-server-windows-x64.exe` into your
     Claude Desktop / VS Code MCP config to get `spawn_agent` +
     `kei_bash`/`kei_edit`/`kei_write` tools, without the full
     Bash-based substrate. Skills, hooks, and `kei` CLI not available
     in this mode.
-  - Native PowerShell port: not on the roadmap (would double maintenance
-    surface; WSL gives 100% coverage with 0 duplication).
+  - **Native PowerShell port** — demand-driven. WSL gives 100%
+    coverage today with 0 code duplication, so a native `.ps1`
+    substrate isn't built yet. If you want it, open an issue with
+    a thumbs-up on the existing Windows-native tracker (or file
+    one) — once demand is real, we'll build it. The MCP-server
+    binary path already covers the common "just want spawn_agent
+    in Claude Desktop" case.
 
 ## Maturity matrix
 
diff --git a/bootstrap.sh b/bootstrap.sh
index 9c4b38a..6691fb2 100755
--- a/bootstrap.sh
+++ b/bootstrap.sh
@@ -139,8 +139,12 @@ case "$OS" in
         err "Detected: bare Windows ($OS) via Git Bash / Cygwin / MSYS."
         err ""
         err "KeiSeiKit's substrate is Bash-only and needs apt/brew + full POSIX —"
-        err "it will not run reliably outside WSL2. Native PowerShell port is NOT"
-        err "on the roadmap (would double maintenance; WSL gives 100% coverage)."
+        err "it will not run reliably outside WSL2."
+        err ""
+        err "A native PowerShell port is demand-driven — not built yet because"
+        err "WSL2 covers 100% with zero code duplication. If enough Windows users"
+        err "ask, we will ship one. Open / 👍 an issue at:"
+        err "  https://github.com/KeiSeiLab/KeiSeiKit-1.0/issues"
         err ""
         err "Path forward (one-time setup, ~5 min + reboot):"
         err ""