From 59eb39e8a058b5a3a4641d9fafa1a456cfd140ff Mon Sep 17 00:00:00 2001
From: nyash-codex <codex@nyash.local>
Date: Sun, 28 Sep 2025 20:47:45 +0900
Subject: [PATCH] docs: mark WASM/browser as paused/unmaintained; update README
 (en/ja), wasm guides banner; archive note in projects/nyash-wasm README

---
 README.ja.md                                | 14 ++++++--------
 README.md                                   | 14 ++++++--------
 docs/guides/wasm-guide/wasm_browser_plan.md |  6 ++++--
 docs/guides/wasm-guide/wasm_quick_start.md  |  6 ++++--
 projects/nyash-wasm/README.md               | 14 +++++++-------
 5 files changed, 27 insertions(+), 27 deletions(-)

diff --git a/README.ja.md b/README.ja.md
index 4bcbfe0b..e89c6afc 100644
--- a/README.ja.md
+++ b/README.ja.md
@@ -228,14 +228,12 @@ tools/smoke_aot_vs_vm.sh examples/aot_min_string_len.nyash
   - LLVMバックエンドは性能と型安全性のため、method_idベースのプラグイン呼び出しのみ対応。
 
 
-### 5. **WebAssembly** （ブラウザ用）
-```bash
-cargo build --release --features wasm-backend
-./target/release/nyash --compile-wasm program.nyash
-```
-- ブラウザで実行
-- デフォルトでクロスプラットフォーム
-- Webファースト開発
+### 5. **WebAssembly（ブラウザ）** — 現状: 一時停止 / 未整備
+WASM/ブラウザ経路は現在メンテ対象外です（CI未対象）。古いプレイグラウンド/ガイドは歴史的資料として残置しています。
+
+- ソース（アーカイブ）: `projects/nyash-wasm/`（ビルド保証なし）
+- 現在の主軸: VM（Rust）と LLVM（llvmlite ハーネス）
+- ローカルで試す場合は `projects/nyash-wasm/README.md` と `projects/nyash-wasm/build.sh` を参照（wasm-pack 必須、サポート無保証）。
 
 ---
 
diff --git a/README.md b/README.md
index 8765c4d2..2e63e382 100644
--- a/README.md
+++ b/README.md
@@ -273,14 +273,12 @@ tools/smoke_aot_vs_vm.sh examples/aot_min_string_len.nyash
   - The LLVM backend only supports method_id-based plugin calls for better performance and type safety.
 
 
-### 5. **WebAssembly** (Browser)
-```bash
-cargo build --release --features wasm-backend
-./target/release/nyash --compile-wasm program.nyash
-```
-- Run in browsers
-- Cross-platform by default
-- Web-first development
+### 5. **WebAssembly (Browser)** — Status: Paused / Unmaintained
+The WASM/browser path is currently not maintained and is not part of CI. The older playground and guides are kept for historical reference only.
+
+- Source (archived): `projects/nyash-wasm/` (build not guaranteed)
+- Current focus: VM (Rust) and LLVM (llvmlite harness)
+- If you experiment locally, see the project README and `projects/nyash-wasm/build.sh` (wasm-pack required). No support guarantees.
 
 ---
 
diff --git a/docs/guides/wasm-guide/wasm_browser_plan.md b/docs/guides/wasm-guide/wasm_browser_plan.md
index 55f5ab8e..db0abd95 100644
--- a/docs/guides/wasm-guide/wasm_browser_plan.md
+++ b/docs/guides/wasm-guide/wasm_browser_plan.md
@@ -1,4 +1,6 @@
-# 🌐 Nyash WebAssembly ブラウザデビュー計画
+# 🌐 Nyash WebAssembly ブラウザデビュー計画（アーカイブ）
+
+注意: 本ドキュメントはアーカイブ目的で残置しています。WASM/ブラウザ経路は現在メンテ停止中で、記載の計画は最新のNyashとは一致しない可能性があります。
 
 ## 🎯 なぜこれが天才的か
 
@@ -111,4 +113,4 @@ game.start()
 3. **学習曲線なし** - ブラウザだけあればOK
 4. **実用アプリ** - 本格的なWebアプリも可能
 
-これ、本当にすぐできるにゃ！
\ No newline at end of file
+これ、本当にすぐできるにゃ！
diff --git a/docs/guides/wasm-guide/wasm_quick_start.md b/docs/guides/wasm-guide/wasm_quick_start.md
index ea329289..0bff7702 100644
--- a/docs/guides/wasm-guide/wasm_quick_start.md
+++ b/docs/guides/wasm-guide/wasm_quick_start.md
@@ -1,4 +1,6 @@
-# 🚀 Nyash WASM クイックスタート実装
+# 🚀 Nyash WASM クイックスタート実装（注意: 現状メンテ外）
+
+このガイドは歴史的資料です。WASM/ブラウザ経路は現在メンテ対象外で、記載手順は最新のNyashと一致しない場合があります。実験する場合は `projects/nyash-wasm/` を参考に自己責任でお試しください。
 
 ## Step 1: Cargo.toml修正
 
@@ -138,4 +140,4 @@ wasm-pack build --target web --out-dir www
 cd www && python3 -m http.server 8000
 ```
 
-これで http://localhost:8000 でNyashがブラウザで動く！🎉
\ No newline at end of file
+これで http://localhost:8000 でNyashがブラウザで動く！🎉
diff --git a/projects/nyash-wasm/README.md b/projects/nyash-wasm/README.md
index 4c3a25ae..1480ffeb 100644
--- a/projects/nyash-wasm/README.md
+++ b/projects/nyash-wasm/README.md
@@ -1,8 +1,8 @@
-# 🌐 Nyash WebAssembly Project
+# 🌐 Nyash WebAssembly Project (Archived / Unmaintained)
 
-Nyash programming language running in the browser via WebAssembly!
+Status: This directory contains an older WASM/browser prototype. It is not part of CI and may not build with current Nyash. Instructions below are historical and provided as-is.
 
-## 🚀 Quick Start
+## 🚀 Quick Start (experimental)
 
 ```bash
 # Install wasm-pack (if not already installed)
@@ -12,7 +12,7 @@ cargo install wasm-pack
 cd /mnt/c/git/nyash
 wasm-pack build --target web --out-dir projects/nyash-wasm/pkg
 
-# Start local server  
+# Start local server (example)
 cd projects/nyash-wasm
 python3 -m http.server 8000
 
@@ -20,7 +20,7 @@ python3 -m http.server 8000
 # Navigate to: http://localhost:8000/nyash_playground.html
 ```
 
-## 🎯 Features
+## 🎯 Features (historical)
 
 - **🐱 Full Nyash Language** - Complete interpreter running in browser
 - **📦 ConsoleBox** - Browser console integration  
@@ -41,7 +41,7 @@ projects/nyash-wasm/
     └── ...
 ```
 
-## 🎨 Example Code
+## 🎨 Example Code (historical)
 
 ```nyash
 // Browser console output
@@ -90,4 +90,4 @@ ConsoleBox → web_sys::console
 
 ---
 
-**Everything is Box, even in the browser! 🐱**
\ No newline at end of file
+**Everything is Box, even in the browser! 🐱**