picoride 0.1.0

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,10 @@
+# Code of Conduct
+
+"picoride" follows [The Ruby Community Conduct Guideline](https://www.ruby-lang.org/en/conduct) in all "collaborative space", which is defined as community communications channels (such as mailing lists, submitted patches, commit comments, etc.):
+
+* Participants will be tolerant of opposing views.
+* Participants must ensure that their language and actions are free of personal attacks and disparaging personal remarks.
+* When interpreting the words and actions of others, participants should always assume good intentions.
+* Behaviour which can be reasonably considered harassment will not be tolerated.
+
+If you have any concerns about behaviour within this project, please contact us at ["youchan@gmail.com"](mailto:"youchan@gmail.com").

data/Dockerfile

@@ -0,0 +1,76 @@
+# ビルド専用イメージ(移行プラン フェーズ1)。
+#
+# 旧来の Dockerfile はESP-IDFに加えてRuby/rbenv・R2P2-ESP32本体・Sinatraアプリまで
+# 1つのイメージに焼き込んでいたが、「Sinatraはホストでネイティブに動かし、Dockerは
+# idf.py build / rake setup_xxx の実行専用にする」という移行方針(CLAUDE.md参照)に
+# 沿って、ここではESP-IDFツールチェインだけを持つ最小限のイメージにしてある。
+#
+# R2P2-ESP32本体は焼き込まない。プロジェクトごとに独立したビルド状態(sdkconfig・
+# build/・managed_components等)を持たせたいため、実行時にホスト側の状態ディレクトリを
+# `docker run -v <state_dir>:/R2P2-ESP32` でbind mountして使う想定(R2P2-ESP32の
+# git clone・build_config.rbフックのパッチ・idf_component.ymlのバージョン固定は、
+# ホスト側のRubyコードがそのstate_dirを初めて使うときに行う。イメージビルド時の
+# `RUN`では実行できないため)。
+FROM espressif/idf:v5.5.1
+
+SHELL ["/bin/bash", "-c"]
+
+ENV LANG=C.UTF-8
+ENV LC_ALL=C.UTF-8
+
+# R2P2-ESP32のrakelib/setup.rake(`rake setup_xxx`)は内部で`bundle install`を
+# 呼び、そこでracc/ffi/io-console/json等ネイティブ拡張を持つgemをビルドしようと
+# する。ベースイメージ(espressif/idf)にはコンパイラもRubyのヘッダファイルも
+# 無いため、`mkmf.rb can't find header files for ruby`で失敗する(実際に
+# `rake setup_esp32`を実行して発覚した)。ビルド専用イメージなので、
+# Rubyそのものはベースイメージのシステムruby(apt由来)をそのまま使いつつ、
+# 拡張のビルドに必要な最小限だけ追加する。
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    ruby-dev \
+    libssl-dev \
+    libreadline-dev \
+    zlib1g-dev \
+    libyaml-dev \
+    libffi-dev \
+    && rm -rf /var/lib/apt/lists/*
+
+# main/CMakeLists.txt の littlefs_create_partition_image(joltwallet/esp_littlefs、
+# storageパーティションのイメージ作成に使う)は、ビルド時にvenvを作ってPyPIから
+# littlefs-python をインストールする。ビルド実行時にネットワークが不安定だと
+# ここでタイムアウトして失敗する(実際に発生した)。R2P2-ESP32側のmain/idf_component.yml
+# で joltwallet/littlefs を 1.20.4 に固定する前提(この固定処理自体はR2P2-ESP32を
+# プロジェクトごとにcloneするRuby側の処理に移した)で、image-building-requirements.txt
+# の中身が littlefs-python==0.15.0 に一意に確定していることを利用し、これを
+# イメージビルド時に取得して /opt/pip-wheels に置いておく。PIP_NO_INDEX/PIP_FIND_LINKS
+# で「常にこのローカルディレクトリだけを見る」ようコンテナ全体のpipに指示することで、
+# ビルド実行時はPyPIへの通信自体(バージョン解決の問い合わせも含めて)を発生させない。
+#
+# pip3(python3含む)はこのイメージだとentrypoint.sh(コンテナ起動時にのみ実行される)
+# 経由でPATHに追加される、export.shが用意するESP-IDF専用のvenvにしか無い。
+# `docker build`のRUNはentrypointを経由しない生のシェルなので、同じRUN内で
+# 明示的にexport.shをsourceしないとpip3が見つからない(idf.py/rakeの実行時に
+# 毎回export.shをsourceしているのと同じ理由)。
+RUN . "${IDF_PATH}/export.sh" > /dev/null && pip3 download littlefs-python==0.15.0 -d /opt/pip-wheels
+
+ENV PIP_NO_INDEX=1
+ENV PIP_FIND_LINKS=/opt/pip-wheels
+
+# bind mountしたディレクトリ(ホスト側の実UIDのまま見える)に対してgitコマンドを
+# 実行すると、コンテナ内のユーザーとの所有者不一致でgitが「dubious ownership」
+# エラーを出して拒否する(git 2.35.2以降のCVE-2022-24765対策)。実際に
+# `rake setup_xxx`実行時に発生して発覚した。bind mountされたパスは実行のたびに
+# 変わりうる(プロジェクトごとの状態ディレクトリ)ので、個別に許可するのではなく
+# 全パスを許可しておく(このイメージはビルド専用の使い捨てコンテナ内でしか
+# 使わないため、安全性への影響は無視できる)。
+RUN git config --system --add safe.directory '*'
+
+# R2P2-ESP32のrakelib/setup.rake(`rake setup_xxx`でmruby/picorubyをビルドする処理)は
+# 内部で`bundle install`を呼ぶ。このイメージにはベースイメージ(espressif/idf)が
+# 標準で持つRuby(bundlerはデフォルトgemとしてライブラリだけは入っているが、
+# `bundle`コマンドの実行ファイルは生成されていない)がある。実際に`rake setup_esp32`
+# を実行して`bundle: command not found`(exit 127)になったことで発覚した。
+RUN gem install bundler --no-document
+
+# R2P2-ESP32の状態ディレクトリをここへbind mountして使う想定のデフォルトWORKDIR。
+WORKDIR /R2P2-ESP32

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 youchan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,76 @@
+# PicoRuby/FemtoRuby IDE for ESP32 / Raspberry Pi Pico
+
+This is PicoRuby/FemtoRuby development environment for ESP32 and Raspberry Pi Pico
+(R2P2-ESP32 / R2P2).
+This IDE can do as following
+
+- Edit source codes(.c .h .rb) for mrbgem as a project
+- Build image
+- Install image to your device
+
+## Setup
+
+The app itself runs natively on your machine (Ruby). Docker is only used to run
+the firmware builds. There is one builder image per target family; build the
+one(s) you need once up front:
+
+```bash
+bundle install
+docker build -t picoride-builder-esp32 docker/esp32   # ESP32 (ESP-IDF)
+docker build -t picoride-builder-pico  docker/pico    # Raspberry Pi Pico (pico-sdk)
+```
+
+The server picks the image from the project's target (Settings dialog):
+`esp32*` targets use `picoride-builder-esp32`, `pico` / `pico_w` / `pico2` /
+`pico2_w` use `picoride-builder-pico`. Image names can be overridden with
+`PICORIDE_ESP32_BUILDER_IMAGE` / `PICORIDE_PICO_BUILDER_IMAGE`.
+
+If PicoRuby bumps its required pico-sdk version, the Pico build stops with
+"pico-sdk X is not checked out!". Rebuild the image with
+`docker build --build-arg PICO_SDK_VERSION=X -t picoride-builder-pico docker/pico`.
+
+### Raspberry Pi Pico notes
+
+- A Pico build produces a `.uf2`. Use "UF2をダウンロード" in the menu bar, then
+  hold BOOTSEL while plugging in the Pico and copy the file to the drive that
+  appears (`RPI-RP2` / `RP2350`).
+- Unlike ESP32, `app/` is not baked into the firmware. Transfer it with
+  "app/ をアップロード" on the Terminal tab.
+- `pico` / `pico_w` (RP2040) support only FemtoRuby (mruby/c);
+  `pico2` / `pico2_w` support both FemtoRuby and PicoRuby (mruby).
+
+## Run
+
+```bash
+./bin/server
+```
+
+Open http://localhost:4567 . On first load, open a project via File > Open
+Project (or the dropdown in the menu bar) and browse to, or create, a
+directory on disk — it gets an `app/` and `build_config.rb` automatically.
+Opened projects are remembered in `~/.picoride/project.toml`, so the last one
+you had open reopens automatically on the next server start.
+
+## Troubleshooting
+
+### `Failed to execute 'open' on 'SerialPort': Failed to open serial port.`
+
+This happens when connecting to the device from the Terminal tab (Web Serial
+API). On Linux, check `chrome://device-log` right after the failed attempt to
+see the actual OS-level error:
+
+- **`FILE_ERROR_ACCESS_DENIED`**: your user isn't (yet) in the `dialout` group
+  with an active session, so the browser process can't open `/dev/ttyACM*` /
+  `/dev/ttyUSB*`.
+  ```bash
+  sudo usermod -aG dialout $USER
+  ```
+  Adding yourself to the group is not enough by itself — an already-running
+  login session (and any browser already open in it) still has the old group
+  list. **Log out and back in (or reboot)** so the new group membership takes
+  effect, then try connecting again.
+- If the port isn't held by anything and permissions look right but it still
+  fails, check whether another process/service is holding the port open:
+  `sudo lsof /dev/ttyACM0` (or `/dev/ttyUSB0`), and whether `ModemManager` or
+  `brltty` is running and probing it (`systemctl status ModemManager brltty`).
+

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task default: :test

data/docker/esp32/Dockerfile

@@ -0,0 +1,82 @@
+# ESP32(R2P2-ESP32)用のビルド専用イメージ(移行プラン フェーズ1)。
+#
+#   docker build -t picoride-builder-esp32 docker/esp32
+#
+# Raspberry Pi Pico用は docker/pico/Dockerfile(別イメージ)。picorideサーバーが
+# プロジェクト設定のターゲットに応じてどちらのイメージで docker run するかを
+# 切り替える(lib/picoride/server.rb の BUILDER_IMAGES 参照)。
+#
+# 旧来の Dockerfile はESP-IDFに加えてRuby/rbenv・R2P2-ESP32本体・Sinatraアプリまで
+# 1つのイメージに焼き込んでいたが、「Sinatraはホストでネイティブに動かし、Dockerは
+# idf.py build / rake setup_xxx の実行専用にする」という移行方針(CLAUDE.md参照)に
+# 沿って、ここではESP-IDFツールチェインだけを持つ最小限のイメージにしてある。
+#
+# R2P2-ESP32本体は焼き込まない。プロジェクトごとに独立したビルド状態(sdkconfig・
+# build/・managed_components等)を持たせたいため、実行時にホスト側の状態ディレクトリを
+# `docker run -v <state_dir>:/R2P2-ESP32` でbind mountして使う想定(R2P2-ESP32の
+# git clone・build_config.rbフックのパッチ・idf_component.ymlのバージョン固定は、
+# ホスト側のRubyコードがそのstate_dirを初めて使うときに行う。イメージビルド時の
+# `RUN`では実行できないため)。
+FROM espressif/idf:v5.5.1
+
+SHELL ["/bin/bash", "-c"]
+
+ENV LANG=C.UTF-8
+ENV LC_ALL=C.UTF-8
+
+# R2P2-ESP32のrakelib/setup.rake(`rake setup_xxx`)は内部で`bundle install`を
+# 呼び、そこでracc/ffi/io-console/json等ネイティブ拡張を持つgemをビルドしようと
+# する。ベースイメージ(espressif/idf)にはコンパイラもRubyのヘッダファイルも
+# 無いため、`mkmf.rb can't find header files for ruby`で失敗する(実際に
+# `rake setup_esp32`を実行して発覚した)。ビルド専用イメージなので、
+# Rubyそのものはベースイメージのシステムruby(apt由来)をそのまま使いつつ、
+# 拡張のビルドに必要な最小限だけ追加する。
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    ruby-dev \
+    libssl-dev \
+    libreadline-dev \
+    zlib1g-dev \
+    libyaml-dev \
+    libffi-dev \
+    && rm -rf /var/lib/apt/lists/*
+
+# main/CMakeLists.txt の littlefs_create_partition_image(joltwallet/esp_littlefs、
+# storageパーティションのイメージ作成に使う)は、ビルド時にvenvを作ってPyPIから
+# littlefs-python をインストールする。ビルド実行時にネットワークが不安定だと
+# ここでタイムアウトして失敗する(実際に発生した)。R2P2-ESP32側のmain/idf_component.yml
+# で joltwallet/littlefs を 1.20.4 に固定する前提(この固定処理自体はR2P2-ESP32を
+# プロジェクトごとにcloneするRuby側の処理に移した)で、image-building-requirements.txt
+# の中身が littlefs-python==0.15.0 に一意に確定していることを利用し、これを
+# イメージビルド時に取得して /opt/pip-wheels に置いておく。PIP_NO_INDEX/PIP_FIND_LINKS
+# で「常にこのローカルディレクトリだけを見る」ようコンテナ全体のpipに指示することで、
+# ビルド実行時はPyPIへの通信自体(バージョン解決の問い合わせも含めて)を発生させない。
+#
+# pip3(python3含む)はこのイメージだとentrypoint.sh(コンテナ起動時にのみ実行される)
+# 経由でPATHに追加される、export.shが用意するESP-IDF専用のvenvにしか無い。
+# `docker build`のRUNはentrypointを経由しない生のシェルなので、同じRUN内で
+# 明示的にexport.shをsourceしないとpip3が見つからない(idf.py/rakeの実行時に
+# 毎回export.shをsourceしているのと同じ理由)。
+RUN . "${IDF_PATH}/export.sh" > /dev/null && pip3 download littlefs-python==0.15.0 -d /opt/pip-wheels
+
+ENV PIP_NO_INDEX=1
+ENV PIP_FIND_LINKS=/opt/pip-wheels
+
+# bind mountしたディレクトリ(ホスト側の実UIDのまま見える)に対してgitコマンドを
+# 実行すると、コンテナ内のユーザーとの所有者不一致でgitが「dubious ownership」
+# エラーを出して拒否する(git 2.35.2以降のCVE-2022-24765対策)。実際に
+# `rake setup_xxx`実行時に発生して発覚した。bind mountされたパスは実行のたびに
+# 変わりうる(プロジェクトごとの状態ディレクトリ)ので、個別に許可するのではなく
+# 全パスを許可しておく(このイメージはビルド専用の使い捨てコンテナ内でしか
+# 使わないため、安全性への影響は無視できる)。
+RUN git config --system --add safe.directory '*'
+
+# R2P2-ESP32のrakelib/setup.rake(`rake setup_xxx`でmruby/picorubyをビルドする処理)は
+# 内部で`bundle install`を呼ぶ。このイメージにはベースイメージ(espressif/idf)が
+# 標準で持つRuby(bundlerはデフォルトgemとしてライブラリだけは入っているが、
+# `bundle`コマンドの実行ファイルは生成されていない)がある。実際に`rake setup_esp32`
+# を実行して`bundle: command not found`(exit 127)になったことで発覚した。
+RUN gem install bundler --no-document
+
+# R2P2-ESP32の状態ディレクトリをここへbind mountして使う想定のデフォルトWORKDIR。
+WORKDIR /R2P2-ESP32

data/docker/pico/Dockerfile

@@ -0,0 +1,77 @@
+# Raspberry Pi Pico(R2P2)用のビルド専用イメージ。
+#
+#   docker build -t picoride-builder-pico docker/pico
+#
+# ESP32用(docker/esp32/Dockerfile)と同じく、ツールチェインだけを持つ使い捨て
+# コンテナ用のイメージ。picorideサーバーがプロジェクト設定のターゲットが
+# pico / pico_w / pico2 / pico2_w のときにこのイメージで docker run する
+# (lib/picoride/server.rb の BUILDER_IMAGES 参照)。
+#
+# R2P2(Pico版)は picoruby 本体に `picoruby-r2p2` gem として統合されているので、
+# ビルド対象のソースは picoruby のチェックアウト。これはイメージには焼き込まず、
+# プロジェクトごとの状態ディレクトリ(<project>/.r2p2-pico)をホスト側のRubyコードが
+# 初回に git clone し、`docker run -v <state_dir>:/picoruby` でbind mountして使う
+# (lib/picoride/r2p2_state.rb の ensure_pico_checkout 参照)。ビルドは
+# `rake r2p2:{vm}:{board}:prod`(picoruby/tasks/picoruby/r2p2.rake)。
+FROM ubuntu:24.04
+
+SHELL ["/bin/bash", "-c"]
+
+ENV LANG=C.UTF-8
+ENV LC_ALL=C.UTF-8
+ENV DEBIAN_FRONTEND=noninteractive
+
+# - gcc-arm-none-eabi 一式: libmruby.a と R2P2 本体のクロスコンパイル
+# - build-essential: mrbc(ホスト向け)や pioasm・picotool のビルド
+# - cmake(>= 3.22)/ python3: pico-sdk のビルドシステム
+# - ruby / rake: picoruby のビルド(rake)。r2p2 のビルドは `bundle exec` を使わない
+#   素の `rake` なので Bundler / gem のインストールは不要
+# - zip: r2p2 の cmake がリンク後に成果物(.uf2 等)を zip にまとめる。無いと
+#   .uf2 自体はできているのにビルドが失敗扱いになる(実際のビルドで確認)
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    ca-certificates \
+    cmake \
+    gcc-arm-none-eabi \
+    git \
+    libnewlib-arm-none-eabi \
+    libstdc++-arm-none-eabi-newlib \
+    python3 \
+    rake \
+    ruby \
+    zip \
+    && rm -rf /var/lib/apt/lists/*
+
+# pico-sdk はイメージに焼き込む。picoruby の rake タスク(r2p2:check_pico_sdk)は
+# PICO_SDK_PATH の pico-sdk が `git describe --tags --exact-match` で
+# picoruby 側の PICO_SDK_TAG(mrbgems/picoruby-r2p2/r2p2_config.rb)と一致することを
+# 要求する。picoruby 側が SDK のバージョンを上げたらビルドがその旨のエラーで
+# 止まるので、そのときは --build-arg PICO_SDK_VERSION=<新しいタグ> でイメージを
+# 作り直す。
+ARG PICO_SDK_VERSION=2.3.0
+RUN git clone --depth 1 --branch "${PICO_SDK_VERSION}" \
+      --recurse-submodules --shallow-submodules \
+      https://github.com/raspberrypi/pico-sdk.git /opt/pico-sdk
+ENV PICO_SDK_PATH=/opt/pico-sdk
+
+# picotool(.elf → .uf2 変換に使う)。pico-sdk 2.x は SDK と同じバージョンの
+# picotool がインストールされていないと、cmake の構成時に GitHub から picotool を
+# 取ってきてビルドしようとする(ビルドのたびにネットワークが必要になる)。
+# それを避けるため、同じバージョンをイメージビルド時に /usr/local へ入れておく
+# (find_package(picotool) が /usr/local/lib/cmake/picotool を見つける)。
+# USB 経由でボードを操作する機能は使わないので libusb 無しでビルドする。
+RUN git clone --depth 1 --branch "${PICO_SDK_VERSION}" \
+      https://github.com/raspberrypi/picotool.git /tmp/picotool \
+    && cmake -S /tmp/picotool -B /tmp/picotool/build \
+      -DPICO_SDK_PATH=/opt/pico-sdk -DPICOTOOL_NO_LIBUSB=1 -DCMAKE_BUILD_TYPE=Release \
+    && cmake --build /tmp/picotool/build -j"$(nproc)" \
+    && cmake --install /tmp/picotool/build \
+    && rm -rf /tmp/picotool
+
+# bind mount したディレクトリ(ホスト側の実UIDのまま見える)に対して git を
+# 実行すると「dubious ownership」で拒否される(ESP32 用イメージと同じ問題。
+# r2p2 の cmake は `git rev-parse` でリビジョンをファイル名に埋め込む)。
+RUN git config --system --add safe.directory '*'
+
+# picoruby の状態ディレクトリをここへ bind mount して使う想定のデフォルト WORKDIR。
+WORKDIR /picoruby

data/exe/picoride

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "optparse"
+require "picoride"
+require "picoride/server"
+
+options = {}
+OptionParser.new do |op|
+  op.banner = "Usage: picoride [options]"
+  op.on("-p port", "set the port (default is 4567)") { |val| options[:port] = Integer(val) }
+  op.on("-o addr", "set the bind address (default is localhost)") { |val| options[:bind] = val }
+  op.on("-e env", "set the environment (default is development)") { |val| options[:environment] = val.to_sym }
+end.parse!(ARGV)
+
+Picoride::Server.run!(options)

data/lib/picoride/background_job.rb

@@ -0,0 +1,71 @@
+module Picoride
+  class BackgroundJob
+    # ブラウザ(PicoRuby.wasm)側でのJSONパース/描画が重くなりすぎないよう、
+    # API経由で返すログは末尾のみに切り詰める。全量は @state[:log] に残る。
+    LOG_TAIL_LIMIT = 8_000
+
+    def initialize
+      @mutex = Mutex.new
+      @state = { status: "idle", log: "", started_at: nil, finished_at: nil }
+    end
+
+    # 実行中でなければバックグラウンドスレッドでcmdを開始してtrueを返す。
+    # 実行中ならなにもせずfalseを返す(呼び出し側で409にする)。
+    def start(cmd)
+      started = @mutex.synchronize do
+        break false if @state[:status] == "running"
+
+        @state[:status] = "running"
+        @state[:log] = ""
+        @state[:started_at] = Time.now.to_i
+        @state[:finished_at] = nil
+        true
+      end
+
+      Thread.new { run(cmd) } if started
+      started
+    end
+
+    def running?
+      @mutex.synchronize { @state[:status] == "running" }
+    end
+
+    def to_response_json
+      @mutex.synchronize do
+        full_log = @state[:log]
+        truncated = full_log.length > LOG_TAIL_LIMIT
+
+        {
+          status: @state[:status],
+          log: truncated ? full_log[-LOG_TAIL_LIMIT..-1] : full_log,
+          log_truncated: truncated,
+          started_at: @state[:started_at],
+          finished_at: @state[:finished_at]
+        }.to_json
+      end
+    end
+
+    private
+
+    def run(cmd)
+      Open3.popen2e("bash", "-c", cmd) do |stdin, stdout_and_stderr, wait_thread|
+        stdin.close
+        stdout_and_stderr.each_line do |line|
+          @mutex.synchronize { @state[:log] << line }
+        end
+
+        success = wait_thread.value.success?
+        @mutex.synchronize do
+          @state[:status] = success ? "success" : "failed"
+          @state[:finished_at] = Time.now.to_i
+        end
+      end
+    rescue StandardError => e
+      @mutex.synchronize do
+        @state[:status] = "failed"
+        @state[:log] << "\n[#{e.class}] #{e.message}\n"
+        @state[:finished_at] = Time.now.to_i
+      end
+    end
+  end
+end

data/lib/picoride/project_store.rb

@@ -0,0 +1,133 @@
+require "fileutils"
+require "perfect_toml"
+
+module Picoride
+  # ~/.picoride/project.toml への永続化。
+  #
+  # 「一度開いたら覚えておいてほしい、サーバーを再起動しても開かれている状態で
+  # 起動してほしい」という要望を受けて追加した。保存先はプロジェクトディレクトリの
+  # 外(ホームディレクトリ配下の`.picoride/`。r2p2_state.rbの状態ディレクトリと
+  # 同じ「プロジェクト本体の外に置く」発想)。
+  #
+  # その後「設定(ターゲット・VM・USB Console)はプロジェクト単位で持たせてほしい」
+  # というフィードバックを受けて、各プロジェクトの設定も同じファイルに持たせる
+  # ようにした(`platform`/`vm`/`usb_console`。server.rbのread_project_config/
+  # project_settings参照)。
+  #
+  # なお、このファイルはかつて「ワークスペース」(複数プロジェクトを束ねる
+  # 親ディレクトリ)を保存する`workspace.toml`という名前だった。「ワークスペース=
+  # プロジェクトだった」というフィードバックにより、プロジェクトを束ねる上位概念
+  # 自体が不要と判明したため、`project.toml`へ改名し、内容もプロジェクト直接を
+  # 指す形に変わっている(旧workspace.tomlの自動移行は行わない)。
+  #
+  # TOMLの読み書きは自前実装せず、PerfectTOML(mame/perfect_toml、単一ファイル・
+  # 無依存でTOML v1.0.0に完全準拠するパーサ/ジェネレータ)を使う。ファイルは
+  #   active = "最後にアクティブだったプロジェクトの絶対パス"
+  #
+  #   [名前]
+  #   path = "絶対パス"
+  #   platform = "esp32"       # 未設定なら書かない(TOMLにnullは無いため)
+  #   vm = "femtoruby"         # 同上
+  #   usb_console = false
+  # という形(nameはPerfectTOML.generateがHashのキーから自動でTOMLのテーブル名に
+  # 変換してくれる。空白を含む名前なども自動でクォートされる)。
+  module ProjectStore
+    DIR = File.join(Dir.home, ".picoride")
+    PATH = File.join(DIR, "project.toml")
+
+    module_function
+
+    # 保存されているプロジェクト一覧(存在しなくなったディレクトリは除外)、
+    # 最後にアクティブだったプロジェクトの絶対パス、各プロジェクトの設定を返す。
+    # 戻り値: {
+    #   active: "絶対パス" または nil,
+    #   paths: [絶対パスの配列(出現順)],
+    #   settings: { "絶対パス" => {"platform"=>, "vm"=>, "usb_console"=>}, ... }
+    # }
+    def load
+      data =
+        begin
+          PerfectTOML.load_file(PATH)
+        rescue Errno::ENOENT, PerfectTOML::ParseError
+          # ファイルが無い(初回起動)、あるいはユーザーが手で編集して壊した
+          # 場合でも、ここで落ちずに「何も保存されていない」扱いにする。
+          {}
+        end
+
+      active = data["active"]
+      paths = []
+      settings = {}
+
+      data.each do |name, value|
+        next if name == "active" || !value.is_a?(Hash)
+
+        path = value["path"]
+        next unless path.is_a?(String) && File.directory?(path)
+
+        paths << path
+        settings[path] = {
+          "platform" => value["platform"],
+          "vm" => value["vm"],
+          "usb_console" => value["usb_console"] == true
+        }
+      end
+
+      active = nil unless active.is_a?(String) && paths.include?(active)
+
+      { active: active, paths: paths, settings: settings }
+    end
+
+    # 現在の状態をまるごと書き込む(差分更新ではなく毎回全体を作り直す。
+    # プロジェクトの開閉・設定変更はそう頻繁な操作ではないので、素朴な
+    # 全体書き直しで十分という判断)。
+    #
+    # settingsはキーワード必須にしてある(デフォルト値を用意して省略を許すと、
+    # 「プロジェクトを開くだけ」の呼び出し箇所で既存の設定を空のHashで
+    # 上書きしてしまうミスを構造的に防げないため。実際に一度このミスを
+    # 作りかけた)。
+    def save(active:, paths:, settings:)
+      FileUtils.mkdir_p(DIR)
+
+      data = {}
+      data["active"] = active if active
+
+      used_names = {}
+      paths.each do |path|
+        entry = { "path" => path }
+        s = settings[path]
+        if s
+          # TOMLにnullは無いため、未設定(nil)のキーは書かない。
+          entry["platform"] = s["platform"] if s["platform"]
+          entry["vm"] = s["vm"] if s["vm"]
+          entry["usb_console"] = true if s["usb_console"] == true
+        end
+        data[unique_name(path, used_names)] = entry
+      end
+
+      PerfectTOML.save_file(PATH, data)
+    end
+
+    # プロジェクト名は既定でディレクトリ名(パスの最後のセグメント)にする
+    # (menu_bar.rbのproject_labelと同じロジック。フロントとサーバで共有
+    # できないので両側に同じものを持たせてある)。
+    def display_name(path)
+      name = path.to_s.split("/").last
+      name.nil? || name.empty? ? path.to_s : name
+    end
+
+    # 別のパスのプロジェクトが同じディレクトリ名(例: 違う場所にある2つの
+    # "projects"ディレクトリ)だった場合に備えて、TOMLのテーブル名として
+    # 一意になるよう連番を振る。
+    def unique_name(path, used_names)
+      base = display_name(path)
+      name = base
+      counter = 2
+      while used_names.key?(name)
+        name = "#{base}_#{counter}"
+        counter += 1
+      end
+      used_names[name] = true
+      name
+    end
+  end
+end