feat: save project.wefc manifest with IFC, validation and BCF links

Cloud save now builds and uploads a complete project.wefc manifest
containing WefcModel (IFC files), WefcValidation (results), and
WefcBcf (issues .bcf zip) entries. Adds PUT manifest API endpoint.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: jochem25

server/routers/cloud.py

@@ -437,3 +437,37 @@ async def cloud_get_manifest(
         )
 
     return JSONResponse(content=manifest)
+
+
+@router.put("/projects/{project}/manifest")
+async def cloud_put_manifest(
+    project: str,
+    manifest: dict[str, Any],
+    tenant: str | None = Query(None),
+):
+    """Write a full project.wefc manifest.
+
+    Accepts a complete manifest JSON body and writes it to the project
+    root as project.wefc via WebDAV.
+
+    Args:
+        project: Project folder name.
+        manifest: Full manifest dict with header and data.
+        tenant: Tenant slug (optional).
+    """
+    config = _resolve_tenant(tenant)
+    client = get_nc_client(config)
+
+    # Ensure header timestamp is current
+    if "header" in manifest:
+        manifest["header"]["timestamp"] = (
+            datetime.now(timezone.utc).isoformat()
+        )
+        manifest["header"]["application"] = "bim-validator"
+
+    try:
+        await client.write_manifest(project, manifest)
+    except Exception as exc:
+        raise _nc_error_to_http(exc) from exc
+
+    return {"success": True, "project": project}

viewer/src/api/cloudApi.ts

@@ -166,6 +166,35 @@ export async function cloudUploadFile(
   }
 }
 
+/** Save a project.wefc manifest to the cloud. */
+export async function cloudSaveManifest(
+  project: string,
+  manifest: Record<string, unknown>,
+): Promise<void> {
+  let response: Response;
+  try {
+    response = await fetch(
+      `${CLOUD_BASE}/projects/${encodeURIComponent(project)}/manifest`,
+      {
+        method: "PUT",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(manifest),
+      },
+    );
+  } catch (error) {
+    throw new ApiError(
+      "Network error: unable to save manifest.",
+      undefined,
+      error instanceof Error ? error.message : "Unknown network error",
+    );
+  }
+
+  if (!response.ok) {
+    const msg = await parseError(response);
+    throw new ApiError(msg, response.status, msg);
+  }
+}
+
 /** Delete a file from the cloud. */
 export async function cloudDeleteFile(
   project: string,

viewer/src/components/projects/SaveAsDialog.tsx

@@ -38,7 +38,9 @@ export default function SaveAsDialog({
   const cloudError = useStore((s) => s.cloudError);
   const cloudLoadProjects = useStore((s) => s.cloudLoadProjects);
   const cloudUpload = useStore((s) => s.cloudUpload);
+  const cloudSaveManifest = useStore((s) => s.cloudSaveManifest);
   const validationResult = useStore((s) => s.validationResult);
+  const bcfIssues = useStore((s) => s.bcfIssues);
   const setSaveInfo = useStore((s) => s.setSaveInfo);
   const markClean = useStore((s) => s.markClean);
 
@@ -148,6 +150,9 @@ export default function SaveAsDialog({
     setError(null);
 
     try {
+      const now = new Date().toISOString();
+      const manifestData: Record<string, unknown>[] = [];
+
       // Upload IFC files to models/ directory
       const { getModelBytes } = await import("../../engine/modelCache");
       for (const model of project.models) {
@@ -157,6 +162,17 @@ export default function SaveAsDialog({
             type: "application/octet-stream",
           });
           await cloudUpload(selectedCloudProject, model.fileName, blob, "bim");
+          manifestData.push({
+            type: "WefcModel",
+            guid: model.id,
+            name: model.fileName,
+            path: `models/${model.fileName}`,
+            format: model.format ?? "ifc",
+            fileSize: model.fileSize,
+            status: "active",
+            created: now,
+            modified: now,
+          });
         }
       }
 
@@ -172,8 +188,51 @@ export default function SaveAsDialog({
           resultBlob,
           "output",
         );
+        manifestData.push({
+          type: "WefcValidation",
+          guid: crypto.randomUUID(),
+          name: `BIM Validatie - ${now.slice(0, 10)}`,
+          path: "validation/validation-result.json",
+          status: "active",
+          created: now,
+          modified: now,
+        });
+      }
+
+      // Upload BCF issues as .bcf zip to validation/ directory
+      if (bcfIssues.length > 0) {
+        const { generateBcfZip } = await import("../../lib/bcfZipGenerator");
+        const bcfBlob = await generateBcfZip(bcfIssues);
+        const bcfFilename = `${project.name ?? "issues"}.bcf`;
+        await cloudUpload(
+          selectedCloudProject,
+          bcfFilename,
+          bcfBlob,
+          "output",
+        );
+        manifestData.push({
+          type: "WefcBcf",
+          guid: crypto.randomUUID(),
+          name: `BCF Issues - ${now.slice(0, 10)}`,
+          path: `validation/${bcfFilename}`,
+          issueCount: bcfIssues.length,
+          status: "active",
+          created: now,
+          modified: now,
+        });
       }
 
+      // Save project.wefc manifest
+      await cloudSaveManifest(selectedCloudProject, {
+        header: {
+          schema: "WeFC",
+          schema_version: "1.0.0",
+          timestamp: now,
+          application: "bim-validator",
+        },
+        data: manifestData,
+      });
+
       setSaveInfo({
         source: "cloud",
         cloudProject: selectedCloudProject,
@@ -191,7 +250,9 @@ export default function SaveAsDialog({
     project,
     selectedCloudProject,
     validationResult,
+    bcfIssues,
     cloudUpload,
+    cloudSaveManifest,
     setSaveInfo,
     markClean,
     onSaveComplete,

viewer/src/store/slices/cloudSlice.ts

@@ -14,6 +14,7 @@ import {
   cloudUploadFile as apiUploadFile,
   cloudDownloadFile as apiDownloadFile,
   cloudDeleteFile as apiDeleteFile,
+  cloudSaveManifest as apiSaveManifest,
 } from "../../api/cloudApi";
 
 type CloudPhase =
@@ -43,6 +44,7 @@ export interface CloudSlice {
   cloudUpload: (project: string, filename: string, blob: Blob, category?: "bim" | "output") => Promise<boolean>;
   cloudDownload: (project: string, filename: string) => Promise<Blob | null>;
   cloudDelete: (project: string, filename: string) => Promise<boolean>;
+  cloudSaveManifest: (project: string, manifest: Record<string, unknown>) => Promise<boolean>;
   cloudReset: () => void;
 }
 
@@ -143,6 +145,17 @@ export const createCloudSlice: StateCreator<CloudSlice> = (set, get) => ({
     }
   },
 
+  cloudSaveManifest: async (project: string, manifest: Record<string, unknown>) => {
+    try {
+      await apiSaveManifest(project, manifest);
+      return true;
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Manifest save failed";
+      set({ cloudError: message });
+      return false;
+    }
+  },
+
   cloudReset: () => {
     set({
       cloudPhase: "idle",