ruvnet/ruflo · error

Unknown message update during migration:

Error message

Unknown message update during migration:

What it means

Log warning in convertMessageUpdate: the stored message update has an unrecognized type that no migration branch handles, so the update cannot be converted and null is returned to drop it from the migrated conversation.

Source

Thrown at ruflo/src/ruvocal/src/lib/migrations/routines/04-update-message-updates.ts:117

			return {
				type: MessageUpdateType.Status,
				status,
				message: update.message,
			};
		} else if (update.type === "error") {
			// Treat it as an error status update
			return {
				type: MessageUpdateType.Status,
				status: MessageUpdateStatus.Error,
				message: update.message,
			};
		}

		// Web Search
		else if (update.type === "webSearch") {
			return null; // Web search updates are no longer supported
		}
		console.warn("Unknown message update during migration:", update);
		return null;
	} catch (error) {
		console.error("Error converting message update during migration. Skipping it... Error:", error);
		return null;
	}
}

const updateMessageUpdates: Migration = {
	_id: new ObjectId("5f9f7f7f7f7f7f7f7f7f7f7f"),
	name: "Convert message updates to the new schema",
	up: async () => {
		const allConversations = collections.conversations.find({});

		let conversation: WithId<Pick<Conversation, "messages">> | null = null;
		while ((conversation = await allConversations.tryNext())) {
			const messages = conversation.messages.map((message) => {
				// Convert all of the existing updates to the new schema
				const updates = message.updates

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Inspect the unknown message update shape in the log; add a migration handler for that type or clean up the stale rows.

When it happens

Trigger: Thrown at ruflo/src/ruvocal/src/lib/migrations/routines/04-update-message-updates.ts:117 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ruvnet/ruflo@fa13ee4ad6 (2026-08-18). Data as JSON: /api/errors/b57d1ad2919cc9e2. Report an issue: GitHub.