homura-runtime 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 772c92137bd489f019d78537753770d0ddc73f76825c48d4cab399532b5dee86
+  data.tar.gz: b9cfb81748aa74ede6731ff0aa76f5d148df52cc1e3ffc10a3d66c05167a2816
+SHA512:
+  metadata.gz: 58b61c31af0bf8c46ce28e5a027b598539929a543fb429723bd9212defbfab8d5875b5733b14764d6ab964597354674de998e2ef84e4da933a5b1c0d8aec72e2
+  data.tar.gz: 36e72393465c2ee4411132447588f356f9e497062aa6a24aa442ebf515d43a96d5f1246593c912a105e509f6206dde397c264b8a5d5e1fc93f76148a76acdefb

data/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+## 0.1.0 (2026-04-20)
+
+- Initial extraction from homura as `homura-runtime` (Phase 15-B).
+- Includes `cloudflare_workers`, `opal_patches`, and `runtime/{worker,setup-node-crypto}.mjs`.

data/README.md

@@ -0,0 +1,37 @@
+# homura-runtime
+
+Core Ruby + Module Worker glue for [Opal](https://opalrb.com/) on [Cloudflare Workers](https://developers.cloudflare.com/workers/). This gem does **not** depend on Sinatra or Sequel; those live in sibling gems.
+
+## What you get
+
+- `require 'opal_patches'` — additive patches for Opal corelib vs real-world gems (Rack, etc.).
+- `require 'cloudflare_workers'` — Rack handler, Cloudflare bindings, multipart, queue, Durable Objects, etc.
+- `runtime/worker_module.mjs` — fetch / scheduled / queue / DO adapters (**no Opal bundle import**).
+- `runtime/worker.mjs` — thin bootstrap (crypto shim → bundle → `worker_module`) for legacy layouts.
+- `runtime/setup-node-crypto.mjs` — `node:crypto` on `globalThis` before the Opal bundle loads.
+- `bin/cloudflare-workers-build` — single build pipeline (ERB → assets → Opal → patch → `worker.entrypoint.mjs`). Use `--standalone` in generated apps.
+- `docs/ARCHITECTURE.md` — wrangler `main`, codegen entrypoint, and fixed-import policy.
+
+## Quick start (homura monorepo)
+
+1. `Gemfile`: `gem 'homura-runtime', path: 'gems/homura-runtime'` and `gem 'opal-homura', '= 1.8.3.rc1', require: 'opal'` (path or exact pin).
+2. `bundle exec cloudflare-workers-build` — writes `build/hello.no-exit.mjs` and `build/worker.entrypoint.mjs`.
+3. `wrangler.toml`: `main = "build/worker.entrypoint.mjs"`, `compatibility_flags = ["nodejs_compat"]`.
+
+## Support matrix (indicative)
+
+| Component   | Verified (dev)   |
+|------------|------------------|
+| Ruby       | 3.4.x            |
+| Node       | ≥ 20             |
+| Wrangler   | ^3.99            |
+| Opal       | = 1.8.3.rc1      |
+
+## Wrangler config
+
+- **Supported as generated / documented**: `wrangler.toml` only.
+- `wrangler.json` / `wrangler.jsonc`: manual conversion only; not generated by this toolchain.
+
+## License
+
+MIT. See the repository `LICENSE`.

data/bin/cloudflare-workers-build

@@ -0,0 +1,255 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Single happy path: ERB precompile → assets embed → Opal bundle → patch-opal-evals → worker.entrypoint.mjs
+# No subcommands. Use --standalone for generated consumer apps (no homura inline routes).
+
+require 'fileutils'
+require 'open3'
+require 'optparse'
+require 'pathname'
+
+module CloudflareWorkersBuild
+  class << self
+    def gem_root
+      spec = Gem.loaded_specs['cloudflare-workers-runtime']
+      return Pathname(spec.full_gem_path) if spec
+      Pathname(__FILE__).expand_path.join('../..')
+    end
+
+    def runtime_dir
+      gem_root.join('runtime')
+    end
+
+    def exe_path(name)
+      gem_root.join('exe', name)
+    end
+
+    def gem_lib(name)
+      s = Gem.loaded_specs[name] || raise("cloudflare-workers-build: gem #{name} not loaded; use bundle exec from app root")
+      File.join(s.full_gem_path, 'lib')
+    end
+  end
+end
+
+options = {
+  root: Dir.pwd,
+  standalone: false,
+  opal_input: ENV['HOMURA_OPAL_INPUT'] || 'app/hello.rb',
+  opal_output: ENV['HOMURA_OPAL_OUTPUT'] || 'build/hello.no-exit.mjs',
+  patch_input: ENV['HOMURA_OPAL_PATCH_INPUT'],
+  setup_import: nil,
+  bundle_import: nil,
+  worker_module_import: nil,
+  entrypoint_out: nil,
+  with_db: false
+}
+
+OptionParser.new do |o|
+  o.banner = 'usage: cloudflare-workers-build [options]'
+  o.on('--root PATH', 'Project root (default: cwd)') { |p| options[:root] = p }
+  o.on('--standalone', 'Consumer app (skip inline-routes; use Gemfile-resolved load paths)') do
+    options[:standalone] = true
+  end
+  o.on('--with-db', 'Include sequel-d1 on Opal load path (standalone)') do
+    options[:with_db] = true
+  end
+  o.on('--input PATH', 'Opal entry .rb') { |p| options[:opal_input] = p }
+  o.on('--output PATH', 'Opal bundle .mjs') { |p| options[:opal_output] = p }
+  o.on('--patch-input PATH', 'Override patch target (default: same as --output)') { |p| options[:patch_input] = p }
+  o.on('--setup-import PATH', 'setup-node-crypto import in entrypoint') { |p| options[:setup_import] = p }
+  o.on('--bundle-import PATH', 'Opal bundle import in entrypoint') { |p| options[:bundle_import] = p }
+  o.on('--worker-module-import PATH', 'worker_module.mjs import in entrypoint') { |p| options[:worker_module_import] = p }
+  o.on('--entrypoint-out PATH', 'Where to write worker.entrypoint.mjs') { |p| options[:entrypoint_out] = p }
+end.parse!
+
+root = Pathname(options[:root]).expand_path
+
+if options[:standalone]
+  Dir.chdir(root) { require 'bundler/setup' }
+  options[:setup_import] ||= './cf-runtime/setup-node-crypto.mjs'
+  options[:bundle_import] ||= './build/hello.no-exit.mjs'
+  options[:worker_module_import] ||= './cf-runtime/worker_module.mjs'
+  options[:entrypoint_out] ||= 'worker.entrypoint.mjs'
+else
+  options[:setup_import] ||= '../gems/homura-runtime/runtime/setup-node-crypto.mjs'
+  options[:bundle_import] ||= './hello.no-exit.mjs'
+  options[:worker_module_import] ||= '../gems/homura-runtime/runtime/worker_module.mjs'
+  options[:entrypoint_out] ||= 'build/worker.entrypoint.mjs'
+end
+
+patch_target = options[:patch_input] || options[:opal_output]
+
+def run!(argv, chdir:)
+  Dir.chdir(chdir) do
+    system(*argv) || abort("cloudflare-workers-build: failed: #{argv.join(' ')}")
+  end
+end
+
+def run_opal_homura!(root, opal_input, opal_output)
+  argv = [
+    'bundle', 'exec', 'opal',
+    '-c', '-E', '--esm', '--no-source-map',
+    '-I', 'build/auto_await/app', '-I', 'build/auto_await', '-I', 'app',
+    '-I', 'gems/homura-runtime/lib',
+    '-I', 'gems/sinatra-homura/lib',
+    '-I', 'gems/sequel-d1/lib',
+    '-I', 'lib', '-I', 'vendor', '-I', 'build',
+    '-r', 'opal_patches', '-r', 'cloudflare_workers',
+    '-r', 'homura_templates', '-r', 'homura_assets',
+    '-o', opal_output,
+    opal_input
+  ]
+  stderr_log = root.join('build/opal.stderr.log')
+  FileUtils.mkdir_p(root.join('build'))
+  env = { 'OPAL_PREFORK_DISABLE' => '1' }
+  out_err, status = Open3.capture2e(env, *argv, chdir: root.to_s)
+  File.write(stderr_log, out_err)
+  abort('cloudflare-workers-build: opal failed') unless status.success?
+end
+
+def homura_vendor_from_gemfile(project_root)
+  gf = project_root.join('Gemfile')
+  return unless gf.file?
+
+  txt = gf.read
+  return unless (m = txt.match(/cloudflare-workers-runtime['"]\s*,\s*path:\s*['"]([^'"]+)['"]/))
+
+  runtime_path = Pathname.new(m[1]).expand_path(project_root)
+  vend = runtime_path.join('..', '..', 'vendor').expand_path
+  vend if vend.directory?
+end
+
+def run_opal_standalone!(root, opal_input, opal_output, with_db:)
+  load_paths = []
+  hv = homura_vendor_from_gemfile(root)
+  load_paths << hv.to_s if hv
+  load_paths += [
+    'build/auto_await/app', 'app',
+    CloudflareWorkersBuild.gem_lib('cloudflare-workers-runtime'),
+    CloudflareWorkersBuild.gem_lib('sinatra-cloudflare-workers')
+  ]
+  load_paths << CloudflareWorkersBuild.gem_lib('sequel-d1') if with_db
+  load_paths << 'vendor' if root.join('vendor').directory?
+  load_paths << 'build'
+
+  argv = ['bundle', 'exec', 'opal', '-c', '-E', '--esm', '--no-source-map']
+  load_paths.each { |p| argv.push('-I', p) }
+  argv += %w[-r opal_patches -r cloudflare_workers -r app_templates -r app_assets -o] + [opal_output, opal_input]
+
+  stderr_log = root.join('build/opal.stderr.log')
+  FileUtils.mkdir_p(root.join('build'))
+  env = { 'OPAL_PREFORK_DISABLE' => '1' }
+  out_err, status = Open3.capture2e(env, *argv, chdir: root.to_s)
+  File.write(stderr_log, out_err)
+  abort('cloudflare-workers-build: opal failed') unless status.success?
+end
+
+def write_entrypoint!(root, out_path, setup:, bundle:, worker_mod:)
+  body = <<~JS
+    // GENERATED by cloudflare-workers-build — do not edit by hand.
+    import "#{setup}";
+    import "#{bundle}";
+    export { default, HomuraCounterDO } from "#{worker_mod}";
+  JS
+  File.write(root.join(out_path), body)
+end
+
+unless options[:standalone]
+  run!(['ruby', 'bin/inline-routes-for-opal'], chdir: root)
+  run!(
+    [
+      'ruby', CloudflareWorkersBuild.exe_path('auto-await').to_s,
+      '--input', 'app',
+      '--output', 'build/auto_await/app'
+    ],
+    chdir: root
+  )
+  run!(
+    [
+      'ruby', CloudflareWorkersBuild.exe_path('auto-await').to_s,
+      '--input', 'build/routes_app_class_eval.rb',
+      '--output', 'build/auto_await/routes_app_class_eval.rb'
+    ],
+    chdir: root
+  )
+  run!(
+    [
+      'ruby', CloudflareWorkersBuild.exe_path('compile-erb').to_s,
+      '--input', 'views',
+      '--output', 'build/homura_templates.rb',
+      '--namespace', 'HomuraTemplates'
+    ],
+    chdir: root
+  )
+  run!(
+    [
+      'ruby', CloudflareWorkersBuild.exe_path('compile-assets').to_s,
+      '--input', 'public',
+      '--output', 'build/homura_assets.rb',
+      '--namespace', 'HomuraAssets'
+    ],
+    chdir: root
+  )
+
+  opal_in = Pathname(options[:opal_input])
+  opal_out = Pathname(options[:opal_output])
+  opal_in = root.join(opal_in) unless opal_in.absolute?
+  opal_out = root.join(opal_out) unless opal_out.absolute?
+  run_opal_homura!(root, opal_in.relative_path_from(root).to_s, opal_out.relative_path_from(root).to_s)
+else
+  run!(
+    [
+      'ruby', CloudflareWorkersBuild.exe_path('compile-erb').to_s,
+      '--input', 'views',
+      '--output', 'build/app_templates.rb',
+      '--namespace', 'AppTemplates'
+    ],
+    chdir: root
+  )
+  run!(
+    [
+      'ruby', CloudflareWorkersBuild.exe_path('compile-assets').to_s,
+      '--input', 'public',
+      '--output', 'build/app_assets.rb',
+      '--namespace', 'AppAssets'
+    ],
+    chdir: root
+  )
+  run!(
+    [
+      'ruby', CloudflareWorkersBuild.exe_path('auto-await').to_s,
+      '--input', 'app',
+      '--output', 'build/auto_await/app'
+    ],
+    chdir: root
+  )
+
+  opal_in = Pathname(options[:opal_input])
+  opal_out = Pathname(options[:opal_output])
+  opal_in = root.join(opal_in) unless opal_in.absolute?
+  opal_out = root.join(opal_out) unless opal_out.absolute?
+  run_opal_standalone!(root, opal_in.relative_path_from(root).to_s, opal_out.relative_path_from(root).to_s,
+                       with_db: options[:with_db])
+end
+
+patch_rel = Pathname(patch_target)
+patch_rel = root.join(patch_rel) unless patch_rel.absolute?
+run!(
+  [
+    'node',
+    CloudflareWorkersBuild.runtime_dir.join('patch-opal-evals.mjs').to_s,
+    patch_rel.relative_path_from(root).to_s
+  ],
+  chdir: root
+)
+
+write_entrypoint!(
+  root,
+  options[:entrypoint_out],
+  setup: options[:setup_import],
+  bundle: options[:bundle_import],
+  worker_mod: options[:worker_module_import]
+)
+
+$stderr.puts 'cloudflare-workers-build: ok'

data/docs/ARCHITECTURE.md

@@ -0,0 +1,59 @@
+# Cloudflare Workers + Opal — entrypoint topology (Phase 15-E)
+
+## 責務分離（確定）
+
+| レイヤ | 役割 |
+|--------|------|
+| `wrangler.toml` の `main` | **Workers Module のエントリ**（`fetch` / `scheduled` / `queue` / DO クラスを export） |
+| `worker.entrypoint.mjs`（生成物） | `setup-node-crypto` → **Opal bundle（副作用）** → `worker_module.mjs` の順で import。パスはプロジェクトごとに **固定文字列**（codegen） |
+| Opal bundle（例: `build/hello.no-exit.mjs`） | **ビルド成果物**。Rack ディスパッチャ等を `globalThis` に登録 |
+| `worker_module.mjs`（gem 同梱） | Rack / Cron / Queue / DO への **純粋な JS アダプタ**（Opal bundle を import しない） |
+
+## 禁止事項
+
+- **ランタイム可変 path import**（例: `import(pathVar)` で Opal bundle を読む）は採用しない。Workers のバンドル解決と並行性の両方で破綻しやすい。
+
+## Before / After（概念）
+
+```mermaid
+flowchart LR
+  subgraph before["Before (monorepo 固定)"]
+    W1[worker.mjs] -->|hard-coded| B1[../../../build/hello.mjs]
+  end
+  subgraph after["After (Phase 15-E)"]
+    E[worker.entrypoint.mjs] --> S[setup-node-crypto.mjs]
+    E --> O[build/*.mjs Opal bundle]
+    E --> M[worker_module.mjs]
+  end
+```
+
+## homura 本体
+
+- `wrangler.toml` の `main` は `build/worker.entrypoint.mjs`。
+- `bundle exec cloudflare-workers-build` が ERB / assets / Opal / patch / entrypoint 生成まで一括実行。
+
+## スキャフォールド済みアプリ
+
+- プロジェクト直下に `worker.entrypoint.mjs`（`main` と一致）。
+- `cf-runtime/` に `setup-node-crypto.mjs` と `worker_module.mjs` をコピー（gem から）。
+- `bundle exec cloudflare-workers-build --standalone` が consumer 向けパイプラインを実行し、`Gemfile` の `path:` から homura の `vendor/` を追加ロードパスへ取り込み（digest / zlib 等の Workers 向け補助ファイル）。
+
+## Phase 17 — Email Service（`SEND_EMAIL`）
+
+| 項目 | 内容 |
+|------|------|
+| Wrangler | `[[send_email]]` に `name = "SEND_EMAIL"`（Cloudflare Email Service · Agents Week 2026）。 |
+| Rack env | `env['cloudflare.SEND_EMAIL']` は `Cloudflare::Email`（JS `env.SEND_EMAIL.send(...)` を Ruby 側で `await`）。 |
+| 備考 | consumer アプリ側で verified sender を wrangler `[vars]` などに載せ、アプリから `from` に渡す。 |
+
+### Phase 17-E — `/cdn-cgi/*`（Rack に渡さない）とバインディング注入
+
+| 項目 | 内容 |
+|------|------|
+| **`worker_module.mjs` の `fetch` 先頭** | `env.SEND_EMAIL` があれば **`globalThis.__OPAL_WORKERS__.sendEmailBinding`** にコピーしてから Rack を呼ぶ。Miniflare 等で `js_env.SEND_EMAIL` が欠ける場合でも Ruby が同じ JS オブジェクトを拾える。 |
+| **`/cdn-cgi/*`** | **Sinatra に渡さない**。Miniflare の entry.worker は `/cdn-cgi/mf/scheduled` だけ先処理する。`/cdn-cgi/handler/email` などはユーザ Worker の `fetch` に届くため、ここで処理しないと Rack が 404 になる。将来 Phase 18（Email 受信）で `export async email(...)` と接続する前提。 |
+| **D1 / KV / Queue との違い** | それらは典型的に `env['cloudflare.env']` 経由で JS バインディングを参照する。`SEND_EMAIL` は **Worker の `env` に付く生バインディング**を `worker_module` が先に global に載せ、`Cloudflare::Email` がそれを包む（Rack の `cloudflare.*` はラッパー用の入口）。 |
+
+## wrangler.json について
+
+- **生成・サポート対象は `wrangler.toml` のみ**。`wrangler.json` / `wrangler.jsonc` は手動変換可だが、本ツールチェーンの前提外。

data/exe/auto-await

@@ -0,0 +1,102 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Auto-Await transformer — build-time Ruby source rewriter.
+# Scans app/**/*.rb, runs flow analysis, and inserts .__await__
+# where the receiver is a known async-tainted source.
+#
+# Usage:
+#   ruby auto-await --input app --output build/auto_await/app
+#
+# The output directory mirrors the input. Files that need no change
+# are skipped entirely (not copied), so the consumer can place the
+# output directory earlier on the Opal load path and fall back to
+# the original input for unchanged files.
+
+require 'fileutils'
+require 'pathname'
+
+# cloudflare-workers-runtime lib path resolution
+runtime_lib = ENV['CFW_RUNTIME_LIB']
+unless runtime_lib
+  spec = Gem.loaded_specs['cloudflare-workers-runtime']
+  runtime_lib = spec ? File.join(spec.full_gem_path, 'lib') : File.expand_path('../lib', __dir__)
+end
+$LOAD_PATH.unshift(runtime_lib) unless $LOAD_PATH.include?(runtime_lib)
+
+require 'cloudflare_workers/async_registry'
+require 'cloudflare_workers/auto_await/analyzer'
+require 'cloudflare_workers/auto_await/transformer'
+
+options = { input: nil, output: nil, debug: ENV['CLOUDFLARE_WORKERS_AUTO_AWAIT_DEBUG'] == '1' }
+
+ARGV.each_with_index do |arg, i|
+  case arg
+  when '--input'  then options[:input] = ARGV[i + 1]
+  when '--output' then options[:output] = ARGV[i + 1]
+  when '--debug'  then options[:debug] = true
+  end
+end
+
+abort('Usage: auto-await --input DIR --output DIR [--debug]') unless options[:input] && options[:output]
+
+input_root  = Pathname(options[:input]).expand_path
+output_root = Pathname(options[:output]).expand_path
+
+registry = CloudflareWorkers::AsyncRegistry.instance
+
+# Auto-load async source registrations from all loaded gems.
+CloudflareWorkers::AsyncRegistry.auto_load_gem_async_sources(debug: options[:debug])
+
+# Load project-specific async source registrations if present.
+project_async = File.join(Dir.pwd, 'lib', 'homura_async_sources.rb')
+require project_async if File.exist?(project_async)
+
+changed = 0
+skipped = 0
+errors  = 0
+
+paths = if File.directory?(input_root)
+  Dir.glob(input_root.join('**', '*.rb')).sort
+else
+  [input_root.to_s]
+end
+
+paths.each do |path|
+  rel = Pathname(path).relative_path_from(input_root)
+  source = File.read(path)
+
+  # If the file already has a user-written # await: magic comment we
+  # still run the analyzer (so .__await__ is inserted) but we keep
+  # the original magic comment in place.  The magic comment is only
+  # needed to tell Opal to wrap the file in an async function and to
+  # translate #__await__ calls into real JS await keywords.
+  has_magic = source.lines.first(5).any? { |l| l.match?(/#\s*await:/) }
+
+  begin
+    analyzer = CloudflareWorkers::AutoAwait::Analyzer.new(registry, debug: options[:debug])
+    buffer, nodes = analyzer.process(source, path)
+
+    if nodes.empty?
+      puts "[auto-await] skip (no changes) #{rel}" if options[:debug]
+      skipped += 1
+      next
+    end
+
+    transformed = CloudflareWorkers::AutoAwait::Transformer.transform(source, nodes, buffer)
+    unless has_magic
+      transformed = "# await: true\n" + transformed
+    end
+    out_path = output_root.join(rel)
+    FileUtils.mkdir_p(out_path.dirname)
+    File.write(out_path, transformed)
+    puts "[auto-await] write #{rel} (#{nodes.length} await#{'s' if nodes.length > 1})" if options[:debug]
+    changed += 1
+  rescue => e
+    $stderr.puts "[auto-await] ERROR #{rel}: #{e.message}"
+    errors += 1
+  end
+end
+
+puts "[auto-await] done: #{changed} changed, #{skipped} skipped, #{errors} errors"
+exit(1) if errors > 0

data/exe/compile-assets

@@ -0,0 +1,142 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+#
+# homura static-asset embedder.
+#
+# Cloudflare Workers has no filesystem, so Sinatra's `static!` (which
+# calls `File.file?` + `send_file`) returns 404 for every asset.
+# This script reads every file under `public/` at build time, wraps
+# the content in a Ruby Hash constant, and generates a Rack middleware
+# that serves matching paths directly from memory.
+#
+# Usage:
+#   ruby bin/compile-assets --input public --output build/homura_assets.rb --namespace HomuraAssets
+
+require 'fileutils'
+require 'optparse'
+
+MIME_TYPES = {
+  '.css'  => 'text/css; charset=utf-8',
+  '.js'   => 'application/javascript; charset=utf-8',
+  '.json' => 'application/json; charset=utf-8',
+  '.html' => 'text/html; charset=utf-8',
+  '.svg'  => 'image/svg+xml',
+  '.png'  => 'image/png',
+  '.jpg'  => 'image/jpeg',
+  '.jpeg' => 'image/jpeg',
+  '.gif'  => 'image/gif',
+  '.ico'  => 'image/x-icon',
+  '.woff' => 'font/woff',
+  '.woff2'=> 'font/woff2',
+  '.txt'  => 'text/plain; charset=utf-8',
+  '.xml'  => 'application/xml; charset=utf-8',
+  '.webp' => 'image/webp',
+  '.map'  => 'application/json',
+}.freeze
+
+def mime_for(path)
+  ext = File.extname(path).downcase
+  MIME_TYPES[ext] || 'application/octet-stream'
+end
+
+HELP = <<~USAGE
+  Usage:
+    ruby bin/compile-assets [--input DIR] [--output FILE] [--namespace NAME]
+
+  Defaults (Phase 15-A homura):
+    --input public --output build/homura_assets.rb --namespace HomuraAssets
+USAGE
+
+if ARGV.include?('-h') || ARGV.include?('--help')
+  puts HELP
+  exit 0
+end
+
+options = {
+  input_dir: 'public',
+  output: 'build/homura_assets.rb',
+  namespace: 'HomuraAssets'
+}
+
+OptionParser.new do |op|
+  op.banner = 'Usage: bin/compile-assets [options]'
+  op.on('--input DIR', 'Root directory to embed (recursive)') { |d| options[:input_dir] = d }
+  op.on('--output PATH', 'Generated Ruby output path') { |p| options[:output] = p }
+  op.on('--namespace NAME', 'Ruby module name') { |n| options[:namespace] = n }
+end.parse!
+
+public_dir = File.join(Dir.pwd, options[:input_dir])
+unless File.directory?(public_dir)
+  warn "compile-assets: no directory #{public_dir.inspect}"
+  exit 1
+end
+
+ns = options[:namespace]
+
+files = Dir.glob(File.join(public_dir, '**', '*')).select { |f| File.file?(f) }.sort
+if files.empty?
+  warn 'compile-assets: directory is empty'
+  exit 1
+end
+
+out_path = options[:output]
+FileUtils.mkdir_p(File.dirname(out_path))
+
+File.open(out_path, 'w') do |io|
+  io.puts <<~RUBY
+    # frozen_string_literal: true
+    # Auto-generated by bin/compile-assets — DO NOT EDIT BY HAND.
+    #
+    # Embeds every file under #{options[:input_dir]}/ as a Ruby constant, then installs a
+    # Rack middleware that serves matching paths before they reach Sinatra.
+    # This replaces Sinatra's `static!` (which needs a real filesystem)
+    # with an in-memory lookup that works on Cloudflare Workers.
+
+    module #{ns}
+      ASSETS = {}
+
+      class Middleware
+        def initialize(app)
+          @app = app
+        end
+
+        def call(env)
+          path = env['PATH_INFO']
+          if (asset = #{ns}::ASSETS[path])
+            headers = {
+              'content-type'   => asset[:content_type],
+              'content-length' => asset[:body].bytesize.to_s,
+              'cache-control'  => 'public, max-age=3600',
+            }
+            [200, headers, [asset[:body]]]
+          else
+            @app.call(env)
+          end
+        end
+      end
+    end
+  RUBY
+
+  files.each do |full_path|
+    rel = full_path.sub(public_dir, '')        # e.g. "/style.css"
+    content = File.read(full_path)
+    ct = mime_for(full_path)
+
+    io.puts
+    io.puts "# #{rel} (#{content.bytesize} bytes)"
+    io.puts "#{ns}::ASSETS[#{rel.inspect}] = {"
+    io.puts "  content_type: #{ct.inspect},"
+    io.puts "  body: #{content.inspect}"
+    io.puts "}"
+  end
+
+  io.puts <<~RUBY
+
+    # Auto-install the middleware on Sinatra::Base if Sinatra is loaded.
+    if defined?(::Sinatra::Base)
+      ::Sinatra::Base.use #{ns}::Middleware
+    end
+  RUBY
+end
+
+warn "compile-assets: wrote #{out_path} (#{files.size} assets, #{File.size(out_path)} bytes)"