sync: update from private repo (2336949a)

docs/tools/workspace-apps.md

@@ -82,6 +82,14 @@ await call({ type: 'deleteFile', path: 'output/old.txt' });             // 削
 
 `apps/{name}/app.json`（任意）で一覧の表示名・説明・エントリを指定できる（無ければフォルダ名）。
 
+利用者が「アプリ」タブの「アプリを追加」で手元の HTML を持ち込んだアプリも同じ `apps/` に並ぶ。
+その場合 `app.json` は追加時に `{ title, description: "", entry: "index.html" }` の形で自動生成される
+（`title` は HTML の `<title>`、無ければフォルダ名）。手で置いたアプリには `app.json` が無いこともあるので、
+一覧・起動のどちらも `app.json` の有無に依存しないこと。持ち込みは自動 E2E テストを通らないため、
+ブラウザ内の保存（localStorage 等）・ダウンロード・ファイル選択・新窓に頼る HTML はサンドボックスで
+そのままでは動かない。持ち込まれたアプリの修正を頼まれたら、ブラウザ内の保存は上のブリッジ API
+（`apps/{name}/data/` への `writeFile` / `readFile`）に置き換える。
+
 ## E2E テスト（verify ステップ）
 
 `workspace-app` ピースの verify ステップは、作成したアプリを **`TestWorkspaceApp` ツールで自動 E2E テスト** する。