@primeuicom/mcp 0.1.20 → 0.1.21

package/README.md

@@ -56,13 +56,13 @@ Available tools:
 
 | Tool                       | What it does                                                                                                                                                     | Input                               |
 | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- |
-| `get_project_info` | Returns project metadata and page list, including export readiness and source paths.                                                                             | none                                |
-| `inspect_page`     | Returns details for one page by slug, raw active-variant components (or `null`), and a formatted component report table for local comparison.                    | `pageSlug`                          |
-| `list_exports`     | Lists existing exports with ID, status, and creation time.                                                                                                       | none                                |
-| `create_export`    | Starts a new export and returns strict API manifest payload (`pages[].manifest.files` + `export.components`), then saves sidecar manifest `.primeui/temp/exports/<exportId>.manifest.json`. | none                                |
-| `download_export`  | Downloads and extracts a completed export into `.primeui/temp/exports/<exportId>/` and validates existing local sidecar manifest for this export ID. | `id` (export ID)                    |
-| `copy_page`        | Safely copies one page from downloaded export into user project using only `pages[].manifest.files` (new files only, conflicts as diff, add-only missing deps). | `originPageSlug`, `actualPageSlug?` |
-| `clear_temp`       | Clears `.primeui/temp/` and recreates baseline temp layout.                                                                                                      | none                                |
+| `get_project_info` | Returns project metadata and page list, including export readiness and source paths.                                                                             | `projectRoot?`                      |
+| `inspect_page`     | Returns details for one page by slug, raw active-variant components (or `null`), and a formatted component report table for local comparison.                    | `pageSlug`, `projectRoot?`          |
+| `list_exports`     | Lists existing exports with ID, status, and creation time.                                                                                                       | `projectRoot?`                      |
+| `create_export`    | Starts a new export and returns strict API manifest payload (`pages[].manifest.files` + `export.components`), then saves sidecar manifest `.primeui/temp/exports/<exportId>.manifest.json`. | `projectRoot?`                      |
+| `download_export`  | Downloads and extracts a completed export into `.primeui/temp/exports/<exportId>/` and validates existing local sidecar manifest for this export ID. | `id` (export ID), `projectRoot?`    |
+| `copy_page`        | Safely copies one page from downloaded export into user project using only `pages[].manifest.files` (new files only, conflicts as diff, add-only missing deps). | `originPageSlug`, `actualPageSlug?`, `projectRoot?` |
+| `clear_temp`       | Clears `.primeui/temp/` and recreates baseline temp layout.                                                                                                      | `projectRoot?`                      |
 
 ## Getting started
 
@@ -191,9 +191,14 @@ Use the same JSON server configuration shown in Getting started:
 
 - PrimeUI MCP uses bearer authentication with `PRIMEUI_API_KEY`.
 - If `PRIMEUI_API_KEY` env is missing, PrimeUI MCP reads `.primeui/project.json` (`apiKey`).
-- Config lookup:
-  - if `PRIMEUI_PROJECT_ROOT` is set, MCP reads `${PRIMEUI_PROJECT_ROOT}/.primeui/project.json`;
-  - otherwise MCP searches `.primeui/project.json` upward from current working directory.
+- Server startup does not require `.primeui/project.json`; project config is resolved lazily per tool call.
+- Config lookup order on each tool call:
+  - `projectRoot` tool input (if provided),
+  - sticky in-process root resolved by prior successful tool call,
+  - `PRIMEUI_PROJECT_ROOT` env,
+  - upward search for `.primeui/project.json` from current working directory.
+- If config cannot be resolved, the tool returns a transparent error with actionable hint to pass `projectRoot`.
+- `clear_temp` and `copy_page` always validate project config before running any mutation.
 - Missing or invalid `targetProjectPath` is treated as a configuration error.
 - Downloaded archives are validated as ZIP payloads before extraction.
 - `create_export` is the source of truth for local sidecar manifest creation in `.primeui/temp/exports/<exportId>.manifest.json`.