@openfairygui/backend 0.3.0-alpha.1 → 0.3.0-alpha.3

package/README.md

@@ -29,6 +29,7 @@ It also provides:
 - `cache.refresh` in-memory jobs with cooperative cancel and terminal retention
 - revision-bound derived read-only cache snapshots
 - revision-bound project identity outlines for transaction planning
+- revision-bound read-only project validation reports
 - explicit Node bridge boundaries for publish/restore
 
 It does **not** redefine transaction grammar or expose `Document`.
@@ -71,6 +72,9 @@ if (!opened.ok) throw new Error(opened.error.message);
 const outline = runtime.getProjectOutline({ sessionId: opened.data.sessionId });
 if (!outline.ok) throw new Error(outline.error.message);
 
+const validation = runtime.validateSession({ sessionId: opened.data.sessionId });
+if (!validation.ok) throw new Error(validation.error.message);
+
 const applied = await runtime.applyTransaction({
 	sessionId: opened.data.sessionId,
 	expectedRevision: opened.data.revision,

package/dist/index.cjs

@@ -2,9 +2,10 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 let _openfairygui_core_uam = require("@openfairygui/core/uam");
 let _openfairygui_functions_uam = require("@openfairygui/functions/uam");
 let _openfairygui_core_project_io = require("@openfairygui/core/project-io");
+let _openfairygui_functions = require("@openfairygui/functions");
 //#region src/contracts.ts
 const BACKEND_CONTRACT_VERSION = "1.1.0-p2";
-const BACKEND_CAPABILITY_SCHEMA_VERSION = 2;
+const BACKEND_CAPABILITY_SCHEMA_VERSION = 3;
 const BACKEND_COMPATIBILITY_POLICY = {
 	incompatibleChange: "requires contractVersion bump",
 	capabilitySchemaChange: "requires capabilitySchemaVersion bump",
@@ -97,7 +98,7 @@ function createMeta(stage, startedAt, options) {
 		diagnostics: options?.diagnostics ?? [],
 		stage,
 		contractVersion: BACKEND_CONTRACT_VERSION,
-		capabilitySchemaVersion: 2
+		capabilitySchemaVersion: 3
 	};
 }
 function success(stage, startedAt, data, options) {
@@ -1118,6 +1119,26 @@ var ReadService = class {
 			revision: session.revision
 		});
 	}
+	validateSession(input) {
+		const startedAt = Date.now();
+		const session = this.context.sessions.get(input.sessionId);
+		if (!session || session.closed) return failure("read", startedAt, createSessionNotFoundError(input.sessionId));
+		const report = (0, _openfairygui_functions.validateProject)(session.project, {
+			readDiagnostics: session.readDiagnostics,
+			complete: session.readComplete,
+			validateSources: true
+		});
+		return success("read", startedAt, report, {
+			sessionId: session.sessionId,
+			revision: session.revision,
+			diagnostics: report.diagnostics.map(({ code, message, severity, path }) => ({
+				code,
+				message,
+				severity,
+				path
+			}))
+		});
+	}
 };
 //#endregion
 //#region src/services/runtime-service.ts
@@ -1273,7 +1294,9 @@ var RuntimeService = class {
 				createdAt: (/* @__PURE__ */ new Date()).toISOString(),
 				canonicalPathKey
 			}));
-			const document = await new _openfairygui_core_project_io.ProjectReader(createProjectReaderFileSystem(fileSystem)).read(fairyPath, { hydrateResourceBytes: true });
+			const read = await new _openfairygui_core_project_io.ProjectReader(createProjectReaderFileSystem(fileSystem)).readDetailed(fairyPath, { hydrateResourceBytes: true });
+			if (!read.document) throw new Error(read.diagnostics[0]?.message ?? `Unable to read project: ${fairyPath}`);
+			const document = read.document;
 			const project = (0, _openfairygui_core_uam.liftDocumentToUamProject)(document);
 			const sessionId = randomId();
 			const session = {
@@ -1285,6 +1308,8 @@ var RuntimeService = class {
 				sessionLock,
 				fileSystem,
 				project,
+				readDiagnostics: read.diagnostics,
+				readComplete: read.complete,
 				uamFidelity: await hasFullUamFidelity(document, project) ? "full" : "unsupported",
 				revision: 0,
 				lastSavedRevision: 0,
@@ -1348,6 +1373,8 @@ var RuntimeService = class {
 			sessionLock: null,
 			fileSystem: storage?.fileSystem,
 			project: (0, _openfairygui_core_uam.normalizeUamProject)(input.project),
+			readDiagnostics: [],
+			readComplete: true,
 			uamFidelity: "full",
 			revision: 0,
 			lastSavedRevision: 0,
@@ -1432,6 +1459,7 @@ const BACKEND_METHODS = [
 	"openProjectSession",
 	"getSession",
 	"getProjectOutline",
+	"validateSession",
 	"applyTransaction",
 	"saveSession",
 	"materializeSession",
@@ -1453,7 +1481,7 @@ const ARTIFACT_BRIDGE_CAPABILITY = {
 function createCapabilities() {
 	return {
 		contractVersion: BACKEND_CONTRACT_VERSION,
-		capabilitySchemaVersion: 2,
+		capabilitySchemaVersion: 3,
 		transactionKernelOwner: "@openfairygui/core",
 		appSeamOwner: "@openfairygui/functions",
 		runtimeOwner: "@openfairygui/backend",
@@ -1461,7 +1489,8 @@ function createCapabilities() {
 		read: {
 			capabilitySnapshot: true,
 			sessionSnapshot: true,
-			projectOutline: true
+			projectOutline: true,
+			projectValidation: true
 		},
 		authoring: {
 			applyTransaction: true,
@@ -1604,6 +1633,9 @@ var BackendRuntime = class {
 	getProjectOutline(input) {
 		return this.readService.getProjectOutline(input);
 	}
+	validateSession(input) {
+		return this.readService.validateSession(input);
+	}
 	async applyTransaction(input) {
 		return this.authoringService.applyTransaction(input);
 	}

package/dist/index.d.cts

@@ -1,10 +1,11 @@
 import { ApplyUamTransactionAppError } from "@openfairygui/functions/uam";
+import { ProjectValidationReport } from "@openfairygui/core";
 import { UamDisplayNodeKind, UamProject, UamResource, UamTransactionOperation } from "@openfairygui/core/uam";
 import { FileSystem } from "@openfairygui/core/project-io";
 
 //#region src/contracts.d.ts
 declare const BACKEND_CONTRACT_VERSION: "1.1.0-p2";
-declare const BACKEND_CAPABILITY_SCHEMA_VERSION: 2;
+declare const BACKEND_CAPABILITY_SCHEMA_VERSION: 3;
 declare const BACKEND_COMPATIBILITY_POLICY: {
   readonly incompatibleChange: "requires contractVersion bump";
   readonly capabilitySchemaChange: "requires capabilitySchemaVersion bump";
@@ -130,11 +131,12 @@ interface BackendCapabilities {
   transactionKernelOwner: '@openfairygui/core';
   appSeamOwner: '@openfairygui/functions';
   runtimeOwner: '@openfairygui/backend';
-  methods: readonly ['getCapabilities', 'openSession', 'openProjectSession', 'getSession', 'getProjectOutline', 'applyTransaction', 'saveSession', 'materializeSession', 'closeSession', 'getEvents', 'getJob', 'listJobs', 'cancelJob', 'getCacheSnapshot', 'refreshCache'];
+  methods: readonly ['getCapabilities', 'openSession', 'openProjectSession', 'getSession', 'getProjectOutline', 'validateSession', 'applyTransaction', 'saveSession', 'materializeSession', 'closeSession', 'getEvents', 'getJob', 'listJobs', 'cancelJob', 'getCacheSnapshot', 'refreshCache'];
   read: {
     capabilitySnapshot: true;
     sessionSnapshot: true;
     projectOutline: true;
+    projectValidation: true;
   };
   authoring: {
     applyTransaction: true;
@@ -474,6 +476,9 @@ interface ApplySessionTransactionInput {
 interface GetProjectOutlineInput {
   sessionId: string;
 }
+interface ValidateSessionInput {
+  sessionId: string;
+}
 interface OpenProjectSessionInput {
   /** Authoritative UAM project. Use BackendRuntime.openSession() when importing an existing project from storage. */
   project: UamProject;
@@ -538,6 +543,7 @@ declare class BackendRuntime {
     sessionId: string;
   }): BackendResult<BackendSessionSnapshot, SessionNotFoundError>;
   getProjectOutline(input: GetProjectOutlineInput): BackendResult<BackendProjectOutline, SessionNotFoundError>;
+  validateSession(input: ValidateSessionInput): BackendResult<ProjectValidationReport, SessionNotFoundError>;
   applyTransaction(input: ApplySessionTransactionInput): Promise<BackendResult<BackendSessionSnapshot, SessionNotFoundError | SessionStaleWriteError | ApplyUamTransactionAppError>>;
   saveSession(input: SaveSessionInput): Promise<BackendResult<BackendSessionSnapshot | MaterializeSessionSnapshot, SessionNotFoundError | SessionStaleWriteError | SavePartialFailureError | UamFidelityUnsupportedError | MaterializeValidationFailedError | MaterializeWriteFailedError | PathPolicyViolationError | InProcessLockConflictError | BackendCapabilityUnavailableError>>;
   materializeSession(input: MaterializeSessionInput): Promise<BackendResult<MaterializeSessionSnapshot, SessionNotFoundError | SessionStaleWriteError | UamFidelityUnsupportedError | MaterializeValidationFailedError | MaterializeWriteFailedError | PathPolicyViolationError | InProcessLockConflictError | BackendCapabilityUnavailableError>>;
@@ -590,4 +596,4 @@ interface BackendAsyncStorageAdapter {
 type BackendStorageFileSystem = BackendFileSystem & FileSystem;
 declare function createBackendStorageFileSystem(storage: BackendAsyncStorageAdapter): BackendStorageFileSystem;
 //#endregion
-export { type AdvisoryLockConflictError, type ApplySessionTransactionInput, BACKEND_CAPABILITY_SCHEMA_VERSION, BACKEND_COMPATIBILITY_POLICY, BACKEND_CONTRACT_VERSION, type BackendArtifactBridgeCapability, type BackendAsyncStorageAdapter, type BackendCacheEntry, type BackendCacheSnapshot, type BackendCapabilities, type BackendCapabilityManifest, type BackendCapabilityUnavailableError, type BackendDiagnostic, type BackendError, type BackendEvent, type BackendEventKind, type BackendFailure, type BackendFileStat, type BackendFileSystem, type BackendHostAdapter, type BackendJobErrors, type BackendJobKind, type BackendJobListSnapshot, type BackendJobListStatusFilter, type BackendJobNotCancellableError, type BackendJobNotFoundError, type BackendJobProgress, type BackendJobSnapshot, type BackendJobStatus, type BackendMessage, type BackendProjectOutline, type BackendProjectOutlinePackage, type BackendProjectOutlineResource, type BackendProjectSessionStorage, type BackendResponseMeta, type BackendResult, BackendRuntime, type BackendRuntimeOptions, type BackendSessionLock, type BackendSessionSnapshot, type BackendStage, type BackendStorageFileSystem, type BackendStorageStatLike, type BackendSuccess, type CacheRefreshFailedError, type CancelJobInput, type EventCursorInvalidError, type GetCacheSnapshotInput, type GetEventsInput, type GetEventsSnapshot, type GetJobInput, type GetProjectOutlineInput, type InProcessLockConflictError, type ListJobsInput, type MaterializeSessionInput, type MaterializeSessionSnapshot, type MaterializeValidationFailedError, type MaterializeWriteFailedError, type OpenProjectSessionInput, type RefreshCacheInput, type SavePartialFailureError, type SaveSessionInput, type SessionNotFoundError, type SessionStaleWriteError, type UamFidelityUnsupportedError, createBackendStorageFileSystem };
+export { type AdvisoryLockConflictError, type ApplySessionTransactionInput, BACKEND_CAPABILITY_SCHEMA_VERSION, BACKEND_COMPATIBILITY_POLICY, BACKEND_CONTRACT_VERSION, type BackendArtifactBridgeCapability, type BackendAsyncStorageAdapter, type BackendCacheEntry, type BackendCacheSnapshot, type BackendCapabilities, type BackendCapabilityManifest, type BackendCapabilityUnavailableError, type BackendDiagnostic, type BackendError, type BackendEvent, type BackendEventKind, type BackendFailure, type BackendFileStat, type BackendFileSystem, type BackendHostAdapter, type BackendJobErrors, type BackendJobKind, type BackendJobListSnapshot, type BackendJobListStatusFilter, type BackendJobNotCancellableError, type BackendJobNotFoundError, type BackendJobProgress, type BackendJobSnapshot, type BackendJobStatus, type BackendMessage, type BackendProjectOutline, type BackendProjectOutlinePackage, type BackendProjectOutlineResource, type BackendProjectSessionStorage, type BackendResponseMeta, type BackendResult, BackendRuntime, type BackendRuntimeOptions, type BackendSessionLock, type BackendSessionSnapshot, type BackendStage, type BackendStorageFileSystem, type BackendStorageStatLike, type BackendSuccess, type CacheRefreshFailedError, type CancelJobInput, type EventCursorInvalidError, type GetCacheSnapshotInput, type GetEventsInput, type GetEventsSnapshot, type GetJobInput, type GetProjectOutlineInput, type InProcessLockConflictError, type ListJobsInput, type MaterializeSessionInput, type MaterializeSessionSnapshot, type MaterializeValidationFailedError, type MaterializeWriteFailedError, type OpenProjectSessionInput, type RefreshCacheInput, type SavePartialFailureError, type SaveSessionInput, type SessionNotFoundError, type SessionStaleWriteError, type UamFidelityUnsupportedError, type ValidateSessionInput, createBackendStorageFileSystem };

package/dist/index.d.mts

@@ -1,10 +1,11 @@
 import { UamDisplayNodeKind, UamProject, UamResource, UamTransactionOperation } from "@openfairygui/core/uam";
 import { ApplyUamTransactionAppError } from "@openfairygui/functions/uam";
 import { FileSystem } from "@openfairygui/core/project-io";
+import { ProjectValidationReport } from "@openfairygui/core";
 
 //#region src/contracts.d.ts
 declare const BACKEND_CONTRACT_VERSION: "1.1.0-p2";
-declare const BACKEND_CAPABILITY_SCHEMA_VERSION: 2;
+declare const BACKEND_CAPABILITY_SCHEMA_VERSION: 3;
 declare const BACKEND_COMPATIBILITY_POLICY: {
   readonly incompatibleChange: "requires contractVersion bump";
   readonly capabilitySchemaChange: "requires capabilitySchemaVersion bump";
@@ -130,11 +131,12 @@ interface BackendCapabilities {
   transactionKernelOwner: '@openfairygui/core';
   appSeamOwner: '@openfairygui/functions';
   runtimeOwner: '@openfairygui/backend';
-  methods: readonly ['getCapabilities', 'openSession', 'openProjectSession', 'getSession', 'getProjectOutline', 'applyTransaction', 'saveSession', 'materializeSession', 'closeSession', 'getEvents', 'getJob', 'listJobs', 'cancelJob', 'getCacheSnapshot', 'refreshCache'];
+  methods: readonly ['getCapabilities', 'openSession', 'openProjectSession', 'getSession', 'getProjectOutline', 'validateSession', 'applyTransaction', 'saveSession', 'materializeSession', 'closeSession', 'getEvents', 'getJob', 'listJobs', 'cancelJob', 'getCacheSnapshot', 'refreshCache'];
   read: {
     capabilitySnapshot: true;
     sessionSnapshot: true;
     projectOutline: true;
+    projectValidation: true;
   };
   authoring: {
     applyTransaction: true;
@@ -474,6 +476,9 @@ interface ApplySessionTransactionInput {
 interface GetProjectOutlineInput {
   sessionId: string;
 }
+interface ValidateSessionInput {
+  sessionId: string;
+}
 interface OpenProjectSessionInput {
   /** Authoritative UAM project. Use BackendRuntime.openSession() when importing an existing project from storage. */
   project: UamProject;
@@ -538,6 +543,7 @@ declare class BackendRuntime {
     sessionId: string;
   }): BackendResult<BackendSessionSnapshot, SessionNotFoundError>;
   getProjectOutline(input: GetProjectOutlineInput): BackendResult<BackendProjectOutline, SessionNotFoundError>;
+  validateSession(input: ValidateSessionInput): BackendResult<ProjectValidationReport, SessionNotFoundError>;
   applyTransaction(input: ApplySessionTransactionInput): Promise<BackendResult<BackendSessionSnapshot, SessionNotFoundError | SessionStaleWriteError | ApplyUamTransactionAppError>>;
   saveSession(input: SaveSessionInput): Promise<BackendResult<BackendSessionSnapshot | MaterializeSessionSnapshot, SessionNotFoundError | SessionStaleWriteError | SavePartialFailureError | UamFidelityUnsupportedError | MaterializeValidationFailedError | MaterializeWriteFailedError | PathPolicyViolationError | InProcessLockConflictError | BackendCapabilityUnavailableError>>;
   materializeSession(input: MaterializeSessionInput): Promise<BackendResult<MaterializeSessionSnapshot, SessionNotFoundError | SessionStaleWriteError | UamFidelityUnsupportedError | MaterializeValidationFailedError | MaterializeWriteFailedError | PathPolicyViolationError | InProcessLockConflictError | BackendCapabilityUnavailableError>>;
@@ -590,4 +596,4 @@ interface BackendAsyncStorageAdapter {
 type BackendStorageFileSystem = BackendFileSystem & FileSystem;
 declare function createBackendStorageFileSystem(storage: BackendAsyncStorageAdapter): BackendStorageFileSystem;
 //#endregion
-export { type AdvisoryLockConflictError, type ApplySessionTransactionInput, BACKEND_CAPABILITY_SCHEMA_VERSION, BACKEND_COMPATIBILITY_POLICY, BACKEND_CONTRACT_VERSION, type BackendArtifactBridgeCapability, type BackendAsyncStorageAdapter, type BackendCacheEntry, type BackendCacheSnapshot, type BackendCapabilities, type BackendCapabilityManifest, type BackendCapabilityUnavailableError, type BackendDiagnostic, type BackendError, type BackendEvent, type BackendEventKind, type BackendFailure, type BackendFileStat, type BackendFileSystem, type BackendHostAdapter, type BackendJobErrors, type BackendJobKind, type BackendJobListSnapshot, type BackendJobListStatusFilter, type BackendJobNotCancellableError, type BackendJobNotFoundError, type BackendJobProgress, type BackendJobSnapshot, type BackendJobStatus, type BackendMessage, type BackendProjectOutline, type BackendProjectOutlinePackage, type BackendProjectOutlineResource, type BackendProjectSessionStorage, type BackendResponseMeta, type BackendResult, BackendRuntime, type BackendRuntimeOptions, type BackendSessionLock, type BackendSessionSnapshot, type BackendStage, type BackendStorageFileSystem, type BackendStorageStatLike, type BackendSuccess, type CacheRefreshFailedError, type CancelJobInput, type EventCursorInvalidError, type GetCacheSnapshotInput, type GetEventsInput, type GetEventsSnapshot, type GetJobInput, type GetProjectOutlineInput, type InProcessLockConflictError, type ListJobsInput, type MaterializeSessionInput, type MaterializeSessionSnapshot, type MaterializeValidationFailedError, type MaterializeWriteFailedError, type OpenProjectSessionInput, type RefreshCacheInput, type SavePartialFailureError, type SaveSessionInput, type SessionNotFoundError, type SessionStaleWriteError, type UamFidelityUnsupportedError, createBackendStorageFileSystem };
+export { type AdvisoryLockConflictError, type ApplySessionTransactionInput, BACKEND_CAPABILITY_SCHEMA_VERSION, BACKEND_COMPATIBILITY_POLICY, BACKEND_CONTRACT_VERSION, type BackendArtifactBridgeCapability, type BackendAsyncStorageAdapter, type BackendCacheEntry, type BackendCacheSnapshot, type BackendCapabilities, type BackendCapabilityManifest, type BackendCapabilityUnavailableError, type BackendDiagnostic, type BackendError, type BackendEvent, type BackendEventKind, type BackendFailure, type BackendFileStat, type BackendFileSystem, type BackendHostAdapter, type BackendJobErrors, type BackendJobKind, type BackendJobListSnapshot, type BackendJobListStatusFilter, type BackendJobNotCancellableError, type BackendJobNotFoundError, type BackendJobProgress, type BackendJobSnapshot, type BackendJobStatus, type BackendMessage, type BackendProjectOutline, type BackendProjectOutlinePackage, type BackendProjectOutlineResource, type BackendProjectSessionStorage, type BackendResponseMeta, type BackendResult, BackendRuntime, type BackendRuntimeOptions, type BackendSessionLock, type BackendSessionSnapshot, type BackendStage, type BackendStorageFileSystem, type BackendStorageStatLike, type BackendSuccess, type CacheRefreshFailedError, type CancelJobInput, type EventCursorInvalidError, type GetCacheSnapshotInput, type GetEventsInput, type GetEventsSnapshot, type GetJobInput, type GetProjectOutlineInput, type InProcessLockConflictError, type ListJobsInput, type MaterializeSessionInput, type MaterializeSessionSnapshot, type MaterializeValidationFailedError, type MaterializeWriteFailedError, type OpenProjectSessionInput, type RefreshCacheInput, type SavePartialFailureError, type SaveSessionInput, type SessionNotFoundError, type SessionStaleWriteError, type UamFidelityUnsupportedError, type ValidateSessionInput, createBackendStorageFileSystem };

package/dist/index.mjs

@@ -1,9 +1,10 @@
 import { UAM_SUPPORTED_MATERIALIZATION_SCOPE, UAM_SUPPORTED_TRANSACTION_SCOPE, commitUamProjectSourcePaths, liftDocumentToUamProject, materializeUamProject, normalizeUamProject, staleBranchDirectories, staleResourceFolders, staleSourceFiles, validateUamProject } from "@openfairygui/core/uam";
 import { applyUamTransactionAppAsync } from "@openfairygui/functions/uam";
 import { ProjectReader, ProjectWriter } from "@openfairygui/core/project-io";
+import { validateProject } from "@openfairygui/functions";
 //#region src/contracts.ts
 const BACKEND_CONTRACT_VERSION = "1.1.0-p2";
-const BACKEND_CAPABILITY_SCHEMA_VERSION = 2;
+const BACKEND_CAPABILITY_SCHEMA_VERSION = 3;
 const BACKEND_COMPATIBILITY_POLICY = {
 	incompatibleChange: "requires contractVersion bump",
 	capabilitySchemaChange: "requires capabilitySchemaVersion bump",
@@ -96,7 +97,7 @@ function createMeta(stage, startedAt, options) {
 		diagnostics: options?.diagnostics ?? [],
 		stage,
 		contractVersion: BACKEND_CONTRACT_VERSION,
-		capabilitySchemaVersion: 2
+		capabilitySchemaVersion: 3
 	};
 }
 function success(stage, startedAt, data, options) {
@@ -1117,6 +1118,26 @@ var ReadService = class {
 			revision: session.revision
 		});
 	}
+	validateSession(input) {
+		const startedAt = Date.now();
+		const session = this.context.sessions.get(input.sessionId);
+		if (!session || session.closed) return failure("read", startedAt, createSessionNotFoundError(input.sessionId));
+		const report = validateProject(session.project, {
+			readDiagnostics: session.readDiagnostics,
+			complete: session.readComplete,
+			validateSources: true
+		});
+		return success("read", startedAt, report, {
+			sessionId: session.sessionId,
+			revision: session.revision,
+			diagnostics: report.diagnostics.map(({ code, message, severity, path }) => ({
+				code,
+				message,
+				severity,
+				path
+			}))
+		});
+	}
 };
 //#endregion
 //#region src/services/runtime-service.ts
@@ -1272,7 +1293,9 @@ var RuntimeService = class {
 				createdAt: (/* @__PURE__ */ new Date()).toISOString(),
 				canonicalPathKey
 			}));
-			const document = await new ProjectReader(createProjectReaderFileSystem(fileSystem)).read(fairyPath, { hydrateResourceBytes: true });
+			const read = await new ProjectReader(createProjectReaderFileSystem(fileSystem)).readDetailed(fairyPath, { hydrateResourceBytes: true });
+			if (!read.document) throw new Error(read.diagnostics[0]?.message ?? `Unable to read project: ${fairyPath}`);
+			const document = read.document;
 			const project = liftDocumentToUamProject(document);
 			const sessionId = randomId();
 			const session = {
@@ -1284,6 +1307,8 @@ var RuntimeService = class {
 				sessionLock,
 				fileSystem,
 				project,
+				readDiagnostics: read.diagnostics,
+				readComplete: read.complete,
 				uamFidelity: await hasFullUamFidelity(document, project) ? "full" : "unsupported",
 				revision: 0,
 				lastSavedRevision: 0,
@@ -1347,6 +1372,8 @@ var RuntimeService = class {
 			sessionLock: null,
 			fileSystem: storage?.fileSystem,
 			project: normalizeUamProject(input.project),
+			readDiagnostics: [],
+			readComplete: true,
 			uamFidelity: "full",
 			revision: 0,
 			lastSavedRevision: 0,
@@ -1431,6 +1458,7 @@ const BACKEND_METHODS = [
 	"openProjectSession",
 	"getSession",
 	"getProjectOutline",
+	"validateSession",
 	"applyTransaction",
 	"saveSession",
 	"materializeSession",
@@ -1452,7 +1480,7 @@ const ARTIFACT_BRIDGE_CAPABILITY = {
 function createCapabilities() {
 	return {
 		contractVersion: BACKEND_CONTRACT_VERSION,
-		capabilitySchemaVersion: 2,
+		capabilitySchemaVersion: 3,
 		transactionKernelOwner: "@openfairygui/core",
 		appSeamOwner: "@openfairygui/functions",
 		runtimeOwner: "@openfairygui/backend",
@@ -1460,7 +1488,8 @@ function createCapabilities() {
 		read: {
 			capabilitySnapshot: true,
 			sessionSnapshot: true,
-			projectOutline: true
+			projectOutline: true,
+			projectValidation: true
 		},
 		authoring: {
 			applyTransaction: true,
@@ -1603,6 +1632,9 @@ var BackendRuntime = class {
 	getProjectOutline(input) {
 		return this.readService.getProjectOutline(input);
 	}
+	validateSession(input) {
+		return this.readService.validateSession(input);
+	}
 	async applyTransaction(input) {
 		return this.authoringService.applyTransaction(input);
 	}

package/dist/node.cjs

@@ -28,6 +28,7 @@ node_path = __toESM(node_path);
 let _openfairygui_core_uam = require("@openfairygui/core/uam");
 let _openfairygui_functions_uam = require("@openfairygui/functions/uam");
 let _openfairygui_core_project_io = require("@openfairygui/core/project-io");
+let _openfairygui_functions = require("@openfairygui/functions");
 //#region src/path-policy.ts
 function normalizeComparablePath(value) {
 	const normalized = value.replace(/[/\\]+$/, "").replace(/\\/g, "/");
@@ -122,7 +123,7 @@ function createMeta(stage, startedAt, options) {
 		diagnostics: options?.diagnostics ?? [],
 		stage,
 		contractVersion: BACKEND_CONTRACT_VERSION,
-		capabilitySchemaVersion: 2
+		capabilitySchemaVersion: 3
 	};
 }
 function success(stage, startedAt, data, options) {
@@ -1143,6 +1144,26 @@ var ReadService = class {
 			revision: session.revision
 		});
 	}
+	validateSession(input) {
+		const startedAt = Date.now();
+		const session = this.context.sessions.get(input.sessionId);
+		if (!session || session.closed) return failure("read", startedAt, createSessionNotFoundError(input.sessionId));
+		const report = (0, _openfairygui_functions.validateProject)(session.project, {
+			readDiagnostics: session.readDiagnostics,
+			complete: session.readComplete,
+			validateSources: true
+		});
+		return success("read", startedAt, report, {
+			sessionId: session.sessionId,
+			revision: session.revision,
+			diagnostics: report.diagnostics.map(({ code, message, severity, path }) => ({
+				code,
+				message,
+				severity,
+				path
+			}))
+		});
+	}
 };
 //#endregion
 //#region src/services/runtime-service.ts
@@ -1298,7 +1319,9 @@ var RuntimeService = class {
 				createdAt: (/* @__PURE__ */ new Date()).toISOString(),
 				canonicalPathKey
 			}));
-			const document = await new _openfairygui_core_project_io.ProjectReader(createProjectReaderFileSystem(fileSystem)).read(fairyPath, { hydrateResourceBytes: true });
+			const read = await new _openfairygui_core_project_io.ProjectReader(createProjectReaderFileSystem(fileSystem)).readDetailed(fairyPath, { hydrateResourceBytes: true });
+			if (!read.document) throw new Error(read.diagnostics[0]?.message ?? `Unable to read project: ${fairyPath}`);
+			const document = read.document;
 			const project = (0, _openfairygui_core_uam.liftDocumentToUamProject)(document);
 			const sessionId = randomId();
 			const session = {
@@ -1310,6 +1333,8 @@ var RuntimeService = class {
 				sessionLock,
 				fileSystem,
 				project,
+				readDiagnostics: read.diagnostics,
+				readComplete: read.complete,
 				uamFidelity: await hasFullUamFidelity(document, project) ? "full" : "unsupported",
 				revision: 0,
 				lastSavedRevision: 0,
@@ -1373,6 +1398,8 @@ var RuntimeService = class {
 			sessionLock: null,
 			fileSystem: storage?.fileSystem,
 			project: (0, _openfairygui_core_uam.normalizeUamProject)(input.project),
+			readDiagnostics: [],
+			readComplete: true,
 			uamFidelity: "full",
 			revision: 0,
 			lastSavedRevision: 0,
@@ -1457,6 +1484,7 @@ const BACKEND_METHODS = [
 	"openProjectSession",
 	"getSession",
 	"getProjectOutline",
+	"validateSession",
 	"applyTransaction",
 	"saveSession",
 	"materializeSession",
@@ -1478,7 +1506,7 @@ const ARTIFACT_BRIDGE_CAPABILITY = {
 function createCapabilities() {
 	return {
 		contractVersion: BACKEND_CONTRACT_VERSION,
-		capabilitySchemaVersion: 2,
+		capabilitySchemaVersion: 3,
 		transactionKernelOwner: "@openfairygui/core",
 		appSeamOwner: "@openfairygui/functions",
 		runtimeOwner: "@openfairygui/backend",
@@ -1486,7 +1514,8 @@ function createCapabilities() {
 		read: {
 			capabilitySnapshot: true,
 			sessionSnapshot: true,
-			projectOutline: true
+			projectOutline: true,
+			projectValidation: true
 		},
 		authoring: {
 			applyTransaction: true,
@@ -1629,6 +1658,9 @@ var BackendRuntime = class {
 	getProjectOutline(input) {
 		return this.readService.getProjectOutline(input);
 	}
+	validateSession(input) {
+		return this.readService.validateSession(input);
+	}
 	async applyTransaction(input) {
 		return this.authoringService.applyTransaction(input);
 	}

package/dist/node.d.cts

@@ -1,4 +1,5 @@
 import { ApplyUamTransactionAppError } from "@openfairygui/functions/uam";
+import { ProjectValidationReport } from "@openfairygui/core";
 import { UamDisplayNodeKind, UamProject, UamResource, UamTransactionOperation } from "@openfairygui/core/uam";
 
 //#region src/path-policy.d.ts
@@ -12,7 +13,7 @@ interface PathPolicyViolationError {
 //#endregion
 //#region src/contracts.d.ts
 declare const BACKEND_CONTRACT_VERSION: "1.1.0-p2";
-declare const BACKEND_CAPABILITY_SCHEMA_VERSION: 2;
+declare const BACKEND_CAPABILITY_SCHEMA_VERSION: 3;
 declare const BACKEND_COMPATIBILITY_POLICY: {
   readonly incompatibleChange: "requires contractVersion bump";
   readonly capabilitySchemaChange: "requires capabilitySchemaVersion bump";
@@ -129,11 +130,12 @@ interface BackendCapabilities {
   transactionKernelOwner: '@openfairygui/core';
   appSeamOwner: '@openfairygui/functions';
   runtimeOwner: '@openfairygui/backend';
-  methods: readonly ['getCapabilities', 'openSession', 'openProjectSession', 'getSession', 'getProjectOutline', 'applyTransaction', 'saveSession', 'materializeSession', 'closeSession', 'getEvents', 'getJob', 'listJobs', 'cancelJob', 'getCacheSnapshot', 'refreshCache'];
+  methods: readonly ['getCapabilities', 'openSession', 'openProjectSession', 'getSession', 'getProjectOutline', 'validateSession', 'applyTransaction', 'saveSession', 'materializeSession', 'closeSession', 'getEvents', 'getJob', 'listJobs', 'cancelJob', 'getCacheSnapshot', 'refreshCache'];
   read: {
     capabilitySnapshot: true;
     sessionSnapshot: true;
     projectOutline: true;
+    projectValidation: true;
   };
   authoring: {
     applyTransaction: true;
@@ -472,6 +474,9 @@ interface ApplySessionTransactionInput {
 interface GetProjectOutlineInput {
   sessionId: string;
 }
+interface ValidateSessionInput {
+  sessionId: string;
+}
 interface OpenProjectSessionInput {
   /** Authoritative UAM project. Use BackendRuntime.openSession() when importing an existing project from storage. */
   project: UamProject;
@@ -536,6 +541,7 @@ declare class BackendRuntime {
     sessionId: string;
   }): BackendResult<BackendSessionSnapshot, SessionNotFoundError>;
   getProjectOutline(input: GetProjectOutlineInput): BackendResult<BackendProjectOutline, SessionNotFoundError>;
+  validateSession(input: ValidateSessionInput): BackendResult<ProjectValidationReport, SessionNotFoundError>;
   applyTransaction(input: ApplySessionTransactionInput): Promise<BackendResult<BackendSessionSnapshot, SessionNotFoundError | SessionStaleWriteError | ApplyUamTransactionAppError>>;
   saveSession(input: SaveSessionInput): Promise<BackendResult<BackendSessionSnapshot | MaterializeSessionSnapshot, SessionNotFoundError | SessionStaleWriteError | SavePartialFailureError | UamFidelityUnsupportedError | MaterializeValidationFailedError | MaterializeWriteFailedError | PathPolicyViolationError | InProcessLockConflictError | BackendCapabilityUnavailableError>>;
   materializeSession(input: MaterializeSessionInput): Promise<BackendResult<MaterializeSessionSnapshot, SessionNotFoundError | SessionStaleWriteError | UamFidelityUnsupportedError | MaterializeValidationFailedError | MaterializeWriteFailedError | PathPolicyViolationError | InProcessLockConflictError | BackendCapabilityUnavailableError>>;

package/dist/node.d.mts

@@ -1,5 +1,6 @@
 import { UamDisplayNodeKind, UamProject, UamResource, UamTransactionOperation } from "@openfairygui/core/uam";
 import { ApplyUamTransactionAppError } from "@openfairygui/functions/uam";
+import { ProjectValidationReport } from "@openfairygui/core";
 
 //#region src/path-policy.d.ts
 interface PathPolicyViolationError {
@@ -12,7 +13,7 @@ interface PathPolicyViolationError {
 //#endregion
 //#region src/contracts.d.ts
 declare const BACKEND_CONTRACT_VERSION: "1.1.0-p2";
-declare const BACKEND_CAPABILITY_SCHEMA_VERSION: 2;
+declare const BACKEND_CAPABILITY_SCHEMA_VERSION: 3;
 declare const BACKEND_COMPATIBILITY_POLICY: {
   readonly incompatibleChange: "requires contractVersion bump";
   readonly capabilitySchemaChange: "requires capabilitySchemaVersion bump";
@@ -129,11 +130,12 @@ interface BackendCapabilities {
   transactionKernelOwner: '@openfairygui/core';
   appSeamOwner: '@openfairygui/functions';
   runtimeOwner: '@openfairygui/backend';
-  methods: readonly ['getCapabilities', 'openSession', 'openProjectSession', 'getSession', 'getProjectOutline', 'applyTransaction', 'saveSession', 'materializeSession', 'closeSession', 'getEvents', 'getJob', 'listJobs', 'cancelJob', 'getCacheSnapshot', 'refreshCache'];
+  methods: readonly ['getCapabilities', 'openSession', 'openProjectSession', 'getSession', 'getProjectOutline', 'validateSession', 'applyTransaction', 'saveSession', 'materializeSession', 'closeSession', 'getEvents', 'getJob', 'listJobs', 'cancelJob', 'getCacheSnapshot', 'refreshCache'];
   read: {
     capabilitySnapshot: true;
     sessionSnapshot: true;
     projectOutline: true;
+    projectValidation: true;
   };
   authoring: {
     applyTransaction: true;
@@ -472,6 +474,9 @@ interface ApplySessionTransactionInput {
 interface GetProjectOutlineInput {
   sessionId: string;
 }
+interface ValidateSessionInput {
+  sessionId: string;
+}
 interface OpenProjectSessionInput {
   /** Authoritative UAM project. Use BackendRuntime.openSession() when importing an existing project from storage. */
   project: UamProject;
@@ -536,6 +541,7 @@ declare class BackendRuntime {
     sessionId: string;
   }): BackendResult<BackendSessionSnapshot, SessionNotFoundError>;
   getProjectOutline(input: GetProjectOutlineInput): BackendResult<BackendProjectOutline, SessionNotFoundError>;
+  validateSession(input: ValidateSessionInput): BackendResult<ProjectValidationReport, SessionNotFoundError>;
   applyTransaction(input: ApplySessionTransactionInput): Promise<BackendResult<BackendSessionSnapshot, SessionNotFoundError | SessionStaleWriteError | ApplyUamTransactionAppError>>;
   saveSession(input: SaveSessionInput): Promise<BackendResult<BackendSessionSnapshot | MaterializeSessionSnapshot, SessionNotFoundError | SessionStaleWriteError | SavePartialFailureError | UamFidelityUnsupportedError | MaterializeValidationFailedError | MaterializeWriteFailedError | PathPolicyViolationError | InProcessLockConflictError | BackendCapabilityUnavailableError>>;
   materializeSession(input: MaterializeSessionInput): Promise<BackendResult<MaterializeSessionSnapshot, SessionNotFoundError | SessionStaleWriteError | UamFidelityUnsupportedError | MaterializeValidationFailedError | MaterializeWriteFailedError | PathPolicyViolationError | InProcessLockConflictError | BackendCapabilityUnavailableError>>;

package/dist/node.mjs

@@ -3,6 +3,7 @@ import path from "node:path";
 import { UAM_SUPPORTED_MATERIALIZATION_SCOPE, UAM_SUPPORTED_TRANSACTION_SCOPE, commitUamProjectSourcePaths, liftDocumentToUamProject, materializeUamProject, normalizeUamProject, staleBranchDirectories, staleResourceFolders, staleSourceFiles, validateUamProject } from "@openfairygui/core/uam";
 import { applyUamTransactionAppAsync } from "@openfairygui/functions/uam";
 import { ProjectReader, ProjectWriter } from "@openfairygui/core/project-io";
+import { validateProject } from "@openfairygui/functions";
 //#region src/path-policy.ts
 function normalizeComparablePath(value) {
 	const normalized = value.replace(/[/\\]+$/, "").replace(/\\/g, "/");
@@ -97,7 +98,7 @@ function createMeta(stage, startedAt, options) {
 		diagnostics: options?.diagnostics ?? [],
 		stage,
 		contractVersion: BACKEND_CONTRACT_VERSION,
-		capabilitySchemaVersion: 2
+		capabilitySchemaVersion: 3
 	};
 }
 function success(stage, startedAt, data, options) {
@@ -1118,6 +1119,26 @@ var ReadService = class {
 			revision: session.revision
 		});
 	}
+	validateSession(input) {
+		const startedAt = Date.now();
+		const session = this.context.sessions.get(input.sessionId);
+		if (!session || session.closed) return failure("read", startedAt, createSessionNotFoundError(input.sessionId));
+		const report = validateProject(session.project, {
+			readDiagnostics: session.readDiagnostics,
+			complete: session.readComplete,
+			validateSources: true
+		});
+		return success("read", startedAt, report, {
+			sessionId: session.sessionId,
+			revision: session.revision,
+			diagnostics: report.diagnostics.map(({ code, message, severity, path }) => ({
+				code,
+				message,
+				severity,
+				path
+			}))
+		});
+	}
 };
 //#endregion
 //#region src/services/runtime-service.ts
@@ -1273,7 +1294,9 @@ var RuntimeService = class {
 				createdAt: (/* @__PURE__ */ new Date()).toISOString(),
 				canonicalPathKey
 			}));
-			const document = await new ProjectReader(createProjectReaderFileSystem(fileSystem)).read(fairyPath, { hydrateResourceBytes: true });
+			const read = await new ProjectReader(createProjectReaderFileSystem(fileSystem)).readDetailed(fairyPath, { hydrateResourceBytes: true });
+			if (!read.document) throw new Error(read.diagnostics[0]?.message ?? `Unable to read project: ${fairyPath}`);
+			const document = read.document;
 			const project = liftDocumentToUamProject(document);
 			const sessionId = randomId();
 			const session = {
@@ -1285,6 +1308,8 @@ var RuntimeService = class {
 				sessionLock,
 				fileSystem,
 				project,
+				readDiagnostics: read.diagnostics,
+				readComplete: read.complete,
 				uamFidelity: await hasFullUamFidelity(document, project) ? "full" : "unsupported",
 				revision: 0,
 				lastSavedRevision: 0,
@@ -1348,6 +1373,8 @@ var RuntimeService = class {
 			sessionLock: null,
 			fileSystem: storage?.fileSystem,
 			project: normalizeUamProject(input.project),
+			readDiagnostics: [],
+			readComplete: true,
 			uamFidelity: "full",
 			revision: 0,
 			lastSavedRevision: 0,
@@ -1432,6 +1459,7 @@ const BACKEND_METHODS = [
 	"openProjectSession",
 	"getSession",
 	"getProjectOutline",
+	"validateSession",
 	"applyTransaction",
 	"saveSession",
 	"materializeSession",
@@ -1453,7 +1481,7 @@ const ARTIFACT_BRIDGE_CAPABILITY = {
 function createCapabilities() {
 	return {
 		contractVersion: BACKEND_CONTRACT_VERSION,
-		capabilitySchemaVersion: 2,
+		capabilitySchemaVersion: 3,
 		transactionKernelOwner: "@openfairygui/core",
 		appSeamOwner: "@openfairygui/functions",
 		runtimeOwner: "@openfairygui/backend",
@@ -1461,7 +1489,8 @@ function createCapabilities() {
 		read: {
 			capabilitySnapshot: true,
 			sessionSnapshot: true,
-			projectOutline: true
+			projectOutline: true,
+			projectValidation: true
 		},
 		authoring: {
 			applyTransaction: true,
@@ -1604,6 +1633,9 @@ var BackendRuntime = class {
 	getProjectOutline(input) {
 		return this.readService.getProjectOutline(input);
 	}
+	validateSession(input) {
+		return this.readService.validateSession(input);
+	}
 	async applyTransaction(input) {
 		return this.authoringService.applyTransaction(input);
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfairygui/backend",
-  "version": "0.3.0-alpha.1",
+  "version": "0.3.0-alpha.3",
   "description": "FairyGUI Headless Authoring SDK — stateful backend runtime and session services.",
   "author": "OpenFairyGUI Contributors",
   "license": "MIT",
@@ -52,8 +52,8 @@
     "runtime"
   ],
   "dependencies": {
-    "@openfairygui/functions": "0.3.0-alpha.1",
-    "@openfairygui/core": "0.3.0-alpha.1"
+    "@openfairygui/functions": "0.3.0-alpha.3",
+    "@openfairygui/core": "0.3.0-alpha.3"
   },
   "devDependencies": {
     "ava": "^7.0.0",

package/src/contracts.ts

@@ -1,5 +1,5 @@
 export const BACKEND_CONTRACT_VERSION = '1.1.0-p2' as const;
-export const BACKEND_CAPABILITY_SCHEMA_VERSION = 2 as const;
+export const BACKEND_CAPABILITY_SCHEMA_VERSION = 3 as const;
 export const BACKEND_COMPATIBILITY_POLICY = {
 	incompatibleChange: 'requires contractVersion bump',
 	capabilitySchemaChange: 'requires capabilitySchemaVersion bump',

package/src/index.ts

@@ -63,6 +63,7 @@ export {
 	type SessionNotFoundError,
 	type SessionStaleWriteError,
 	type UamFidelityUnsupportedError,
+	type ValidateSessionInput,
 } from './runtime.js';
 export {
 	type BackendAsyncStorageAdapter,

package/src/runtime/capabilities.ts

@@ -17,6 +17,7 @@ const BACKEND_METHODS = [
 	'openProjectSession',
 	'getSession',
 	'getProjectOutline',
+	'validateSession',
 	'applyTransaction',
 	'saveSession',
 	'materializeSession',
@@ -49,6 +50,7 @@ export function createCapabilities(): BackendCapabilities {
 			capabilitySnapshot: true,
 			sessionSnapshot: true,
 			projectOutline: true,
+			projectValidation: true,
 		},
 		authoring: {
 			applyTransaction: true,

package/src/runtime/contracts.ts

@@ -100,6 +100,7 @@ export interface BackendCapabilities {
 		'openProjectSession',
 		'getSession',
 		'getProjectOutline',
+		'validateSession',
 		'applyTransaction',
 		'saveSession',
 		'materializeSession',
@@ -115,6 +116,7 @@ export interface BackendCapabilities {
 		capabilitySnapshot: true;
 		sessionSnapshot: true;
 		projectOutline: true;
+		projectValidation: true;
 	};
 	authoring: {
 		applyTransaction: true;
@@ -518,6 +520,10 @@ export interface GetProjectOutlineInput {
 	sessionId: string;
 }
 
+export interface ValidateSessionInput {
+	sessionId: string;
+}
+
 export interface OpenProjectSessionInput {
 	/** Authoritative UAM project. Use BackendRuntime.openSession() when importing an existing project from storage. */
 	project: UamProject;

package/src/runtime.ts

@@ -1,4 +1,5 @@
 import type { ApplyUamTransactionAppError } from '@openfairygui/functions/uam';
+import type { ProjectValidationReport } from '@openfairygui/core';
 import type { PathPolicyViolationError } from './path-policy.js';
 import { AuthoringService } from './services/authoring-service.js';
 import { CacheService } from './services/cache-service.js';
@@ -33,6 +34,7 @@ import type {
 	GetEventsSnapshot,
 	GetJobInput,
 	GetProjectOutlineInput,
+	ValidateSessionInput,
 	InProcessLockConflictError,
 	ListJobsInput,
 	MaterializeSessionInput,
@@ -121,6 +123,12 @@ export class BackendRuntime {
 		return this.readService.getProjectOutline(input);
 	}
 
+	public validateSession(
+		input: ValidateSessionInput,
+	): BackendResult<ProjectValidationReport, SessionNotFoundError> {
+		return this.readService.validateSession(input);
+	}
+
 	public async applyTransaction(
 		input: ApplySessionTransactionInput,
 	): Promise<

package/src/services/context.ts

@@ -29,6 +29,8 @@ export interface BackendSessionState {
 	sessionLock: BackendSessionLock | null;
 	fileSystem?: BackendFileSystem;
 	project: import('@openfairygui/core/uam').UamProject;
+	readDiagnostics: import('@openfairygui/core').ProjectDiagnostic[];
+	readComplete: boolean;
 	uamFidelity: 'full' | 'unsupported';
 	revision: number;
 	lastSavedRevision: number;

package/src/services/read-service.ts

@@ -8,6 +8,8 @@ import type {
 	SessionNotFoundError,
 } from '../runtime.js';
 import { createSessionNotFoundError, toSessionSnapshot } from './session-utils.js';
+import { validateProject } from '@openfairygui/functions';
+import type { ProjectValidationReport } from '@openfairygui/core';
 
 function toProjectOutline(session: BackendSessionState): BackendProjectOutline {
 	const project = session.project;
@@ -81,4 +83,24 @@ export class ReadService {
 			revision: session.revision,
 		});
 	}
+
+	public validateSession(
+		input: { sessionId: string },
+	): BackendResult<ProjectValidationReport, SessionNotFoundError> {
+		const startedAt = Date.now();
+		const session = this.context.sessions.get(input.sessionId);
+		if (!session || session.closed) {
+			return failure('read', startedAt, createSessionNotFoundError(input.sessionId));
+		}
+		const report = validateProject(session.project, {
+			readDiagnostics: session.readDiagnostics,
+			complete: session.readComplete,
+			validateSources: true,
+		});
+		return success('read', startedAt, report, {
+			sessionId: session.sessionId,
+			revision: session.revision,
+			diagnostics: report.diagnostics.map(({ code, message, severity, path }) => ({ code, message, severity, path })),
+		});
+	}
 }

package/src/services/runtime-service.ts

@@ -220,7 +220,9 @@ export class RuntimeService {
 				),
 			);
 			const reader = new ProjectReader(createProjectReaderFileSystem(fileSystem));
-			const document = await reader.read(fairyPath, { hydrateResourceBytes: true });
+			const read = await reader.readDetailed(fairyPath, { hydrateResourceBytes: true });
+			if (!read.document) throw new Error(read.diagnostics[0]?.message ?? `Unable to read project: ${fairyPath}`);
+			const document = read.document;
 			const project = liftDocumentToUamProject(document);
 			const sessionId = randomId();
 			const session: BackendSessionState = {
@@ -232,6 +234,8 @@ export class RuntimeService {
 				sessionLock,
 				fileSystem,
 				project,
+				readDiagnostics: read.diagnostics,
+				readComplete: read.complete,
 				uamFidelity: (await hasFullUamFidelity(document, project)) ? 'full' : 'unsupported',
 				revision: 0,
 				lastSavedRevision: 0,
@@ -305,6 +309,8 @@ export class RuntimeService {
 			sessionLock: null,
 			fileSystem: storage?.fileSystem,
 			project: normalizeUamProject(input.project),
+			readDiagnostics: [],
+			readComplete: true,
 			uamFidelity: 'full',
 			revision: 0,
 			lastSavedRevision: 0,