ima2-gen 1.0.10 → 1.1.0

package/docs/API.md

@@ -0,0 +1,189 @@
+# API Reference
+
+This document lists the local HTTP API exposed by `ima2 serve`.
+
+Base URL:
+
+```text
+http://localhost:3333
+```
+
+## Provider Policy
+
+Image generation is OAuth-only in the current build.
+
+- `provider: "oauth"` is the supported generation path.
+- `provider: "api"` returns `403` with `APIKEY_DISABLED` for image generation, edit, and node generation.
+- API keys may still be used by auxiliary developer paths such as billing checks or style-sheet extraction.
+
+## Health And Status
+
+| Method | Path | Notes |
+|---|---|---|
+| `GET` | `/api/health` | Server health, version, paths, provider policy |
+| `GET` | `/api/providers` | Provider availability; API-key generation is disabled |
+| `GET` | `/api/oauth/status` | OAuth proxy status and visible models |
+| `GET` | `/api/billing` | Billing/status probe, including API key source when configured |
+
+## In-Flight Jobs
+
+| Method | Path | Notes |
+|---|---|---|
+| `GET` | `/api/inflight` | Active jobs only by default |
+| `GET` | `/api/inflight?includeTerminal=1` | Includes recent terminal jobs for debugging |
+| `DELETE` | `/api/inflight/:requestId` | Cancel or forget an active job |
+
+In-flight logs and responses use `requestId` for correlation. Logs should not include raw prompts, reference data URLs, generated base64, tokens, cookies, auth headers, or raw upstream bodies.
+
+## Generation
+
+### `POST /api/generate`
+
+Text-to-image and reference-guided root generation.
+
+```json
+{
+  "prompt": "a shiba in space",
+  "quality": "medium",
+  "size": "1024x1024",
+  "format": "png",
+  "moderation": "low",
+  "provider": "oauth",
+  "model": "gpt-5.4",
+  "references": [],
+  "requestId": "optional-client-id"
+}
+```
+
+Supported quality values: `low`, `medium`, `high`.
+
+Supported moderation values: `auto`, `low`.
+
+Recommended model: `gpt-5.4`. Current app default: `gpt-5.4-mini`. `gpt-5.5` is the strongest quality option when supported, but callers should expect higher quota pressure and possible Codex CLI/backend capability requirements.
+
+### `POST /api/edit`
+
+Image edit / image-to-image generation.
+
+The request includes a prompt and image payload. Like `/api/generate`, this route rejects `provider: "api"` unless API-key image generation is intentionally implemented in code.
+
+### `POST /api/node/generate`
+
+Node-mode generation and child edits.
+
+Body fields:
+
+```json
+{
+  "parentNodeId": "optional-server-node-id",
+  "prompt": "continue this image",
+  "quality": "medium",
+  "size": "1024x1024",
+  "format": "png",
+  "moderation": "low",
+  "model": "gpt-5.4",
+  "references": [],
+  "externalSrc": "optional-history-url",
+  "sessionId": "session-id",
+  "clientNodeId": "client-node-id",
+  "requestId": "request-id",
+  "provider": "oauth"
+}
+```
+
+When `parentNodeId` is present, the server loads the stored parent node image and uses the edit path. Extra node references are currently supported only for root nodes.
+
+The route can stream Server-Sent Events when the client sends `Accept: text/event-stream`. Possible events include `phase`, `partial`, `done`, and `error`.
+
+### `GET /api/node/:nodeId`
+
+Fetch stored node metadata and asset URL.
+
+## Reference Images
+
+Reference uploads are capped at 5 items. The frontend compresses large JPEG/PNG files before sending them. HEIC/HEIF files are rejected with a user-facing conversion hint.
+
+Server-side validation may return these reference codes:
+
+| Code | Meaning |
+|---|---|
+| `REF_NOT_ARRAY` | `references` was not an array |
+| `REF_TOO_MANY` | More than the configured reference count |
+| `REF_NOT_STRING` | A reference item was not a string |
+| `REF_EMPTY` | A reference item was empty |
+| `REF_TOO_LARGE` | A reference exceeded the configured base64 size |
+| `REF_NOT_BASE64` | A reference was not valid base64 |
+
+## History
+
+| Method | Path | Notes |
+|---|---|---|
+| `GET` | `/api/history` | List generated assets |
+| `GET` | `/api/history?groupBy=session` | Group assets by session title |
+| `DELETE` | `/api/history/:filename` | Tombstone a generated asset |
+| `POST` | `/api/history/:filename/restore` | Restore a recently deleted asset |
+
+History rows can include node metadata such as `sessionId`, `nodeId`, `clientNodeId`, `requestId`, and `refsCount`.
+
+## Sessions And Graphs
+
+| Method | Path | Notes |
+|---|---|---|
+| `GET` | `/api/sessions` | List graph sessions |
+| `POST` | `/api/sessions` | Create a session |
+| `GET` | `/api/sessions/:id` | Load a session and graph |
+| `PATCH` | `/api/sessions/:id` | Rename a session |
+| `DELETE` | `/api/sessions/:id` | Delete a session |
+| `PUT` | `/api/sessions/:id/graph` | Save graph snapshot |
+
+`PUT /api/sessions/:id/graph` requires an `If-Match` header containing the current graph version.
+
+Version mismatch returns `GRAPH_VERSION_CONFLICT` and the current version. This only means the client saved against a stale graph version; it is not proof that another browser tab changed the graph.
+
+Graph save requests may include observability headers:
+
+```text
+X-Ima2-Graph-Save-Id
+X-Ima2-Graph-Save-Reason
+X-Ima2-Tab-Id
+```
+
+## Style Sheets
+
+| Method | Path | Notes |
+|---|---|---|
+| `GET` | `/api/sessions/:id/style-sheet` | Load session style sheet |
+| `PUT` | `/api/sessions/:id/style-sheet` | Save style sheet |
+| `PATCH` | `/api/sessions/:id/style-sheet/enabled` | Toggle style sheet usage |
+| `POST` | `/api/sessions/:id/style-sheet/extract` | Extract style fields from prompt/reference |
+
+Style-sheet extraction can require an API key/openai client. This does not reopen API-key image generation.
+
+## Common Error Codes
+
+| Code | Meaning |
+|---|---|
+| `APIKEY_DISABLED` | API-key image generation is disabled |
+| `INVALID_IMAGE_MODEL` | Model name is unknown or unsupported |
+| `IMAGE_MODEL_UNSUPPORTED` | Model exists but cannot use image generation |
+| `INVALID_MODERATION` | Moderation value is not `auto` or `low` |
+| `SAFETY_REFUSAL` | Upstream safety refusal |
+| `MODERATION_REFUSED` | Content generation refused by moderation |
+| `AUTH_CHATGPT_EXPIRED` | Codex/ChatGPT OAuth session expired |
+| `AUTH_API_KEY_INVALID` | API key is invalid, revoked, out of quota, or wrong org |
+| `NETWORK_FAILED` | Network, proxy, VPN, or firewall failure |
+| `OAUTH_UNAVAILABLE` | Local OAuth proxy is not available |
+| `GRAPH_VERSION_REQUIRED` | Missing graph `If-Match` header |
+| `GRAPH_VERSION_CONFLICT` | Stale graph version |
+| `GRAPH_TOO_LARGE` | Graph exceeds node/edge limits |
+| `NODE_NOT_FOUND` | Node metadata was not found |
+
+## CLI Discovery
+
+The server writes an advertisement file at:
+
+```text
+~/.ima2/server.json
+```
+
+CLI commands such as `ima2 ping`, `ima2 gen`, and `ima2 ls` use this file unless `--server` or `IMA2_SERVER` is provided.

package/docs/README.ja.md

@@ -0,0 +1,182 @@
+# ima2-gen
+
+[![npm version](https://img.shields.io/npm/v/ima2-gen)](https://www.npmjs.com/package/ima2-gen)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](../LICENSE)
+
+> **他の言語で読む**: [English](../README.md) · [한국어](README.ko.md) · [简体中文](README.zh-CN.md)
+
+`ima2-gen` は、ChatGPT/Codex OAuth の画像生成ワークフローをローカルの小さなデスクトップアプリのように使える画像生成スタジオです。
+
+`npx` で起動し、Codex OAuth でログインして、プロンプトを書きながら履歴、参照画像、スタイルシート、ノード分岐で反復できます。通常の画像生成には OpenAI API key は不要です。
+
+![プロンプト入力、生成画像、モデル表示、結果メタデータが見える ima2-gen classic 画面](../assets/screenshots/classic-generate-light.png)
+
+## Quick Start
+
+```bash
+npx ima2-gen serve
+```
+
+その後、`http://localhost:3333` を開きます。
+
+Codex にまだログインしていない場合:
+
+```bash
+npx @openai/codex login
+npx ima2-gen serve
+```
+
+グローバルインストールもできます。
+
+```bash
+npm install -g ima2-gen
+ima2 serve
+```
+
+## できること
+
+- **Classic mode**: すばやく生成し、編集し、現在の画像を次の参照として使えます。
+- **Node mode**: 良い画像を起点に、複数の方向へ分岐して試せます。
+- **Local gallery**: 生成物をローカルに保存し、セッションごとの履歴として確認できます。
+- **Reference images**: 参照画像を drag/drop、paste、file picker で追加できます。大きな画像は送信前に圧縮されます。
+- **Style sheets**: 一度決めた見た目の方向性を classic/node プロンプトに再利用できます。
+- **Observable jobs**: 進行中の生成と最近の生成を request ID で追跡できます。
+
+## 画像生成は OAuth 専用です
+
+現在の画像生成は、ローカルの Codex/ChatGPT OAuth 経路で実行されます。
+
+API key が env/config に存在していても、billing 確認や style-sheet 抽出などの補助機能に使われるだけです。生成エンドポイントで `provider: "api"` を送ると `APIKEY_DISABLED` が返ります。
+
+Settings に **Configured but disabled** と表示される場合、API key は検出されていますが、画像生成は OAuth で動いているという意味です。
+
+![OAuth active と API key disabled の状態を示す settings 画面](../assets/screenshots/settings-oauth-generation.png)
+
+## モデルの選び方
+
+安定したバランスを重視するなら、まず **`gpt-5.4`** をおすすめします。
+
+- `gpt-5.4` — 推奨のバランス型モデル。
+- `gpt-5.4-mini` — 現在のアプリ既定値で、速い下書き向きです。
+- `gpt-5.5` — 対応環境では最も高品質な選択肢です。ただし使用量の消費が大きくなる場合があり、Codex CLI の更新やアカウント/バックエンド側の image capability が必要になることがあります。
+
+Quality は `low`, `medium`, `high`、moderation は `auto`, `low` をサポートします。
+
+## ワークフロー
+
+### Classic mode
+
+1枚をすばやく作って調整したいときに使います。
+
+1. プロンプトを書きます。
+2. 必要なら参照画像を追加します。
+3. モデル、quality、size、format、moderation を選びます。
+4. 生成後、copy、download、continue を選べます。
+
+### Node mode
+
+アイデアを枝分かれさせながら比較したいときに使います。
+
+![接続された生成カードとノードごとのメタデータが見える Node mode 画面](../assets/screenshots/node-graph-branching.png)
+
+各ノードは独自のプロンプトと結果を持ちます。ルートノードにはローカル参照画像を付けられ、子ノードは親画像をソースとして使います。完了した生成は request ID で再接続されるため、リロードや graph version conflict の後でも結果を復元できます。
+
+### Settings と Style sheets
+
+Settings workspace は、アカウント、モデル、テーマ、言語設定を生成パネルから分離します。
+
+![Account と Generation model controls が見える Settings workspace](../assets/screenshots/settings-workspace.png)
+
+Style sheet は、繰り返し使いたい視覚方向を保存するための機能です。
+
+![medium, composition, mood, subject, palette, negative fields を持つ style sheet editor](../assets/screenshots/style-sheet-editor.png)
+
+## CLI commands
+
+### Server
+
+| Command | Description |
+|---|---|
+| `ima2 serve` | ローカル Web サーバーを起動 |
+| `ima2 setup` | 認証設定を再構成 |
+| `ima2 status` | config と OAuth 状態を表示 |
+| `ima2 doctor` | Node、package、config、auth を診断 |
+| `ima2 open` | Web UI を開く |
+| `ima2 reset` | 保存済み config を削除 |
+
+### Client
+
+以下は `ima2 serve` が起動しているときに使えます。
+
+| Command | Description |
+|---|---|
+| `ima2 gen <prompt>` | CLI から画像生成 |
+| `ima2 edit <file> --prompt <text>` | 既存画像を編集 |
+| `ima2 ls` | ローカル履歴を表示 |
+| `ima2 show <name>` | 生成ファイルを開く |
+| `ima2 ps` | 進行中ジョブを表示 |
+| `ima2 ping` | 実行中サーバーを確認 |
+
+サーバーポートは `~/.ima2/server.json` に保存されます。`--server <url>` または `IMA2_SERVER=http://localhost:3333` で上書きできます。
+
+## Configuration
+
+優先順位:
+
+```text
+environment variables > ~/.ima2/config.json > built-in defaults
+```
+
+| Variable | Default | Description |
+|---|---:|---|
+| `IMA2_PORT` / `PORT` | `3333` | Web server port |
+| `IMA2_OAUTH_PROXY_PORT` / `OAUTH_PORT` | `10531` | OAuth proxy port |
+| `IMA2_SERVER` | — | CLI target override |
+| `IMA2_CONFIG_DIR` | `~/.ima2` | Config and SQLite location |
+| `IMA2_GENERATED_DIR` | `~/.ima2/generated` | Generated image directory |
+| `IMA2_NO_OAUTH_PROXY` | — | `1` で OAuth proxy の自動起動を無効化 |
+| `IMA2_INFLIGHT_TERMINAL_TTL_MS` | `30000` | デバッグ用の recent job retention |
+| `OPENAI_API_KEY` | — | 補助機能用。画像生成用ではありません |
+
+## API Reference
+
+Endpoint 一覧は [API Reference](API.md) に分離しました。
+
+## Troubleshooting
+
+**`ima2 ping` が server unreachable になる**
+まず `ima2 serve` を起動し、`~/.ima2/server.json` を確認してください。`ima2 ping --server http://localhost:3333` も使えます。
+
+**OAuth login がうまくいかない**
+`npx @openai/codex login` を実行し、`ima2 status` を確認してから `ima2 serve` を再起動してください。
+
+**画像生成が `APIKEY_DISABLED` で失敗する**
+この build では OAuth で生成してください。API-key image generation は意図的に無効化されています。
+
+**大きな参照画像が失敗する**
+JPEG/PNG は送信前に自動圧縮されます。それでも失敗する場合は、解像度を下げた JPEG/PNG に変換してください。HEIC/HEIF は browser path ではサポートしていません。
+
+**更新後に以前のギャラリー画像が見えない**
+最近のバージョンでは、生成画像の保存先がインストール済みパッケージ内から `~/.ima2/generated` に移動しました。`ima2 doctor` を実行し、[古い画像の復旧ガイド](RECOVER_OLD_IMAGES.md) を確認してください。
+
+**`gpt-5.5` だけ失敗する**
+まず Codex CLI を最新版に更新してから再試行してください。それでも失敗する場合は、現在のアカウントやバックエンド経路で `gpt-5.5` の image capability または使用量枠がまだ異なる可能性があります。安定した代替として `gpt-5.4` を使ってください。
+
+**Port が突然 `3457` になる**
+別のローカルツールから `PORT=3457` が引き継がれている可能性があります。`unset PORT` するか、`IMA2_PORT=3333 ima2 serve` で起動してください。
+
+## Development
+
+```bash
+git clone https://github.com/lidge-jun/ima2-gen.git
+cd ima2-gen
+npm install
+npm run dev
+npm test
+npm run build
+```
+
+## License
+
+MIT

package/docs/README.ko.md

@@ -0,0 +1,182 @@
+# ima2-gen
+
+[![npm version](https://img.shields.io/npm/v/ima2-gen)](https://www.npmjs.com/package/ima2-gen)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](../LICENSE)
+
+> **다른 언어로 읽기**: [English](../README.md) · [日本語](README.ja.md) · [简体中文](README.zh-CN.md)
+
+`ima2-gen`은 ChatGPT/Codex OAuth 이미지 생성 흐름을 로컬 웹앱처럼 쓸 수 있게 만든 이미지 생성 스튜디오입니다.
+
+`npx`로 실행하고, Codex OAuth로 로그인한 뒤, 프롬프트를 입력하면서 히스토리, 레퍼런스, 스타일 시트, 노드 브랜치로 계속 이어갈 수 있습니다. 기본 이미지 생성 경로에서는 OpenAI API 키가 필요하지 않습니다.
+
+![프롬프트 작성창, 생성 이미지, 모델 표시, 결과 메타데이터가 보이는 ima2-gen 클래식 생성 화면](../assets/screenshots/classic-generate-light.png)
+
+## 빠른 시작
+
+```bash
+npx ima2-gen serve
+```
+
+그다음 `http://localhost:3333`을 엽니다.
+
+Codex 로그인이 아직 없다면:
+
+```bash
+npx @openai/codex login
+npx ima2-gen serve
+```
+
+전역 설치도 가능합니다.
+
+```bash
+npm install -g ima2-gen
+ima2 serve
+```
+
+## 무엇을 할 수 있나요?
+
+- **Classic mode**: 빠르게 이미지를 만들고, 수정하고, 현재 결과를 다시 레퍼런스로 사용합니다.
+- **Node mode**: 마음에 드는 이미지를 여러 방향으로 분기해 실험합니다.
+- **Local gallery**: 생성물을 내 컴퓨터에 저장하고 세션별 히스토리로 봅니다.
+- **Reference images**: 레퍼런스를 드래그, 붙여넣기, 파일 선택으로 추가합니다. 큰 이미지는 업로드 전에 자동 압축됩니다.
+- **Style sheets**: 한 번 잡은 시각적 방향을 classic/node 프롬프트에 재사용합니다.
+- **Observable jobs**: 진행 중 작업과 최근 작업을 request ID로 추적합니다.
+
+## 이미지 생성은 OAuth 전용입니다
+
+현재 이미지 생성은 로컬 Codex/ChatGPT OAuth 경로로 실행됩니다.
+
+API 키가 env/config에 있어도 billing 확인이나 style-sheet 추출 같은 보조 기능에만 쓰일 수 있습니다. 생성 엔드포인트에서 `provider: "api"`를 보내면 `APIKEY_DISABLED`가 반환됩니다.
+
+설정 화면에 **Configured but disabled**가 보이면, API 키는 감지됐지만 이미지 생성은 여전히 OAuth로 실행된다는 뜻입니다.
+
+![OAuth 활성화와 API 키 비활성 상태를 보여주는 설정 화면](../assets/screenshots/settings-oauth-generation.png)
+
+## 모델 안내
+
+안정적인 균형을 원하면 **`gpt-5.4`**부터 써보는 것을 권장합니다.
+
+- `gpt-5.4` — 추천 기본 선택지.
+- `gpt-5.4-mini` — 현재 앱 기본값이며 빠른 초안에 적합합니다.
+- `gpt-5.5` — 지원되는 환경에서는 가장 강한 품질 선택지입니다. 다만 더 많은 할당량을 쓸 수 있고, Codex CLI 업데이트가 필요하거나 계정/백엔드별 이미지 capability가 다를 수 있습니다.
+
+품질은 `low`, `medium`, `high`, 모더레이션은 `auto`, `low`를 지원합니다.
+
+## 주요 흐름
+
+### Classic mode
+
+한 장을 빠르게 뽑고 다듬고 싶을 때 사용합니다.
+
+1. 프롬프트를 씁니다.
+2. 필요하면 레퍼런스를 붙입니다.
+3. 모델, 품질, 크기, 포맷, 모더레이션을 고릅니다.
+4. 생성 후 복사, 다운로드, 이어서 작업을 선택합니다.
+
+### Node mode
+
+아이디어를 가지치기하면서 비교하고 싶을 때 사용합니다.
+
+![연결된 생성 카드와 노드별 메타데이터가 보이는 노드 모드 화면](../assets/screenshots/node-graph-branching.png)
+
+각 노드는 자기 프롬프트와 결과를 가집니다. 루트 노드는 로컬 레퍼런스를 붙일 수 있고, 자식 노드는 부모 이미지를 소스로 사용합니다. 완료된 작업은 request ID로 다시 매칭되므로 새로고침이나 그래프 버전 충돌 뒤에도 결과를 복구할 수 있습니다.
+
+### Settings와 Style sheets
+
+설정 화면은 계정, 모델, 테마, 언어 설정을 생성 패널 밖으로 분리합니다.
+
+![계정 영역과 생성 모델 설정이 보이는 설정 워크스페이스](../assets/screenshots/settings-workspace.png)
+
+Style sheet는 반복해서 쓰고 싶은 시각적 방향을 저장하는 기능입니다.
+
+![medium, composition, mood, subject, palette, negative 필드가 있는 스타일 시트 편집 화면](../assets/screenshots/style-sheet-editor.png)
+
+## CLI 명령어
+
+### 서버
+
+| 명령어 | 설명 |
+|---|---|
+| `ima2 serve` | 로컬 웹 서버 시작 |
+| `ima2 setup` | 인증 설정 다시 구성 |
+| `ima2 status` | config와 OAuth 상태 확인 |
+| `ima2 doctor` | Node, 패키지, config, auth 진단 |
+| `ima2 open` | 웹 UI 열기 |
+| `ima2 reset` | 저장된 config 삭제 |
+
+### 클라이언트
+
+아래 명령어는 `ima2 serve`가 실행 중이어야 합니다.
+
+| 명령어 | 설명 |
+|---|---|
+| `ima2 gen <prompt>` | CLI에서 이미지 생성 |
+| `ima2 edit <file> --prompt <text>` | 기존 이미지 수정 |
+| `ima2 ls` | 로컬 히스토리 보기 |
+| `ima2 show <name>` | 생성 파일 열기 |
+| `ima2 ps` | 진행 중 작업 보기 |
+| `ima2 ping` | 실행 중인 서버 확인 |
+
+서버 포트는 `~/.ima2/server.json`에 기록됩니다. `--server <url>` 또는 `IMA2_SERVER=http://localhost:3333`로 직접 지정할 수도 있습니다.
+
+## 설정
+
+우선순위:
+
+```text
+environment variables > ~/.ima2/config.json > built-in defaults
+```
+
+| 변수 | 기본값 | 설명 |
+|---|---:|---|
+| `IMA2_PORT` / `PORT` | `3333` | 웹 서버 포트 |
+| `IMA2_OAUTH_PROXY_PORT` / `OAUTH_PORT` | `10531` | OAuth 프록시 포트 |
+| `IMA2_SERVER` | — | CLI 대상 서버 직접 지정 |
+| `IMA2_CONFIG_DIR` | `~/.ima2` | config와 SQLite 저장 위치 |
+| `IMA2_GENERATED_DIR` | `~/.ima2/generated` | 생성 이미지 저장 위치 |
+| `IMA2_NO_OAUTH_PROXY` | — | `1`이면 OAuth 프록시 자동 시작 비활성화 |
+| `IMA2_INFLIGHT_TERMINAL_TTL_MS` | `30000` | 디버그용 최근 작업 보존 시간 |
+| `OPENAI_API_KEY` | — | 보조 기능용 API 키. 이미지 생성용은 아님 |
+
+## API 문서
+
+엔드포인트 목록은 [API Reference](API.md)로 분리했습니다.
+
+## 문제 해결
+
+**`ima2 ping`이 서버에 연결하지 못한다고 나와요**
+`ima2 serve`를 먼저 실행하고 `~/.ima2/server.json`을 확인하세요. `ima2 ping --server http://localhost:3333`도 사용할 수 있습니다.
+
+**OAuth 로그인이 안 돼요**
+`npx @openai/codex login`을 실행하고, `ima2 status`를 확인한 뒤 `ima2 serve`를 다시 시작하세요.
+
+**이미지 생성이 `APIKEY_DISABLED`로 실패해요**
+현재 빌드에서는 OAuth로 생성해야 합니다. API-key 이미지 생성은 의도적으로 비활성화되어 있습니다.
+
+**큰 레퍼런스 이미지가 실패해요**
+JPEG/PNG는 업로드 전에 자동 압축됩니다. 그래도 실패하면 해상도를 낮춘 JPEG/PNG로 바꿔 다시 시도하세요. HEIC/HEIF는 브라우저 경로에서 지원하지 않습니다.
+
+**업데이트 후 예전 갤러리 이미지가 안 보여요**
+최근 버전에서 생성 이미지 위치가 설치 폴더에서 `~/.ima2/generated`로 이동했습니다. `ima2 doctor`를 실행하고 [예전 이미지 복구 안내](RECOVER_OLD_IMAGES.md)를 확인하세요.
+
+**`gpt-5.5`만 실패해요**
+먼저 Codex CLI를 최신으로 업데이트한 뒤 다시 시도해보세요. 그래도 실패하면 현재 계정이나 백엔드 경로에서 `gpt-5.5` 이미지 capability 또는 할당량이 아직 다르게 적용되는 상황일 수 있으니, 안정적인 대안으로 `gpt-5.4`를 사용하세요.
+
+**포트가 갑자기 `3457`로 떠요**
+다른 로컬 도구에서 `PORT=3457`이 상속됐을 수 있습니다. `unset PORT`를 실행하거나 `IMA2_PORT=3333 ima2 serve`로 시작하세요.
+
+## 개발
+
+```bash
+git clone https://github.com/lidge-jun/ima2-gen.git
+cd ima2-gen
+npm install
+npm run dev
+npm test
+npm run build
+```
+
+## 라이선스
+
+MIT