chocomint 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: cec25dba3c4cbb75c398e6bec8da266b937ffc4e4410ea83ea9b54f186d075c5
+  data.tar.gz: 1745a506a4bd94df8f67ff8eadc9ab313b3bacc7b9daa6b06094f438cdc866a8
+SHA512:
+  metadata.gz: 95cbbce72c2151674bc93f73ab4c9fe77bbd2d44cf90b2d03a5eccfc8186bdb8cb0ebcf0f524bd3535316edb6fe5e8c68bf809644ce684743853a5dd1c6b621c
+  data.tar.gz: d8ad80506000c46f26b312eea3353af2684d978c3935bc00fe7a56cb1a1922fb80c43d9eb95f13ce7be4e85b4a58c4665bf0144c761b80c416d09c76bfa518e8

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ひかり (Himeyama)
+
+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,224 @@
+# chocomint
+
+<img width="600" alt="image" src="https://github.com/user-attachments/assets/93c03bde-eab0-432f-8e72-26540e183320" />
+
+**Tool Execution Supervisor for Ruby** — LLM のツール呼び出しをソフトウェアで厳格に監督し、
+機械的検証・意味的検証・自動再試行・監査ログを行うオーケストレータ。
+
+設計仕様は [`DESIGN.md`](./DESIGN.md) を参照。設計原則:
+
+> LLM は提案者と監査者に限定し、実行・判定・再試行・記録はソフトウェアで管理する。
+
+## 必要環境
+
+- Ruby 3.4 (RubyInstaller **with MSYS2/DevKit**)
+- LLM backend: Anthropic Messages API 互換エンドポイント
+  （Ollama が `/v1/messages` に対応。Claude API / OpenRouter でも `base_url` 差し替えで動作）
+
+## セットアップ
+
+```powershell
+# Ruby 3.4 (未導入の場合)
+winget install --id RubyInstallerTeam.RubyWithDevKit.3.4 -e
+
+# 依存 gem
+bundle install
+```
+
+## 設定
+
+`config/config.yml` を編集する（DESIGN §11）。実機確認済みの構成:
+
+```yaml
+llm:
+  base_url: http://localhost:11434/v1   # Ollama
+  model: gemma4:e4b                     # 提案者(primary)。tool_use 対応が必須
+verifier:
+  enabled: true
+  # モデルは指定しない。verifier は llm.model を共有する（下記「モデルは 1 つ」を参照）
+```
+
+環境変数でオーバーライド可能: `CHOCOMINT_LLM_BASE_URL`, `CHOCOMINT_LLM_MODEL`。
+
+> **モデルは 1 つ（primary と verifier で共有）**: VRAM 節約のため verifier は
+> primary と同じモデルを使う。`factory.rb` が verifier に `llm.model` を渡すため、
+> `config.yml` に `verifier.model` を書く必要はない（書いても無視される）。
+> 単一モデルなら Ollama へのロードも 1 つで済み、モデルスワップが起きない。
+
+> **モデル選定の注意**: verifier は出力を必ず `1`/`0` のみにする必要があるため、
+> primary/verifier を兼ねるモデルは **tool_use 対応**かつ **指示追従性が高い**
+> ものを選ぶ。`qwen3` 等の thinking 系は余計な出力をして verifier が
+> 不正判定 (RETRY) になりやすいので注意。
+
+## 実行
+
+```powershell
+# ollama serve を起動しておく
+ruby bin/chocomint "<ユーザー要求>" ["<期待条件>"]
+
+# 例
+ruby bin/chocomint "workspace/hello.txt に hello と書いて" "内容が hello であること"
+```
+
+出力例:
+
+```
+status:   PASS
+trace_id: 8af69708-...
+attempts: 1
+proposal: {"tool":"write_file","arguments":{"path":"workspace/hello.txt","content":"hello"}}
+result:   {"exit_code":0,"stdout":"wrote 5 bytes to workspace/hello.txt", ...}
+```
+
+## 監督プロキシサーバー
+
+chocomint を **Anthropic Messages API 互換の HTTP サーバー**として起動できる。
+`POST /v1/messages` で受けた要求を内部で `Orchestrator#run` に委譲し、
+ツール実行・機械検証・意味検証・再試行・監査ログまで**完結させてから**結果を返す
+（「監督完結型」）。通常の LLM API と違い、返るのは提案ではなく**実行が保証された結果**。
+
+```powershell
+# 起動 (Ollama backend が別途必要)
+ruby bin/chocomint-server           # 既定 127.0.0.1:9210 (使用中なら 9211, 9212... と自動で空きポートを探す)
+# CHOCOMINT_HOST / CHOCOMINT_PORT または config.yml の server: で変更可
+```
+
+リクエスト例:
+
+```powershell
+$body = @{
+  messages = @(@{ role="user"; content="a.txt に hello と書いて" })
+  expectations = "a.txt が存在し内容が hello であること"
+} | ConvertTo-Json -Depth 6
+Invoke-RestMethod -Uri http://127.0.0.1:9210/v1/messages -Method Post `
+  -ContentType "application/json" -Body $body
+```
+
+レスポンス（Anthropic 形式 + `chocomint` 監督メタ情報）:
+
+```json
+{
+  "type": "message", "role": "assistant", "model": "chocomint-supervisor",
+  "chocomint": { "status": "PASS", "trace_id": "...", "attempts": 1 },
+  "content": [
+    { "type": "tool_use", "name": "write_file", "input": { "path": "...", "content": "hello" } },
+    { "type": "tool_result", "content": [{ "type": "text", "text": "{\"exit_code\":0,...}" }] }
+  ]
+}
+```
+
+| エンドポイント | 内容 |
+|----------------|------|
+| `POST /v1/messages` | 監督実行。200=PASS / 422=提案不正 / 502=リトライ上限 / 400=リクエスト不正 |
+| `GET /health` | ヘルスチェック |
+
+## テスト
+
+```powershell
+bundle exec rspec
+```
+
+## 監査ログ
+
+全試行が `logs/execution.db` (SQLite) の `executions` テーブルに記録される（DESIGN §12）。
+
+```powershell
+ruby -e "require 'sqlite3'; SQLite3::Database.new('./logs/execution.db').execute('SELECT attempt,status,verifier_output FROM executions ORDER BY id').each{|r| p r}"
+```
+
+## セキュリティ
+
+- ファイルアクセスは `security.allowed_dirs`（既定 `.` = サーバーを起動した場所）配下のみ。
+  パストラバーサル (`../`) は `PathGuard` が拒否する（DESIGN §13）。
+- 出力・ファイルサイズ制限、実行タイムアウトを config で制御。
+
+## 対応ツール
+
+初期スコープ (DESIGN §15) に加え、基本的なファイル/コマンドツールを実装。
+
+### ファイル系（すべて `PathGuard` で許可ディレクトリ内に制限）
+
+| ツール | 引数 | 概要 |
+|--------|------|------|
+| `write_file`  | `path`, `content` | ファイルを書き込む（親ディレクトリ自動作成） |
+| `read_file`   | `path`            | ファイル内容を stdout に返す |
+| `list_dir`    | `path`            | ディレクトリのエントリ一覧を返す |
+| `append_file` | `path`, `content` | ファイル末尾に追記（無ければ新規作成） |
+| `delete_file` | `path`            | ファイルを削除（ディレクトリは対象外） |
+| `make_dir`    | `path`            | ディレクトリを作成（親も作成） |
+| `file_info`   | `path`            | 存在・種別・サイズを JSON で返す |
+
+### 検索・編集系（`PathGuard` で許可ディレクトリ内に制限）
+
+| ツール | 引数 | 概要 |
+|--------|------|------|
+| `edit` | `path`, `old_string`, `new_string`, `replace_all?` | 文字列置換。既定では `old_string` が一意である必要あり |
+| `grep` | `pattern`, `base?`, `glob?`, `ignore_case?` | 正規表現検索。`file:line:text` 形式で返す |
+| `glob` | `pattern`, `base?` | glob パターン（例 `**/*.rb`）でファイル列挙 |
+| `ls`   | `path` | エントリを `name`/`type`/`size` 付き JSON 配列で返す |
+
+### コマンド系
+
+| ツール | 引数 | 概要 |
+|--------|------|------|
+| `run_command` | `command`, `args[]` | **whitelist** のコマンドのみ実行。`shell` を介さず引数配列で spawn（DESIGN §13） |
+| `bash`       | `script` | bash スクリプトを実行 ⚠️ |
+| `powershell` | `script` | PowerShell (`pwsh`) スクリプトを実行 ⚠️ |
+
+`run_command` の許可コマンドは `config.yml` の `security.allowed_commands` で指定する。
+`security.allow_all_commands: true` にすると whitelist を無効化し任意コマンドを実行できる
+（⚠️ 信頼できるローカル環境でのみ使うこと）。
+
+> ⚠️ **`bash` / `powershell` について**: shell を介すため **任意コマンド実行が可能**で、
+> DESIGN §13 の「shell 展開禁止」原則からは外れる強力なツール。cwd 固定・timeout・
+> 出力サイズ制限は適用されるが、信頼できる環境でのみ使うこと。
+
+## AI エディタ (`/edit`)
+
+`chocomint-server` は **ブラウザ上の AI エディタ**を `/edit` で提供する。
+Monaco Editor でのファイル編集、AI チャットによる編集（内部で Planner が
+提案→実行→検証→再試行を完結）、本物の対話コンソール（xterm.js）を 1 画面に統合する。
+
+```powershell
+ruby bin/chocomint-server
+# → http://127.0.0.1:9210/edit をブラウザで開く
+```
+
+構成: メニュー / ファイル一覧（`workspace/` 配下）/ Monaco エディタ / AI チャット /
+コンソール（ConPTY による本物の tty）。
+
+| エンドポイント | 内容 |
+|----------------|------|
+| `GET /edit` | エディタ画面 |
+| `GET /edit/files` | `workspace/` のファイル一覧 (JSON) |
+| `GET /edit/file?path=` | ファイル内容 (JSON) |
+| `POST /edit/save` | 人手編集の保存（`PathGuard` で `workspace/` 内に限定） |
+| `POST /edit/chat` | 自然言語指示で AI 編集（`Planner#run`。`expectations` に指示を渡すため意味的検証が効く） |
+| `GET /edit/assets/*` | Monaco / xterm.js のローカル同梱アセット |
+
+### 追加依存
+
+- `ffi` — Windows の擬似コンソール (ConPTY) を FFI で叩く（プリビルド gem、DevKit 不要）。
+- `websocket-driver` — コンソール (xterm.js) の WebSocket。
+- Monaco / xterm.js は `public/vendor/` に同梱（CDN 不要・オフライン動作）。
+
+### コンソール（本物の対話 tty）
+
+コンソールは Windows の **ConPTY** で `pwsh` を対話起動し、WebSocket 経由で
+xterm.js と双方向に繋ぐ。tty ワーカーは新規コンソール付きで spawn される
+（ConPTY はコンソールを持つプロセスからしか正しく動かないため）。
+
+WebSocket は既定で HTTP ポート +1（`8081`）。ポート・トークンは以下で変更可能:
+
+```powershell
+$env:CHOCOMINT_WS_PORT  = "8081"
+$env:CHOCOMINT_WS_TOKEN = "<共有トークン>"   # 未設定ならローカル限定運用として認証なし
+```
+
+> ⚠️ **コンソールのセキュリティ**: 生の対話 tty は `PathGuard` /
+> `allowed_commands` の **監督外**で任意コマンドを実行できる（DESIGN §13 の
+> shell 展開禁止原則の例外）。bind は `127.0.0.1` 固定。信頼できるローカル環境で、
+> 必要なら `CHOCOMINT_WS_TOKEN` を設定して使うこと。
+>
+> ConPTY 非対応環境（非 Windows / `ffi` 未導入）ではコンソールのみ無効化され、
+> エディタの他機能は動作する。

data/THIRD_PARTY_LICENSES.md

@@ -0,0 +1,45 @@
+# Third-Party Licenses
+
+chocomint は以下のサードパーティソフトウェアを利用・同梱している。各ソフトウェアの
+著作権はそれぞれの権利者に帰属し、以下のライセンスのもとで配布される。
+
+---
+
+## 同梱アセット (この gem に含めて再配布するもの)
+
+AI エディタ (`/edit`) をオフラインで動作させるため、以下を `public/vendor/` に
+バンドルしている。いずれも MIT ライセンスであり、原著作権表示とライセンス全文を
+各ディレクトリに同梱している。
+
+### Monaco Editor — v0.52.2
+
+- Copyright (c) Microsoft Corporation. All rights reserved.
+- License: MIT
+- Homepage: https://github.com/microsoft/monaco-editor
+- 同梱ライセンス: `public/vendor/monaco/LICENSE.txt`
+
+### xterm.js (@xterm) — addon-fit を含む
+
+- Copyright (c) 2017-2022, The xterm.js authors
+- Copyright (c) 2014-2016, SourceLair Private Company
+- Copyright (c) 2012-2013, Christopher Jeffrey
+- License: MIT
+- Homepage: https://github.com/xtermjs/xterm.js
+- 同梱ライセンス: `public/vendor/xterm/LICENSE`
+
+---
+
+## 実行時依存 gem (RubyGems 経由でインストールされ、この gem には同梱しないもの)
+
+これらは `gem install` 時に依存として取得される。ここでは参考として列挙する。
+
+| gem | ライセンス | ホームページ |
+|-----|-----------|-------------|
+| faraday | MIT | https://lostisland.github.io/faraday |
+| sqlite3 | BSD-3-Clause | https://github.com/sparklemotion/sqlite3-ruby |
+| json_schemer | MIT | https://github.com/davishmcclurg/json_schemer |
+| webrick | Ruby / BSD-2-Clause | https://github.com/ruby/webrick |
+| ffi | BSD-3-Clause | https://github.com/ffi/ffi |
+| websocket-driver | Apache-2.0 | https://github.com/faye/websocket-driver-ruby |
+
+上記はいずれも再配布・商用利用を許容する寛容なライセンスである。

data/bin/chocomint

@@ -0,0 +1,37 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "json"
+require_relative "../lib/chocomint"
+
+# 使い方:
+#   ruby bin/chocomint "<ユーザー要求>" ["期待条件"]
+def main(argv)
+  if argv.empty?
+    warn "usage: chocomint <request> [expectations]"
+    return 2
+  end
+
+  request = argv[0]
+  expectations = argv[1]
+
+  config = Chocomint::Config.load
+  planner = Chocomint::Factory.build(config)
+
+  result = planner.run(request, expectations: expectations)
+
+  puts "status:   #{result.status}"
+  puts "trace_id: #{result.trace_id}"
+  puts "attempts: #{result.attempts}"
+  puts "steps:    #{result.steps.size}"
+  result.steps.each_with_index do |step, i|
+    puts "  [#{i + 1}] #{step[:tool]} #{JSON.generate(step[:arguments])}"
+    puts "      -> #{JSON.generate(step[:result])}"
+  end
+  0
+rescue Chocomint::Error => e
+  warn "FAIL: #{e.class.name.split('::').last}: #{e.message}"
+  1
+end
+
+exit(main(ARGV)) if $PROGRAM_NAME == __FILE__

data/bin/chocomint-console-worker

@@ -0,0 +1,35 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# ConPTY コンソールワーカー。WorkerProcess から新規コンソール付きで spawn され、
+# 名前付きパイプ経由で tty を橋渡しする。
+# (ConPTY はコンソール付きプロセスからしか正しく動かないため、この分離が必要。)
+#
+# 使い方 (通常は WorkerProcess が spawn する):
+#   ruby bin/chocomint-console-worker --pipe \\.\pipe\... --cols 80 --rows 25 \
+#        --cwd <dir> -- <shell command...>
+require "optparse"
+require_relative "../lib/chocomint/console/worker"
+
+options = { cols: 80, rows: 25, cwd: nil, c2w: nil, w2c: nil,
+            command: Chocomint::Console::ConPTY::DEFAULT_SHELL }
+OptionParser.new do |o|
+  o.on("--c2w NAME") { |v| options[:c2w] = v }
+  o.on("--w2c NAME") { |v| options[:w2c] = v }
+  o.on("--cols N", Integer) { |v| options[:cols] = v }
+  o.on("--rows N", Integer) { |v| options[:rows] = v }
+  o.on("--cwd DIR") { |v| options[:cwd] = v }
+  o.on("--command CMD") { |v| options[:command] = v }
+end.parse!(ARGV)
+options[:command] = ARGV.join(" ") unless ARGV.empty?
+
+abort("--c2w and --w2c are required") unless options[:c2w] && options[:w2c]
+
+Chocomint::Console::Worker.new(
+  command: options[:command],
+  cols: options[:cols],
+  rows: options[:rows],
+  cwd: options[:cwd],
+  c2w_name: options[:c2w],
+  w2c_name: options[:w2c]
+).run

data/bin/chocomint-server

@@ -0,0 +1,43 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/chocomint"
+
+# 監督完結型の Anthropic 互換プロキシ + AI エディタ (/edit) サーバーを起動する。
+#   ruby bin/chocomint-server
+# 環境変数 CHOCOMINT_HOST / CHOCOMINT_PORT / CHOCOMINT_WS_PORT / CHOCOMINT_WS_TOKEN で上書き可。
+config = Chocomint::Config.load
+base_dir = Dir.pwd
+planner = Chocomint::Factory.build(config, base_dir: base_dir)
+path_guard = Chocomint::Factory.build_path_guard(config, base_dir: base_dir)
+chat_client = Chocomint::Factory.build_chat_client(config, base_dir: base_dir)
+
+# AI エディタのコンソール (WebSocket + ConPTY) を別スレッドで起動する。
+# ConPTY (Windows 擬似コンソール) が使える環境でのみ有効化する。
+ws_port = nil
+ws_token = config.console_ws_token
+if Chocomint::CONSOLE_AVAILABLE
+  ws_port = config.console_ws_port
+  Chocomint::Console::Server.new(
+    host: config.server_host,
+    port: ws_port,
+    cwd: path_guard.allowed_roots.first, # WORKING DIRECTORY (ファイル一覧) の起点と揃える
+    token: ws_token,
+    logger: $stderr
+  ).start_in_thread
+else
+  warn "console (ConPTY) unavailable on this platform; /edit terminal disabled"
+end
+
+Chocomint::Server.new(
+  planner,
+  host: config.server_host,
+  port: config.server_port,
+  sqlite_path: config.sqlite_path,
+  path_guard: path_guard,
+  base_dir: base_dir,
+  max_file_bytes: config.max_file_bytes,
+  ws_port: ws_port,
+  ws_token: ws_token,
+  chat_client: chat_client
+).start

data/config/config.yml

@@ -0,0 +1,37 @@
+# chocomint 設定 (DESIGN.md §11)
+llm:
+  base_url: http://localhost:11434/v1
+  model: gemma4:e4b
+  api_key_env: OLLAMA_API_KEY   # 参照する環境変数名 (無ければ空)
+  max_tokens: 4096               # thinking モデルは思考だけで使い切ることがあるため余裕を持たせる
+
+verifier:
+  enabled: true
+  # モデルは指定しない。VRAM 節約のため llm.model を共有する (factory.rb 参照)。
+  max_tokens: 1024                # thinking モデルは思考だけで使い切ることがあるため余裕を持たせる
+
+execution:
+  max_retry: 10
+  max_steps: 20                 # マルチステップ要求で実行を許すステップ数の上限 (暴走防止)
+  timeout_sec: 30
+  max_output_bytes: 1048576     # stdout/stderr サイズ制限 (1 MiB)
+
+security:
+  allowed_dirs:
+    - .                         # サーバーを起動した場所 (Dir.pwd) を作業ディレクトリとして許可
+  max_file_bytes: 10485760      # ファイルサイズ制限 (10 MiB)
+  allowed_commands:             # run_command で実行を許可するコマンド (whitelist)
+    - git
+    - ruby
+    - node
+    - uv                        # Python 環境構築 (uv init / uv add / venv)
+    - ping                      # ネットワーク疎通確認
+  allow_all_commands: true     # true にすると run_command が allowed_commands を無視し任意コマンドを実行する
+                                 # (⚠️ whitelist を無効化する。信頼できるローカル環境でのみ true にすること)
+
+logging:
+  sqlite_path: ./logs/execution.db
+
+server:
+  host: 127.0.0.1
+  port: 9210

data/lib/chocomint/config.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+require "yaml"
+
+module Chocomint
+  # config/config.yml を読み込み、環境変数オーバーライドを適用する。
+  class Config
+    DEFAULT_PATH = File.expand_path("../../config/config.yml", __dir__)
+
+    attr_reader :data
+
+    def self.load(path = DEFAULT_PATH)
+      raw = File.exist?(path) ? YAML.safe_load(File.read(path)) : {}
+      new(raw || {})
+    end
+
+    def initialize(data)
+      @data = deep_stringify(data)
+      apply_env_overrides!
+    end
+
+    def llm      = @data.fetch("llm", {})
+    def verifier = @data.fetch("verifier", {})
+    def execution = @data.fetch("execution", {})
+    def security = @data.fetch("security", {})
+    def logging  = @data.fetch("logging", {})
+    def server   = @data.fetch("server", {})
+
+    def server_host = ENV.fetch("CHOCOMINT_HOST", server.fetch("host", "127.0.0.1"))
+    def server_port = ENV.fetch("CHOCOMINT_PORT", server.fetch("port", 9210)).to_i
+    # AI エディタのコンソール (WebSocket) 用ポート。既定は HTTP ポート+1。
+    def console_ws_port = ENV.fetch("CHOCOMINT_WS_PORT", server.fetch("ws_port", server_port + 1)).to_i
+    # コンソール接続に要求する共有トークン。未設定なら nil (ローカル限定運用向け)。
+    def console_ws_token = ENV.fetch("CHOCOMINT_WS_TOKEN", server.fetch("ws_token", nil))
+
+    def max_retry       = execution.fetch("max_retry", 10)
+    # マルチステップ実行のステップ数上限。未設定なら max_retry を流用する (暴走防止)。
+    def max_steps       = execution.fetch("max_steps", max_retry)
+    def timeout_sec     = execution.fetch("timeout_sec", 30)
+    def max_output_bytes = execution.fetch("max_output_bytes", 1_048_576)
+
+    def allowed_dirs    = security.fetch("allowed_dirs", ["."])
+    def max_file_bytes  = security.fetch("max_file_bytes", 10_485_760)
+    def allowed_commands = security.fetch("allowed_commands", [])
+    # true なら run_command で allowed_commands の whitelist チェックを行わず任意コマンドを実行する。
+    def allow_all_commands? = security.fetch("allow_all_commands", false)
+
+    def sqlite_path     = logging.fetch("sqlite_path", "./logs/execution.db")
+
+    def verifier_enabled? = verifier.fetch("enabled", false)
+
+    private
+
+    def apply_env_overrides!
+      if (url = ENV["CHOCOMINT_LLM_BASE_URL"])
+        (@data["llm"] ||= {})["base_url"] = url
+      end
+      if (model = ENV["CHOCOMINT_LLM_MODEL"])
+        (@data["llm"] ||= {})["model"] = model
+      end
+    end
+
+    def deep_stringify(obj)
+      case obj
+      when Hash
+        obj.each_with_object({}) { |(k, v), h| h[k.to_s] = deep_stringify(v) }
+      when Array
+        obj.map { |v| deep_stringify(v) }
+      else
+        obj
+      end
+    end
+  end
+end