imgx-mcp 1.1.1 → 1.3.0

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## 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
+
+- **MCP roots-based project detection** — MCP server now calls `listRoots()` after connection to get the client's workspace directory, making project-scoped history work without `.imgxrc` when used via Claude Code and other MCP clients
+- **`setProjectRoot()` API** — allows MCP server (or other integrations) to set the project root programmatically
+- **Project-scoped default output** — when a project root is detected, default output directory is `<project-root>/.imgx/` instead of `~/Pictures/imgx`
+- 5 new tests for MCP root detection and project-scoped default output (total: 59 tests)
+
+### Changed
+
+- **Project root resolution priority** — `IMGX_PROJECT_ROOT` env var > MCP roots (`setProjectRoot`) > `.imgxrc` upward search (CLI fallback)
+- **`fallbackOutputDir()`** — configured `outputDir` is now resolved via `resolveProjectPath()` for correct relative path handling
+- **`resetProjectRootCache()`** — now also clears the MCP root value
+
 ## 1.1.1 (2026-03-04)
 
 ### Added

package/README.md

@@ -100,7 +100,7 @@ The skill guides Claude Code through image workflows: blog covers, iterative edi
 | `set_output_dir` | Change the default output directory (optionally move existing files) |
 | `list_providers` | List available providers and capabilities |
 
-Images are saved to `~/Pictures/imgx/<session-id>/` by default. Each session gets its own directory. File paths are returned in the response. Inline image preview is included in MCP responses (base64).
+Images are saved to `<project-root>/.imgx/<session-id>/` when a project root is detected, or `~/Pictures/imgx/<session-id>/` otherwise. Each session gets its own directory. File paths are returned in the response. Inline image preview is included in MCP responses (base64).
 
 ### Iterative editing
 
@@ -377,7 +377,7 @@ Or create manually:
 
 Project config is shared via Git. Do not put API keys in `.imgxrc`.
 
-When `.imgxrc` is present, imgx-mcp treats that directory as the project root. History is saved to `<project-root>/.imgx/output-history.json` (project-scoped, not shared with other projects). Relative paths in `output` and `output_dir` are resolved against the project root instead of the MCP server's working directory.
+When used via MCP (Claude Code, etc.), imgx-mcp automatically detects the project root from the client's workspace via MCP roots. When `.imgxrc` is present, that directory is used as the project root (CLI fallback). You can also set `IMGX_PROJECT_ROOT` environment variable explicitly. History is saved to `<project-root>/.imgx/output-history.json` (project-scoped, not shared with other projects). Default image output goes to `<project-root>/.imgx/<session-id>/`. Relative paths in `output` and `output_dir` are resolved against the project root instead of the MCP server's working directory.
 
 ### Settings resolution
 
@@ -438,7 +438,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 +450,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)