imgx-mcp 1.2.0 → 1.4.0

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## 1.4.0 (2026-03-04)
+
+### Added
+
+- **Sequential file naming for edit chains** — `edit_last` now generates sequential filenames based on the origin file: `cover.png` → `cover-1.png` → `cover-2.png`. Default UUID-based names follow the same pattern: `imgx-a1b2c3d4.png` → `imgx-a1b2c3d4-1.png`
+- **File deletion on undo + re-edit** — When editing after undo, spliced (abandoned) entries' files are deleted from disk, preventing orphaned images
+- **Session base info tracking** — `Session` now stores `baseName`, `baseExt`, `baseDir` to maintain file identity across the edit chain
+- **`getSessionChainNumber()` API** — returns the next sequential number for chained edits
+- **`getSessionBaseInfo()` / `setSessionBaseInfo()` API** — read/write the origin file identity on the active session
+- 15 new tests (total: 81 tests)
+
+### Changed
+
+- **`saveImage()` signature** — new optional `isChained` parameter for sequential naming (backward compatible, defaults to falsy)
+- Legacy sessions without `baseName` fall back to UUID naming when `isChained` is true
+
+## 1.3.0 (2026-03-04)
+
+### Added
+
+- **Session-based `clear_history`** — MCP `clear_history` tool accepts optional `session_id` parameter to clear a single session instead of all sessions
+- **Managed path protection** — MCP `clear_history` with `delete_files` only deletes files inside managed directories (`.imgx/` or `~/Pictures/imgx/`); files saved to custom output paths are never deleted
+- **`clearSession()` API** — new function to remove a single session from history
+- **`isManagedPath()` API** — determines whether a file path is inside a managed directory
+- **CLI `history clear <session-id>`** — clear a specific session from CLI (errors on `--all` + session ID combo)
+- **Uninstall cleanup documentation** — README uninstall section now documents data that `npm uninstall` does not remove
+- 7 new tests for `clearSession` and `isManagedPath` (total: 66 tests)
+
+### Changed
+
+- **`historyDir()` exported** — previously private, now available for managed path detection
+- **MCP `clear_history` response** — now includes `skippedFiles` count for files outside managed directories
+
 ## 1.2.0 (2026-03-04)
 
 ### Added

package/README.md

@@ -129,7 +129,18 @@ generate → edit_last → edit_last → edit_last
                                     ↑ current
 ```
 
-After undo, calling `edit_last` branches from the current position (newer entries are discarded).
+After undo, calling `edit_last` branches from the current position (abandoned entries and their files are deleted from disk).
+
+**File naming** — `edit_last` generates sequential filenames based on the origin file:
+
+```
+generate_image             → cover.png
+edit_last                  → cover-1.png
+edit_last                  → cover-2.png
+
+generate_image (no output) → imgx-a1b2c3d4.png
+edit_last                  → imgx-a1b2c3d4-1.png
+```
 
 **Session switching** — Use `edit_history` to see all sessions, then `switch_session` to resume a previous session. The `edit_last` tool will use the current position in the switched session.
 
@@ -438,7 +449,9 @@ Delete the `image-generation/` directory from `.claude/skills/` or `~/.claude/sk
 npm uninstall -g imgx-mcp
 ```
 
-### Clean up configuration (optional)
+`npm uninstall` removes the package but does not delete configuration or generated files. Remove them manually if needed:
+
+**Global configuration:**
 
 ```bash
 # Linux / macOS
@@ -448,6 +461,12 @@ rm -rf ~/.config/imgx/
 Remove-Item -Recurse -Force "$env:APPDATA\imgx"
 ```
 
+**Project history and images:** Each project may have a `.imgx/` directory containing edit history and generated images. Remove it from each project as needed.
+
+```bash
+rm -rf <project-root>/.imgx/
+```
+
 ## License
 
 MIT — [SOMA COFFEE KYOTO](https://github.com/somacoffeekyoto)