@primeuicom/mcp 0.1.14 → 0.1.16

package/dist/service.js

@@ -74,15 +74,46 @@ async function readPrimeUiProjectConfig(projectConfigPath) {
   }
   return parsedConfig.data;
 }
+function toUniqueResolvedDirs(directories) {
+  const resolved = /* @__PURE__ */ new Set();
+  for (const directory of directories) {
+    const trimmed = directory?.trim();
+    if (!trimmed) {
+      continue;
+    }
+    resolved.add(path.resolve(trimmed));
+  }
+  return [...resolved];
+}
 async function resolvePrimeUiProjectConfig(options) {
   const envProjectRoot = options.projectRootFromEnv?.trim();
-  const projectConfigPath = envProjectRoot ? path.join(
-    path.resolve(envProjectRoot),
-    PRIMEUI_PROJECT_CONFIG_RELATIVE_PATH
-  ) : await findPrimeUiProjectConfigPath(options.cwd);
+  let projectConfigPath;
+  if (envProjectRoot) {
+    projectConfigPath = path.join(
+      path.resolve(envProjectRoot),
+      PRIMEUI_PROJECT_CONFIG_RELATIVE_PATH
+    );
+  } else {
+    const searchRoots = toUniqueResolvedDirs([
+      options.cwd,
+      ...options.fallbackCwds ?? []
+    ]);
+    for (const searchRoot of searchRoots) {
+      const foundProjectConfigPath = await findPrimeUiProjectConfigPath(searchRoot);
+      if (foundProjectConfigPath) {
+        projectConfigPath = foundProjectConfigPath;
+        break;
+      }
+    }
+    if (!projectConfigPath) {
+      throw new Error(
+        `[primeui-mcp] ${PRIMEUI_PROJECT_CONFIG_RELATIVE_PATH} not found. Searched from: ${searchRoots.join(", ")}. Set PRIMEUI_PROJECT_ROOT.`
+      );
+    }
+  }
   if (!projectConfigPath) {
     throw new Error(
-      `[primeui-mcp] ${PRIMEUI_PROJECT_CONFIG_RELATIVE_PATH} not found from cwd (${options.cwd}).`
+      `[primeui-mcp] ${PRIMEUI_PROJECT_CONFIG_RELATIVE_PATH} not found. Set PRIMEUI_PROJECT_ROOT.`
     );
   }
   const projectRoot = path.dirname(path.dirname(projectConfigPath));
@@ -147,6 +178,36 @@ var exportItemSchema = z2.object({
   status: exportStatusSchema,
   createdAt: z2.string().describe("Export creation timestamp in ISO-8601 UTC format.")
 }).describe("Single export record from PrimeUI export history.");
+var exportSummarySchema = z2.object({
+  total: z2.number().describe("Total pages processed in this export run."),
+  successful: z2.number().describe("Number of pages exported successfully."),
+  failed: z2.number().describe("Number of pages that failed export.")
+});
+var exportComponentSchema = z2.object({
+  componentKey: z2.string().describe("Global component key from export manifest."),
+  enabled: z2.boolean().describe("True when this global component was exported."),
+  files: z2.array(z2.string()).describe("Files associated with this global component."),
+  message: z2.string().describe("Export status message for this global component.")
+});
+var exportPageManifestSchema = z2.object({
+  success: z2.boolean().describe("True when page export succeeded in this export run."),
+  message: z2.string().describe("Export status message for this page."),
+  files: z2.array(z2.string()).describe(
+    "Authoritative list of page-related files from PrimeUI export manifest, including shared project files required by this page."
+  )
+});
+var exportPageSchema = z2.object({
+  id: z2.string().describe("Stable PrimeUI page identifier for this export entry."),
+  title: z2.string().optional().describe(
+    "Optional page title from export manifest. Can be undefined for some legacy records."
+  ),
+  slug: z2.string().describe("PrimeUI page slug included in this export."),
+  pageType: z2.string().describe("PrimeUI page type for routing/path resolution."),
+  isReadyToExport: z2.literal(true).describe("Always true for pages included in export payload."),
+  pagePath: z2.string().describe("Page source file path relative to export root."),
+  componentsPath: z2.string().describe("Page components directory path relative to export root."),
+  manifest: exportPageManifestSchema
+});
 var fileTransferSchema = z2.object({
   sourcePath: z2.string().describe("Relative source file path inside downloaded export root."),
   targetPath: z2.string().describe("Relative target file path inside user project root.")
@@ -215,14 +276,14 @@ var TRIGGER_PHRASES = [
 ].join(", ");
 var WORKFLOW_SUMMARY = `
 WORKFLOW ORDER (always follow this sequence):
-1. get_project_info -> discover PrimeUI pages
-2. Reconcile PrimeUI pages with local project pages/routes/paths, then confirm target pages with user
-3. inspect_page -> inspect selected page components and produce a structured comparison table
-4. create_export -> generate export snapshot for agreed pages/analysis scope
-5. download_export -> download to temp directory
-6. copy_page -> copy one page safely (repeat for each selected page)
-7. Reconcile integration points and resolve reported conflicts, if any
-8. clear_temp -> cleanup temp files
+1. clear_temp -> cleanup stale temp files from previous runs before starting new import flow
+2. get_project_info -> discover PrimeUI pages
+3. Reconcile PrimeUI pages with local project pages/routes/paths, then confirm target pages with user
+4. inspect_page -> inspect selected page components and produce a structured comparison table
+5. create_export -> generate export snapshot and local manifest with page file lists + global components
+6. download_export -> download to temp directory
+7. copy_page -> copy one page safely (repeat for each selected page)
+8. Reconcile integration points and resolve reported conflicts, if any
 `.trim();
 var initialInstructions = `
 PrimeUI MCP enables importing pages from PrimeUI Studio into your local project.
@@ -233,6 +294,7 @@ ${WORKFLOW_SUMMARY}
 
 CRITICAL RULES FOR PAGE IMPORT:
 - Import is PAGE-BY-PAGE only. Never import the entire project at once.
+- Always call clear_temp at the very beginning of a new import flow to avoid stale export state.
 - After get_project_info, always compare PrimeUI pages against the user's existing local project pages before proposing imports.
 - Reconciliation report MUST include: page presence match, slug/pagePath/componentsPath path match, and proposed action per page.
 - Decision matrix:
@@ -244,6 +306,10 @@ CRITICAL RULES FOR PAGE IMPORT:
 - After inspect_page returns report table, supplement that table with local project page state:
   mark what already exists, what is missing, and what differs.
 - Before creating export, ask user which pages to add/update (specific pages or all missing pages) and keep that choice in thread context.
+- create_export response includes:
+  - page-level manifest files per page ('pages[].manifest.files'),
+  - global components list ('export.components').
+  Mention both to user after create_export, because this is the source of truth for copy decisions.
 - The downloaded export in .primeui/temp/ contains a full standalone Next.js project.
   Do NOT copy it wholesale.
 - Always call copy_page for each confirmed page instead of manual file copy.
@@ -251,6 +317,7 @@ CRITICAL RULES FOR PAGE IMPORT:
   - new files are copied,
   - identical files are reported,
   - conflicting files are NEVER overwritten and are returned with diff.
+- copy_page reads and validates files only from 'pages[].manifest.files' in local sidecar manifest.
 - copy_page may add only missing dependencies to user's package.json.
   It never upgrades existing dependency versions and never runs dependency installation.
 - After page copy operations, inspect integration points (navigation configs, link menus, route registries, page indexes).
@@ -373,7 +440,7 @@ ${WORKFLOW_SUMMARY}`,
 };
 var toolCreateExport = {
   title: "PrimeUI Create Export",
-  description: `Create a new export snapshot from the current PrimeUI project state and wait for completion. Returns export ID and the list of pages included in the export.
+  description: `Create a new export snapshot from the current PrimeUI project state and wait for completion. Returns strict export manifest payload from API, including page-level file manifests and global components.
 
 WHEN TO USE: Call this AFTER the user has confirmed which pages they want to import via get_project_info. This tool is REQUIRED before download_export, unless the user explicitly and directly asked to download a specific previous export.
 
@@ -381,6 +448,8 @@ AFTER CALLING:
 - Verify that all user-selected pages are present in the export result AND have isReadyToExport: true.
 - If path mismatch pages were flagged during project-info reconciliation, ensure they are included for deeper comparison after download.
 - If any required page is missing or not ready, report and pause for user decision before proceeding.
+- Mention that global components are available in export.components and can be transferred separately if needed.
+- Local sidecar manifest is saved to .primeui/temp/exports/[exportId].manifest.json from this API payload.
 - Use the returned export ID to call download_export.
 
 ${WORKFLOW_SUMMARY}`,
@@ -390,10 +459,20 @@ ${WORKFLOW_SUMMARY}`,
       id: z2.string().describe(
         "Freshly created export identifier. Use this as download_export input.id."
       ),
-      status: exportStatusSchema
+      status: exportStatusSchema,
+      createdAt: z2.string().describe("Export creation timestamp in ISO-8601 UTC format."),
+      expiresAt: z2.string().nullable().describe(
+        "Export expiration timestamp in ISO-8601 UTC format, or null when export has no explicit expiration."
+      ),
+      summary: exportSummarySchema.describe(
+        "Export run summary with total/successful/failed counters."
+      ),
+      components: z2.array(exportComponentSchema).describe(
+        "Global component export manifest. These components are independent from page-level manifests."
+      )
     }).describe("Created export summary."),
-    pages: z2.array(pageSchema).describe(
-      "Page snapshot associated with this export operation. Validate requested pages here before download/import."
+    pages: z2.array(exportPageSchema).describe(
+      "Strict page payload associated with this export, including per-page manifest files list."
     )
   },
   annotations: {
@@ -409,19 +488,19 @@ var toolDownloadExport = {
 
 Do NOT call this as the first step. Requires export ID from create_export. Start with get_project_info instead.
 
-WHEN TO USE: Call this AFTER create_export has returned a completed export. Requires export ID from create_export so MCP can use the matching local pages snapshot for sidecar manifest generation.
+WHEN TO USE: Call this AFTER create_export has returned a completed export. Requires export ID from create_export so MCP can use the matching local sidecar manifest.
 
 NOTE:
-- Download of an export ID without local pages snapshot may fail.
+- Download of an export ID without local sidecar manifest will fail.
 - For previous exports, create a fresh export first when possible.
 
 AFTER DOWNLOAD:
-- Use manifestPath from this response as the contract for page slug/path mapping in copy operations.
+- Use manifestPath from this response as the contract for page slug/path mapping and manifest file lists in copy operations.
 - For each selected page, call copy_page with:
   - originPageSlug (required),
   - actualPageSlug (optional, if route remap is needed).
 - If there are unresolved conflicts in copy report, stop and ask the user.
-- Only after all requested pages are copied and reconciled, call clear_temp.
+- Do not force cleanup at flow end; keep downloaded export files available for validation and follow-up checks.
 
   ${WORKFLOW_SUMMARY}`,
   inputSchema: {
@@ -437,10 +516,10 @@ AFTER DOWNLOAD:
       "Absolute local path to extracted export root in .primeui/temp/exports/[exportId]. Read files from here only."
     ),
     manifestPath: z2.string().describe(
-      "Absolute path to sidecar export manifest file (.primeui/temp/exports/[exportId].manifest.json). copy_page depends on this file."
+      "Absolute path to sidecar export manifest file (.primeui/temp/exports/[exportId].manifest.json) saved by create_export and required by copy_page."
     ),
-    pages: z2.array(pageSchema).describe(
-      "Page descriptors for import decisions. Use pagePath/componentsPath from each item when copying code into user project."
+    pages: z2.array(exportPageSchema).describe(
+      "Page descriptors loaded from local sidecar export manifest for import decisions."
     )
   },
   annotations: {
@@ -461,7 +540,7 @@ WHEN TO USE:
 
 BEHAVIOR:
 - Reads export sidecar manifest to resolve originPageSlug -> pagePath/componentsPath.
-- Copies page file + full page components folder + recursively discovered internal dependencies.
+- Copies and validates files strictly from pages[].manifest.files for the selected page.
 - Never overwrites existing conflicting files.
 - Reports:
   a) copied new files,
@@ -506,7 +585,9 @@ ${WORKFLOW_SUMMARY}`,
       "Dependencies with version mismatch between export and user project. Report only."
     ),
     summary: z2.object({
-      totalCandidateFiles: z2.number().describe("Total number of candidate files considered for page copy."),
+      totalCandidateFiles: z2.number().describe(
+        "Total number of candidate files considered for page copy from pages[].manifest.files."
+      ),
       copiedFiles: z2.number().describe("Number of files copied as new."),
       identicalFiles: z2.number().describe("Number of files detected as identical."),
       conflictFiles: z2.number().describe("Number of conflicting files not copied."),
@@ -525,9 +606,9 @@ var toolClearTemp = {
   title: "PrimeUI Clear Temp",
   description: `Delete all files in .primeui/temp/ and recreate empty temp structure.
 
-Do NOT call this unless ALL requested pages have been successfully imported into the user's project.
+Call this at the START of a new import flow, before get_project_info/create_export, to reset stale temp state from previous runs.
 
-WHEN TO USE: Call this as the FINAL step after ALL requested pages have been successfully imported into the user's project. Do not call this between page imports - wait until all pages are done.
+WHEN TO USE: Call once at the beginning of each new import flow. Do not call this between page imports in the same flow.
 
 Safe to call multiple times. Only affects .primeui/temp/ directory - never touches the user's project files.
 
@@ -837,6 +918,7 @@ function shouldParseFile(filePath) {
   return PARSEABLE_EXTENSIONS.has(path3.extname(filePath).toLowerCase());
 }
 async function buildImportGraph(input) {
+  const shouldFollowInternalImports = input.followInternalImports ?? true;
   const projectRoot = path3.resolve(input.projectRoot);
   const queue = input.entryFiles.map((filePath) => path3.resolve(filePath));
   const visited = /* @__PURE__ */ new Set();
@@ -866,7 +948,7 @@ async function buildImportGraph(input) {
         specifier
       );
       if (resolved.kind === "internal") {
-        if (!visited.has(resolved.filePath)) {
+        if (shouldFollowInternalImports && !visited.has(resolved.filePath)) {
           queue.push(resolved.filePath);
         }
         continue;
@@ -1180,53 +1262,95 @@ async function fileExists2(filePath) {
     return false;
   }
 }
-function isPageRecord(value) {
+function isExportPageManifestRecord(value) {
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+  const maybe = value;
+  return typeof maybe.success === "boolean" && typeof maybe.message === "string" && Array.isArray(maybe.files) && maybe.files.every((item) => typeof item === "string");
+}
+function isExportStatus(value) {
+  return value === "in_progress" || value === "completed" || value === "failed";
+}
+function isExportSummaryRecord(value) {
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+  const maybe = value;
+  return typeof maybe.total === "number" && typeof maybe.successful === "number" && typeof maybe.failed === "number";
+}
+function isExportedComponentRecord(value) {
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+  const maybe = value;
+  return typeof maybe.componentKey === "string" && typeof maybe.enabled === "boolean" && Array.isArray(maybe.files) && maybe.files.every((item) => typeof item === "string") && typeof maybe.message === "string";
+}
+function isExportPageRecord(value) {
   if (!value || typeof value !== "object") {
     return false;
   }
   const maybe = value;
-  return typeof maybe.id === "string" && typeof maybe.title === "string" && typeof maybe.slug === "string" && typeof maybe.pageType === "string" && typeof maybe.isReadyToExport === "boolean" && typeof maybe.pagePath === "string" && typeof maybe.componentsPath === "string";
+  const title = maybe.title;
+  return typeof maybe.id === "string" && (typeof title === "string" || typeof title === "undefined") && typeof maybe.slug === "string" && typeof maybe.pageType === "string" && maybe.isReadyToExport === true && typeof maybe.pagePath === "string" && typeof maybe.componentsPath === "string" && isExportPageManifestRecord(maybe.manifest);
 }
 function parseManifest(value) {
   if (!value || typeof value !== "object") {
     throw new Error("Invalid export manifest format.");
   }
   const maybe = value;
-  if (maybe.schemaVersion !== 1 || typeof maybe.generatedAt !== "string" || typeof maybe.exportId !== "string" || typeof maybe.projectPath !== "string" || !Array.isArray(maybe.pages)) {
+  const exportPayload = maybe.export;
+  if (!exportPayload || typeof exportPayload !== "object") {
+    throw new Error("Export manifest export payload is invalid.");
+  }
+  const exportObject = exportPayload;
+  const status = exportObject.status;
+  const summary = exportObject.summary;
+  const components = exportObject.components;
+  if (typeof exportObject.id !== "string" || !isExportStatus(status) || typeof exportObject.createdAt !== "string" || !("expiresAt" in exportObject) || !(typeof exportObject.expiresAt === "string" || exportObject.expiresAt === null) || !isExportSummaryRecord(summary) || !Array.isArray(components) || !components.every(isExportedComponentRecord) || !Array.isArray(maybe.pages)) {
     throw new Error("Export manifest does not match expected schema.");
   }
-  if (!maybe.pages.every(isPageRecord)) {
+  if (!maybe.pages.every(isExportPageRecord)) {
     throw new Error("Export manifest pages payload is invalid.");
   }
   return {
-    schemaVersion: 1,
-    generatedAt: maybe.generatedAt,
-    exportId: maybe.exportId,
-    projectPath: maybe.projectPath,
+    export: {
+      id: exportObject.id,
+      status,
+      createdAt: exportObject.createdAt,
+      expiresAt: exportObject.expiresAt,
+      summary,
+      components
+    },
     pages: maybe.pages
   };
 }
-async function listFilesRecursively(dirPath) {
-  const files = [];
-  const stack = [dirPath];
-  while (stack.length > 0) {
-    const current = stack.pop();
-    if (!current) {
-      continue;
+async function resolveManifestCandidateFiles(input) {
+  const result = /* @__PURE__ */ new Set();
+  for (const rawPath of input.files) {
+    const trimmed = rawPath.trim();
+    if (!trimmed) {
+      throw new Error(
+        `Export manifest for page "${input.pageSlug}" contains an empty file path.`
+      );
     }
-    const entries = await readdir(current, { withFileTypes: true });
-    for (const entry of entries) {
-      const absolutePath = path4.join(current, entry.name);
-      if (entry.isDirectory()) {
-        stack.push(absolutePath);
-        continue;
-      }
-      if (entry.isFile()) {
-        files.push(absolutePath);
-      }
+    const normalizedRelative = toPosixPath(trimmed).replace(/^\.\/+/, "");
+    const absolutePath = path4.resolve(input.exportPath, normalizedRelative);
+    const relative = path4.relative(input.exportPath, absolutePath);
+    if (relative.startsWith("..") || path4.isAbsolute(relative)) {
+      throw new Error(
+        `Export manifest for page "${input.pageSlug}" contains path outside export root: ${trimmed}`
+      );
+    }
+    const stats = await stat3(absolutePath).catch(() => null);
+    if (!stats?.isFile()) {
+      throw new Error(
+        `Export manifest file is missing for page "${input.pageSlug}": ${normalizedRelative}`
+      );
     }
+    result.add(absolutePath);
   }
-  return files;
+  return [...result].sort((a, b) => a.localeCompare(b));
 }
 async function resolveSingleExportDirectory(exportsRoot) {
   const entries = await readdir(exportsRoot, { withFileTypes: true });
@@ -1336,13 +1460,13 @@ async function copyPageFromExport(input) {
   );
   if (!await fileExists2(manifestPath)) {
     throw new Error(
-      `Export manifest is missing at ${manifestPath}. Run download_export to regenerate it.`
+      `Export manifest is missing at ${manifestPath}. Run create_export and download_export to regenerate it.`
     );
   }
   const manifest = parseManifest(await readJsonFile(manifestPath));
-  if (manifest.exportId !== exportId) {
+  if (manifest.export.id !== exportId) {
     throw new Error(
-      `Manifest exportId mismatch: expected ${exportId}, got ${manifest.exportId}. Re-download export.`
+      `Manifest export id mismatch: expected ${exportId}, got ${manifest.export.id}. Re-run create_export and download_export.`
     );
   }
   const page = manifest.pages.find(
@@ -1382,15 +1506,16 @@ async function copyPageFromExport(input) {
   const importRewritePlan = isSlugRemapped ? buildImportRewritePlan(page.componentsPath, targetPaths.componentsPath) : null;
   ensureSafeTargetPath(input.projectRoot, targetPagePath);
   ensureSafeTargetPath(input.projectRoot, targetComponentsPath);
-  const componentFiles = await listFilesRecursively(sourceComponentsPath);
-  const seedFiles = [sourcePagePath, ...componentFiles];
-  const importGraph = await buildImportGraph({
+  const candidateFiles = await resolveManifestCandidateFiles({
+    exportPath,
+    pageSlug: normalizedOriginSlug,
+    files: page.manifest.files
+  });
+  const dependencyGraph = await buildImportGraph({
     projectRoot: exportPath,
-    entryFiles: seedFiles
+    entryFiles: candidateFiles,
+    followInternalImports: false
   });
-  const candidateFiles = [...new Set(importGraph.internalFiles)].sort(
-    (a, b) => a.localeCompare(b)
-  );
   const newFiles = [];
   const identicalFiles = [];
   const conflictFiles = [];
@@ -1463,7 +1588,7 @@ async function copyPageFromExport(input) {
   const userPackageJson = await readJsonFile(userPackageJsonPath);
   const addedDependencies = [];
   const dependenciesVersionConflicts = [];
-  for (const packageName of importGraph.externalPackages) {
+  for (const packageName of dependencyGraph.externalPackages) {
     const exportDependency = getDependencyVersion(
       exportPackageJson,
       packageName
@@ -1623,31 +1748,69 @@ function buildInspectPageReport(input) {
 }
 
 // src/services/project-sync-service.ts
-function isProjectPage(value) {
+function isExportStatus2(value) {
+  return value === "in_progress" || value === "completed" || value === "failed";
+}
+function isExportSummary(value) {
   if (!value || typeof value !== "object") {
     return false;
   }
   const maybe = value;
-  return typeof maybe.id === "string" && typeof maybe.title === "string" && typeof maybe.slug === "string" && typeof maybe.pageType === "string" && typeof maybe.isReadyToExport === "boolean" && typeof maybe.pagePath === "string" && typeof maybe.componentsPath === "string";
+  return typeof maybe.total === "number" && typeof maybe.successful === "number" && typeof maybe.failed === "number";
 }
-function buildPagesSnapshotPath(exportsRoot, exportId) {
-  return path5.join(exportsRoot, `${exportId}.pages.snapshot.json`);
+function isExportedComponent(value) {
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+  const maybe = value;
+  return typeof maybe.componentKey === "string" && typeof maybe.enabled === "boolean" && Array.isArray(maybe.files) && maybe.files.every((item) => typeof item === "string") && typeof maybe.message === "string";
 }
-function parsePagesSnapshot(value) {
+function isExportPageManifest(value) {
   if (!value || typeof value !== "object") {
-    throw new Error("Export pages snapshot is invalid.");
+    return false;
   }
   const maybe = value;
-  if (maybe.schemaVersion !== 1 || typeof maybe.generatedAt !== "string" || typeof maybe.exportId !== "string" || !Array.isArray(maybe.pages)) {
-    throw new Error("Export pages snapshot does not match expected schema.");
+  return typeof maybe.success === "boolean" && typeof maybe.message === "string" && Array.isArray(maybe.files) && maybe.files.every((item) => typeof item === "string");
+}
+function isExportPage(value) {
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+  const maybe = value;
+  const title = maybe.title;
+  return typeof maybe.id === "string" && (typeof title === "string" || typeof title === "undefined") && typeof maybe.slug === "string" && typeof maybe.pageType === "string" && maybe.isReadyToExport === true && typeof maybe.pagePath === "string" && typeof maybe.componentsPath === "string" && isExportPageManifest(maybe.manifest);
+}
+function buildManifestPath(exportsRoot, exportId) {
+  return path5.join(exportsRoot, `${exportId}.manifest.json`);
+}
+function parseExportManifest(value) {
+  if (!value || typeof value !== "object") {
+    throw new Error("Export manifest is invalid.");
   }
-  if (!maybe.pages.every(isProjectPage)) {
-    throw new Error("Export pages snapshot has invalid pages payload.");
+  const maybe = value;
+  const exportPayload = maybe.export;
+  if (!exportPayload || typeof exportPayload !== "object") {
+    throw new Error("Export manifest export payload is invalid.");
+  }
+  const exportObject = exportPayload;
+  const status = exportObject.status;
+  const summary = exportObject.summary;
+  const components = exportObject.components;
+  if (typeof exportObject.id !== "string" || !isExportStatus2(status) || typeof exportObject.createdAt !== "string" || !("expiresAt" in exportObject) || !(typeof exportObject.expiresAt === "string" || exportObject.expiresAt === null) || !isExportSummary(summary) || !Array.isArray(components) || !components.every(isExportedComponent) || !Array.isArray(maybe.pages)) {
+    throw new Error("Export manifest does not match expected schema.");
+  }
+  if (!maybe.pages.every(isExportPage)) {
+    throw new Error("Export manifest pages payload is invalid.");
   }
   return {
-    schemaVersion: 1,
-    generatedAt: maybe.generatedAt,
-    exportId: maybe.exportId,
+    export: {
+      id: exportObject.id,
+      status,
+      createdAt: exportObject.createdAt,
+      expiresAt: exportObject.expiresAt,
+      summary,
+      components
+    },
     pages: maybe.pages
   };
 }
@@ -1677,21 +1840,9 @@ var ProjectSyncService = class {
   async createExport() {
     await this.ensureTempLayout();
     const result = await this.provider.createExport();
-    const pagesSnapshotPath = buildPagesSnapshotPath(
-      this.exportsRoot,
-      result.export.id
-    );
-    const snapshot = {
-      schemaVersion: 1,
-      generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      exportId: result.export.id,
-      pages: result.pages
-    };
-    await writeUtf8(
-      pagesSnapshotPath,
-      `${JSON.stringify(snapshot, null, 2)}
-`
-    );
+    const manifestPath = buildManifestPath(this.exportsRoot, result.export.id);
+    await writeUtf8(manifestPath, `${JSON.stringify(result, null, 2)}
+`);
     return result;
   }
   async downloadExportById(id) {
@@ -1703,39 +1854,28 @@ var ProjectSyncService = class {
     }
     const targetZipPath = path5.join(this.exportsRoot, `${id}.zip`);
     const targetProjectPath = path5.join(this.exportsRoot, id);
-    await ensureDir(this.exportsRoot);
-    await this.provider.downloadExportArchive(id, targetZipPath);
-    await resetDir(targetProjectPath);
-    await extractZip(targetZipPath, targetProjectPath);
-    const pagesSnapshotPath = buildPagesSnapshotPath(this.exportsRoot, id);
-    let pagesSnapshot;
+    const manifestPath = buildManifestPath(this.exportsRoot, id);
+    let manifest;
     try {
-      const snapshotRaw = JSON.parse(
-        await readFile4(pagesSnapshotPath, "utf-8")
+      manifest = parseExportManifest(
+        JSON.parse(await readFile4(manifestPath, "utf-8"))
       );
-      pagesSnapshot = parsePagesSnapshot(snapshotRaw);
     } catch (error) {
       const reason = error instanceof Error ? error.message : String(error);
       throw new Error(
-        `Export pages snapshot is required for download id "${id}". Run create_export for this export before downloading. Details: ${reason}`
+        `Export manifest is required for download id "${id}". Run create_export for this export before downloading. Details: ${reason}`
       );
     }
-    if (pagesSnapshot.exportId !== id) {
+    if (manifest.export.id !== id) {
       throw new Error(
-        `Export pages snapshot mismatch for id "${id}". Run create_export and retry download.`
+        `Export manifest mismatch for id "${id}". Run create_export and retry download.`
       );
     }
-    const pages = pagesSnapshot.pages;
-    const manifestPath = path5.join(this.exportsRoot, `${id}.manifest.json`);
-    const manifest = {
-      schemaVersion: 1,
-      generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      exportId: id,
-      projectPath: targetProjectPath,
-      pages
-    };
-    await writeUtf8(manifestPath, `${JSON.stringify(manifest, null, 2)}
-`);
+    await ensureDir(this.exportsRoot);
+    await this.provider.downloadExportArchive(id, targetZipPath);
+    await resetDir(targetProjectPath);
+    await extractZip(targetZipPath, targetProjectPath);
+    const pages = manifest.pages;
     return {
       exportId: id,
       projectPath: targetProjectPath,
@@ -1764,14 +1904,12 @@ var ProjectSyncService = class {
   }
   async clearTemp() {
     await resetDir(this.tempRoot);
-    await writeUtf8(path5.join(this.tempRoot, ".gitkeep"), "");
     await ensureDir(this.exportsRoot);
   }
   async ensureTempLayout() {
     await ensureDir(this.primeUiRoot);
     await ensureDir(this.tempRoot);
     await ensureDir(this.exportsRoot);
-    await writeUtf8(path5.join(this.tempRoot, ".gitkeep"), "");
   }
 };
 
@@ -1799,6 +1937,32 @@ var projectPageObjectSchema = z3.object({
   componentsPath: z3.string()
 });
 var projectPageSchema = projectPageObjectSchema;
+var exportSummarySchema2 = z3.object({
+  total: z3.number(),
+  successful: z3.number(),
+  failed: z3.number()
+});
+var exportedComponentSchema = z3.object({
+  componentKey: z3.string(),
+  enabled: z3.boolean(),
+  files: z3.array(z3.string()),
+  message: z3.string()
+});
+var exportPageManifestSchema2 = z3.object({
+  success: z3.boolean(),
+  message: z3.string(),
+  files: z3.array(z3.string())
+});
+var exportPageSchema2 = z3.object({
+  id: z3.string(),
+  title: z3.string().optional(),
+  slug: z3.string(),
+  pageType: z3.string(),
+  isReadyToExport: z3.literal(true),
+  pagePath: z3.string(),
+  componentsPath: z3.string(),
+  manifest: exportPageManifestSchema2
+});
 var projectInfoSchema = z3.object({
   projectId: z3.string(),
   projectName: z3.string(),
@@ -1834,9 +1998,13 @@ var exportsResponseSchema = z3.object({
 var createExportResponseSchema = z3.object({
   export: z3.object({
     id: z3.string(),
-    status: exportStatusSchema2
+    status: exportStatusSchema2,
+    createdAt: z3.string().datetime({ offset: true }),
+    expiresAt: z3.string().datetime({ offset: true }).nullable(),
+    summary: exportSummarySchema2,
+    components: z3.array(exportedComponentSchema)
   }),
-  pages: z3.array(projectPageSchema)
+  pages: z3.array(exportPageSchema2)
 });
 var PrimeUiApiContractError = class extends Error {
   constructor(endpoint, details) {
@@ -2059,10 +2227,14 @@ var ApiProjectDataProvider = class {
 };
 
 // src/service.ts
-async function main() {
+function getProjectConfigFallbackCwds() {
+  return [process.env.INIT_CWD, process.env.PWD].map((value) => value?.trim()).filter((value) => Boolean(value));
+}
+async function createProjectSyncService() {
   const resolvedProjectConfig = await resolvePrimeUiProjectConfig({
     cwd: process.cwd(),
-    projectRootFromEnv: process.env.PRIMEUI_PROJECT_ROOT
+    projectRootFromEnv: process.env.PRIMEUI_PROJECT_ROOT,
+    fallbackCwds: getProjectConfigFallbackCwds()
   });
   const projectRoot = resolvedProjectConfig.projectRoot;
   const targetProjectRoot = path7.resolve(
@@ -2077,17 +2249,48 @@ async function main() {
     apiKey,
     baseUrl: process.env.PRIMEUI_API_BASE_URL
   });
-  const syncService = new ProjectSyncService({
+  return new ProjectSyncService({
     projectRoot,
     targetProjectRoot,
     provider
   });
-  const server = createPrimeUiMcpServer(syncService);
+}
+var LazyProjectSyncSource = class {
+  async withService(operation) {
+    const service = await createProjectSyncService();
+    return operation(service);
+  }
+  async getProjectInfo() {
+    return this.withService((service) => service.getProjectInfo());
+  }
+  async listExports() {
+    return this.withService((service) => service.listExports());
+  }
+  async createExport() {
+    return this.withService((service) => service.createExport());
+  }
+  async downloadExportById(id) {
+    return this.withService((service) => service.downloadExportById(id));
+  }
+  async inspectPage(slug) {
+    return this.withService((service) => service.inspectPage(slug));
+  }
+  async copyPage(originPageSlug, actualPageSlug) {
+    return this.withService(
+      (service) => service.copyPage(originPageSlug, actualPageSlug)
+    );
+  }
+  async clearTemp() {
+    return this.withService((service) => service.clearTemp());
+  }
+};
+async function main() {
+  console.error("CWD:", process.cwd());
+  console.error("INIT_CWD:", process.env.INIT_CWD);
+  console.error("PWD:", process.env.PWD);
+  const server = createPrimeUiMcpServer(new LazyProjectSyncSource());
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  console.error(
-    `[primeui-mcp] running for root: ${projectRoot}; target project: ${targetProjectRoot}`
-  );
 }
 main().catch((error) => {
   console.error("[primeui-mcp] failed to start", error);