@primeuicom/mcp 0.1.14 → 0.1.15

package/README.md

@@ -59,9 +59,9 @@ Available tools:
 | `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 created export info plus page snapshot.                                                                                          | none                                |
-| `download_export`  | Downloads and extracts a completed export into `.primeui/temp/exports/<exportId>/` and writes sidecar manifest `.primeui/temp/exports/<exportId>.manifest.json`. | `id` (export ID)                    |
-| `copy_page`        | Safely copies one page from downloaded export into user project (new files only, conflicts as diff, add-only missing deps).                                      | `originPageSlug`, `actualPageSlug?` |
+| `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                                |
 
 ## Getting started
@@ -196,6 +196,7 @@ Use the same JSON server configuration shown in Getting started:
   - otherwise MCP searches `.primeui/project.json` upward from current working directory.
 - 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`.
 - Temporary export files are written under `.primeui/temp/` in user project folder
 
 ## Local development and testing

package/dist/service.js

@@ -147,6 +147,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 +245,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 +263,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 +275,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 +286,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 +409,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 +417,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 +428,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 +457,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 +485,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 +509,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 +554,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 +575,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 +887,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 +917,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 +1231,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 +1429,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 +1475,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 +1557,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 +1717,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 isExportPageManifest(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 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 parsePagesSnapshot(value) {
+function buildManifestPath(exportsRoot, exportId) {
+  return path5.join(exportsRoot, `${exportId}.manifest.json`);
+}
+function parseExportManifest(value) {
   if (!value || typeof value !== "object") {
-    throw new Error("Export pages snapshot is invalid.");
+    throw new Error("Export manifest is invalid.");
   }
   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.");
+  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(isProjectPage)) {
-    throw new Error("Export pages snapshot has invalid pages payload.");
+  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 +1809,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 +1823,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 +1873,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 +1906,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 +1967,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) {