chocomint 1.0.2 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c1e486a61190ec1d3548de09e65d74ea64d42a664c3d536c0e8013f61e6e2c1c
-  data.tar.gz: b7e23eedd909b6d2dffaeaa341721e7ccbd3bc91a2556a87d2654991c9475443
+  metadata.gz: 691a0248c4e919afa5640c7398b3f1b06221c397ac2c1e4c73fb56c044174246
+  data.tar.gz: 5371ad706155faff73120e8064f6629b7a776099e7c66fc5f07a89bfec932799
 SHA512:
-  metadata.gz: 5234597d4d58068f04609037aaf53d058b48a0ddfea9a12240cc64c84ace0371b5277aee1442dcea8e1b8239449a7da0e32f976aca1672f4da3b5dfa90ee6645
-  data.tar.gz: e42a3f878d613ce09722db0929d745d3aaf3fdda93698eeb691203834063a9bf3090d10bf5aca20f7797391b76305885fcf89c63e6c03c67ae58580520a46704
+  metadata.gz: 75558e5f77a42aaaddaa2ffdfc5a509975cf7660ae5eaf346d9e5e24d45ce3873783f23e924b5516a6341db2f405e3ac1bd3688bf7677cc9fe0ec0074a5a352c
+  data.tar.gz: 0b43f17a5b4f916798db9107c3cef61d21f07da1299723a3feb1e31de43231f521bfc8e4bdfc560ff6dd1b65f9546819b61fb79e9263c90ef89796984cac48c9

data/README.md

@@ -191,11 +191,37 @@ ruby bin/chocomint-server
 |----------------|------|
 | `GET /edit` | エディタ画面 |
 | `GET /edit/files` | `workspace/` のファイル一覧 (JSON) |
-| `GET /edit/file?path=` | ファイル内容 (JSON) |
+| `GET /edit/file?path=` | ファイル内容 (JSON)。画像/PDF/動画/音声は `media` 種別だけ返す |
+| `GET /edit/raw?path=` | 生ファイル配信（メディアプレビュー用。`Range` 対応で動画のシークも可） |
+| `GET /edit/archive?path=` | アーカイブの第一階層エントリ + メタデータ（zip / tar / tar.gz / bz2 等） |
 | `POST /edit/save` | 人手編集の保存（`PathGuard` で `workspace/` 内に限定） |
 | `POST /edit/chat` | 自然言語指示で AI 編集（`Planner#run`。`expectations` に指示を渡すため意味的検証が効く） |
 | `GET /edit/assets/*` | Monaco / xterm.js のローカル同梱アセット |
 
+### メディアプレビュー
+
+テキストファイルは Monaco で編集し、以下のメディアはタブ内でプレビューする
+（`workspace/` 配下のみ・`PathGuard` で保護）:
+
+- **画像**: PNG / JPEG / GIF / WebP / BMP / ICO / AVIF / TIFF / SVG（ベクター）
+- **文書**: PDF（ブラウザ内蔵ビューアで表示）
+- **動画**: MP4 / WebM / MKV / MOV / AVI / OGV（`<video>`。ブラウザが対応する形式のみ再生可）
+- **音声**: MP3 / WAV / OGG / M4A / AAC / FLAC / Opus（`<audio>`）
+
+動画・音声は `Range` リクエストに対応し、シークやストリーミング再生ができる。
+ブラウザがコーデック非対応の形式（MKV の一部など）は再生できずメッセージを表示する。
+
+### アーカイブプレビュー
+
+zip / tar 系アーカイブをクリックすると、**第一階層（トップレベル）のエントリと
+メタデータ**（エントリ数・展開後サイズ・圧縮サイズ）をタブ内に表示する。展開は
+サーバー側でメモリ上に行い、ディスクには書き出さない。
+
+- **対応**: `.zip` / `.tar` / `.tar.gz`（`.tgz`）/ `.gz` / `.tar.bz2`（`.tbz2`）/ `.bz2`
+- 配下のエントリは親ディレクトリに畳み、その配下件数を添えて表示する。
+- `.zip` は中央ディレクトリを自前パースするため rubyzip 非依存。`.bz2` は純Ruby
+  実装の `rbzip2` で展開する（ネイティブ `libbz2` 不要）。
+
 ### 追加依存
 
 - `ffi` — Windows の擬似コンソール (ConPTY) を FFI で叩く（プリビルド gem、DevKit 不要）。

data/THIRD_PARTY_LICENSES.md

@@ -41,5 +41,6 @@ AI エディタ (`/edit`) をオフラインで動作させるため、以下を
 | 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 |
+| rbzip2 | BSD-3-Clause | https://github.com/koraktor/rbzip2 |
 
 上記はいずれも再配布・商用利用を許容する寛容なライセンスである。

data/lib/chocomint/edit_archive_handlers.rb

@@ -0,0 +1,323 @@
+# frozen_string_literal: true
+
+require "json"
+require "zlib"
+require "stringio"
+require "rubygems/package"
+
+module Chocomint
+  # /edit AI エディタのアーカイブプレビュー用ハンドラ (Server に include して使う)。
+  #
+  # 提供機能:
+  #   GET /edit/archive?path=foo.zip   アーカイブの第一階層エントリ + メタデータ (JSON)
+  #
+  # 対応形式: .zip / .tar / .tar.gz (.tgz) / .gz / .tar.bz2 (.tbz2) / .bz2
+  # いずれも展開はメモリ上で行い、ディスクには書き出さない。tar/zip はエントリを
+  # ストリーム走査し、第一階層 (トップレベル) だけに畳んで返す。
+  #
+  # 対応形式は拡張子でしか判定しない (中身の magic は見ない)。ファイルアクセスは
+  # すべて @path_guard 経由で workspace 内に制限する。
+  module EditArchiveHandlers
+    # 一覧をブラウザで扱える範囲に抑えるためのエントリ数上限 (走査自体の安全弁)。
+    # tar は全走査するため、巨大アーカイブでも到達したら打ち切って capped を立てる。
+    MAX_ARCHIVE_ENTRIES = 20_000
+
+    # bzip2 展開に許す入力サイズ上限 (純Ruby 実装は重いので極端に巨大な .bz2 は弾く)。
+    MAX_BZIP2_INPUT_BYTES = 64 * 1024 * 1024
+
+    def handle_edit_archive(req, res)
+      return edit_method_guard(res) unless req.request_method == "GET"
+
+      path = req.query["path"].to_s
+      return edit_json(res, 400, "error" => "path required") if path.empty?
+
+      abs = @path_guard.resolve(path)
+      return edit_json(res, 404, "error" => "no such file") unless File.file?(abs)
+
+      kind = archive_kind(abs)
+      return edit_json(res, 415, "error" => "unsupported archive format") unless kind
+
+      info = inspect_archive(abs, kind)
+      edit_json(res, 200, { "path" => path }.merge(info))
+    rescue Chocomint::PathAccessError => e
+      edit_json(res, 403, "error" => e.message)
+    rescue ArchiveError => e
+      # 壊れている/未対応の内部構造など。UI 向けにメッセージを返す (500 にはしない)。
+      edit_json(res, 422, "error" => e.message)
+    rescue Chocomint::Error => e
+      edit_json(res, 500, "error" => e.message)
+    end
+
+    # アーカイブ処理中の想定内エラー (壊れたデータ・展開失敗など)。
+    class ArchiveError < StandardError; end
+
+    # ---- 形式判定 -----------------------------------------------------------
+
+    # 拡張子からアーカイブ形式を判定して種別文字列を返す (非対応は nil)。
+    # 種別: "zip" / "tar" / "tar.gz" / "tar.bz2" / "gz" / "bz2"
+    # 二重拡張子 (.tar.gz 等) を単一拡張子 (.gz) より優先する。
+    def archive_kind(abs)
+      lower = File.basename(abs).downcase
+      return "tar.gz" if lower.end_with?(".tar.gz")
+      return "tar.gz" if lower.end_with?(".tgz")
+      return "tar.bz2" if lower.end_with?(".tar.bz2")
+      return "tar.bz2" if lower.end_with?(".tbz2") || lower.end_with?(".tbz")
+      return "zip" if lower.end_with?(".zip")
+      return "tar" if lower.end_with?(".tar")
+      return "gz" if lower.end_with?(".gz")
+      return "bz2" if lower.end_with?(".bz2")
+
+      nil
+    end
+
+    # フロントがメディア/アーカイブを区別できるよう、handle_edit_file からも使う判定。
+    def archive?(abs)
+      !archive_kind(abs).nil?
+    end
+
+    # ---- 検査 (種別ごとにディスパッチ) --------------------------------------
+
+    def inspect_archive(abs, kind)
+      case kind
+      when "zip"                 then inspect_zip(abs)
+      when "tar"                 then inspect_tar(File.binread(abs))
+      when "tar.gz"              then inspect_tar(gunzip(File.binread(abs)))
+      when "tar.bz2"             then inspect_tar(bunzip2(abs))
+      when "gz"                  then inspect_single_compressed(abs, "gzip", strip_ext: ".gz")
+      when "bz2"                 then inspect_single_compressed(abs, "bzip2", strip_ext: ".bz2")
+      else
+        raise ArchiveError, "unsupported archive format"
+      end
+    end
+
+    # ---- tar の走査 ---------------------------------------------------------
+    #
+    # 展開済み tar バイト列を走査し、第一階層に畳んだ entries とメタデータを返す。
+    def inspect_tar(tar_bytes)
+      dirs = {}   # トップレベルのディレクトリ名 => 配下エントリ数
+      files = []  # トップレベルの直下ファイル { name, size }
+      total = 0
+      total_size = 0
+      capped = false
+
+      Gem::Package::TarReader.new(StringIO.new(tar_bytes)) do |reader|
+        reader.each do |entry|
+          name = entry.full_name.to_s
+          next if name.empty? || name == "./"
+
+          total += 1
+          if total > MAX_ARCHIVE_ENTRIES
+            capped = true
+            break
+          end
+
+          rel = normalize_entry_name(name)
+          next if rel.empty?
+
+          size = entry.header.size.to_i
+          total_size += size unless entry.directory?
+          accumulate_top_level(rel, entry.directory?, size, dirs, files)
+        end
+      end
+
+      build_result(dirs, files, total, total_size, capped)
+    rescue Gem::Package::TarInvalidError, Zlib::GzipFile::Error => e
+      raise ArchiveError, "tar を読み取れませんでした: #{e.message}"
+    end
+
+    # ---- zip の走査 (中央ディレクトリを自前パース) --------------------------
+    #
+    # 標準ライブラリだけで済ませるため rubyzip には依存せず、ZIP の End Of Central
+    # Directory (EOCD) → Central Directory を辿ってエントリ名とサイズを読む。
+    # 実データ (ローカルファイルヘッダ) は読まないので大きな zip でも軽い。
+    def inspect_zip(abs)
+      raw = File.binread(abs)
+      cd = zip_central_directory(raw)
+
+      dirs = {}
+      files = []
+      total = 0
+      total_size = 0
+      capped = false
+
+      cd.each do |ent|
+        total += 1
+        if total > MAX_ARCHIVE_ENTRIES
+          capped = true
+          break
+        end
+        rel = normalize_entry_name(ent[:name])
+        next if rel.empty?
+
+        total_size += ent[:size] unless ent[:dir]
+        accumulate_top_level(rel, ent[:dir], ent[:size], dirs, files)
+      end
+
+      build_result(dirs, files, total, total_size, capped)
+    end
+
+    # ZIP の中央ディレクトリを読み、各エントリの { name, size, dir } を返す。
+    def zip_central_directory(raw)
+      eocd = find_eocd(raw)
+      raise ArchiveError, "zip の終端レコードが見つかりません" unless eocd
+
+      count = raw[eocd + 10, 2].unpack1("v")
+      offset = raw[eocd + 16, 4].unpack1("V")
+      entries = []
+      pos = offset
+
+      count.times do
+        break if pos + 46 > raw.bytesize
+        sig = raw[pos, 4]
+        break unless sig == "PK\x01\x02".b # Central Directory File Header
+
+        usize = raw[pos + 24, 4].unpack1("V")          # uncompressed size
+        name_len = raw[pos + 28, 2].unpack1("v")
+        extra_len = raw[pos + 30, 2].unpack1("v")
+        comment_len = raw[pos + 32, 2].unpack1("v")
+        name = raw[pos + 46, name_len].to_s
+        name = zip_decode_name(name)
+        entries << { name: name, size: usize, dir: name.end_with?("/") }
+        pos += 46 + name_len + extra_len + comment_len
+      end
+
+      entries
+    end
+
+    # EOCD (End Of Central Directory, シグネチャ PK\x05\x06) を末尾から探す。
+    # ZIP コメントは最大 65535 バイトなので、末尾 (22 + 65535) だけ後方走査すれば十分。
+    def find_eocd(raw)
+      sig = "PK\x05\x06".b
+      min = [raw.bytesize - (22 + 0xFFFF), 0].max
+      i = raw.bytesize - 22
+      while i >= min
+        return i if raw[i, 4] == sig
+
+        i -= 1
+      end
+      nil
+    end
+
+    # zip のエントリ名を文字列に整える。UTF-8 として妥当ならそれ、駄目なら置換して壊さない。
+    def zip_decode_name(name)
+      s = name.dup.force_encoding("UTF-8")
+      s.valid_encoding? ? s : s.scrub("?")
+    end
+
+    # ---- 単体圧縮ファイル (.gz / .bz2、tar でない) --------------------------
+    #
+    # tar を含まない単なる圧縮ファイルは、展開後の 1 ファイルとして扱う。
+    # 中身の全展開は避け、メタデータ (圧縮/展開サイズ・推定名) だけを返す。
+    def inspect_single_compressed(abs, algorithm, strip_ext:)
+      compressed_size = File.size(abs)
+      inner_name = File.basename(abs)
+      inner_name = inner_name[0...-strip_ext.length] if inner_name.downcase.end_with?(strip_ext)
+
+      uncompressed_size =
+        case algorithm
+        when "gzip"  then gzip_uncompressed_size(abs)
+        when "bzip2" then bunzip2(abs).bytesize
+        end
+
+      {
+        "archive" => algorithm == "gzip" ? "gz" : "bz2",
+        "single" => true,
+        "entries" => [{ "name" => inner_name, "dir" => false, "size" => uncompressed_size }],
+        "total_entries" => 1,
+        "total_size" => uncompressed_size,
+        "compressed_size" => compressed_size,
+        "capped" => false
+      }
+    end
+
+    # ---- 展開ヘルパ ---------------------------------------------------------
+
+    def gunzip(bytes)
+      Zlib::GzipReader.new(StringIO.new(bytes)).read
+    rescue Zlib::GzipFile::Error => e
+      raise ArchiveError, "gzip を展開できませんでした: #{e.message}"
+    end
+
+    # gzip 末尾 4 バイトの ISIZE (展開後サイズ mod 2^32)。4GB 未満の実用ケース向け。
+    def gzip_uncompressed_size(abs)
+      tail = File.open(abs, "rb") { |f| f.seek(-4, IO::SEEK_END); f.read(4) }
+      tail ? tail.unpack1("V") : nil
+    rescue SystemCallError
+      nil
+    end
+
+    # bzip2 を純Ruby (rbzip2) で展開する。ネイティブ libbz2 は不要。
+    def bunzip2(abs)
+      require "rbzip2"
+      raw = File.binread(abs)
+      if raw.bytesize > MAX_BZIP2_INPUT_BYTES
+        raise ArchiveError, "bzip2 ファイルが大きすぎます (上限 #{MAX_BZIP2_INPUT_BYTES / (1024 * 1024)}MB)"
+      end
+
+      RBzip2.default_adapter::Decompressor.new(StringIO.new(raw)).read
+    rescue LoadError
+      raise ArchiveError, "bzip2 の展開には rbzip2 gem が必要です"
+    rescue ArchiveError
+      raise
+    rescue StandardError => e
+      raise ArchiveError, "bzip2 を展開できませんでした: #{e.message}"
+    end
+
+    # ---- 集計の共通処理 -----------------------------------------------------
+
+    # エントリ名を正規化する ("./" 前置や重複スラッシュを除く。先頭は相対に統一)。
+    def normalize_entry_name(name)
+      s = name.tr("\\", "/")
+      s = s.sub(%r{\A\./}, "")
+      s = s.sub(%r{\A/+}, "")
+      s.gsub(%r{/+}, "/")
+    end
+
+    # 正規化済みエントリを「第一階層」に畳んで dirs / files に足し込む。
+    #   "src/main.rb" → トップレベル dir "src" を登録し配下件数 +1
+    #   "README.md"   → トップレベル直下 file "README.md"
+    #   "src/"        → dir "src" を登録するだけ (ディレクトリ自身なので件数は増やさない)
+    #   "emptydir/"   → dir "emptydir" を件数 0 で登録 (空ディレクトリ)
+    def accumulate_top_level(rel, is_dir, size, dirs, files)
+      # 末尾スラッシュはディレクトリ自身のエントリ。区切りとしての "/" と区別する。
+      trailing_dir = rel.end_with?("/")
+      trimmed = trailing_dir ? rel.chomp("/") : rel
+      slash = trimmed.index("/")
+
+      if slash.nil?
+        # トップレベル直下のエントリ (ファイル or ディレクトリ自身)。
+        if is_dir || trailing_dir
+          dirs[trimmed] ||= 0 # 件数は増やさない (自身の登録だけ)。
+        else
+          files << { name: trimmed, size: size }
+        end
+      else
+        # 配下エントリ → トップレベルのディレクトリに畳んで件数を +1。
+        top = trimmed[0...slash]
+        dirs[top] ||= 0
+        dirs[top] += 1
+      end
+    end
+
+    # dirs / files から JSON 用の結果ハッシュを組み立てる。
+    # entries はディレクトリ→ファイルの順、各名前順 (一覧の並びに揃える)。
+    def build_result(dirs, files, total, total_size, capped)
+      dir_entries = dirs.keys.sort.map do |name|
+        { "name" => name, "dir" => true, "child_count" => dirs[name] }
+      end
+      # 同名ファイルの重複は稀だが、名前順で安定させる。
+      file_entries = files.uniq { |f| f[:name] }
+                          .sort_by { |f| f[:name] }
+                          .map { |f| { "name" => f[:name], "dir" => false, "size" => f[:size] } }
+
+      {
+        "archive" => "tar_or_zip",
+        "single" => false,
+        "entries" => dir_entries + file_entries,
+        "total_entries" => total,
+        "total_size" => total_size,
+        "capped" => capped
+      }
+    end
+  end
+end