refactor: rename transcribedText field to transcript

apps/whispering/src/lib/components/MigrationDialog.svelte

@@ -79,7 +79,7 @@
 				'This is a medium-length recording with a bit more content to transcribe and process.',
 				`This is a longer recording transcript. It contains multiple sentences and paragraphs of content. ${Array(10).fill('Lorem ipsum dolor sit amet, consectetur adipiscing elit.').join(' ')}`,
 			];
-			const transcribedText = textLengths[index % textLengths.length];
+			const transcript = textLengths[index % textLengths.length];
 
 			const id = nanoid();
 			const now = new Date().toISOString();
@@ -91,7 +91,7 @@
 				timestamp: timestampStr,
 				createdAt: now,
 				updatedAt: now,
-				transcribedText,
+				transcript,
 				transcriptionStatus,
 				serializedAudio: _generateMockAudio(),
 			};

apps/whispering/src/lib/components/copyable/TranscriptDialog.svelte

@@ -12,7 +12,7 @@
 	 * ```svelte
 	 * <TranscriptDialog
 	 *   recordingId={recording.id}
-	 *   transcribedText={recording.transcribedText}
+	 *   transcript={recording.transcript}
 	 *   rows={1}
 	 * />
 	 * ```
@@ -21,29 +21,29 @@
 		/** The ID of the recording whose transcript is being displayed */
 		recordingId,
 		/** The transcript content to display */
-		transcribedText,
+		transcript,
 		/** Number of rows for the preview textarea (default: 2) */
 		rows = 2,
 		/** Whether the dialog trigger is disabled */
 		disabled = false,
 	}: {
 		recordingId: string;
-		transcribedText: string;
+		transcript: string;
 		rows?: number;
 		disabled?: boolean;
 	} = $props();
 
 	const id = getRecordingTransitionId({
 		recordingId,
-		propertyName: 'transcribedText',
+		propertyName: 'transcript',
 	});
 </script>
 
 <TextPreviewDialog
 	{id}
 	title="Transcript"
 	label="transcript"
-	text={transcribedText}
+	text={transcript}
 	{rows}
 	{disabled}
 />

apps/whispering/src/lib/query/actions.ts

@@ -2,6 +2,7 @@ import { nanoid } from 'nanoid/non-secure';
 import { Err, Ok } from 'wellcrafted/result';
 import { fromTaggedError, WhisperingErr } from '$lib/result';
 import { DbServiceErr } from '$lib/services/db';
+import { CURRENT_RECORDING_VERSION } from '$lib/services/db/models';
 import { settings } from '$lib/stores/settings.svelte';
 import * as transformClipboardWindow from '../../routes/transform-clipboard/transformClipboardWindow.tauri';
 import { rpc } from './';
@@ -623,12 +624,13 @@ async function processRecordingPipeline({
 
 	const recording = {
 		id: newRecordingId,
+		version: CURRENT_RECORDING_VERSION,
 		title: '',
 		subtitle: '',
 		timestamp: now,
 		createdAt: now,
 		updatedAt: now,
-		transcribedText: '',
+		transcript: '',
 		transcriptionStatus: 'UNPROCESSED',
 	} as const;
 
@@ -661,7 +663,7 @@ async function processRecordingPipeline({
 		description: 'Your recording is being transcribed...',
 	});
 
-	const { data: transcribedText, error: transcribeError } =
+	const { data: transcript, error: transcribeError } =
 		await transcription.transcribeRecording.execute(recording);
 
 	if (transcribeError) {
@@ -681,7 +683,7 @@ async function processRecordingPipeline({
 	sound.playSoundIfEnabled.execute('transcriptionComplete');
 
 	await delivery.deliverTranscriptionResult.execute({
-		text: transcribedText,
+		text: transcript,
 		toastId: transcribeToastId,
 	});
 

apps/whispering/src/lib/query/transcription.ts

@@ -52,7 +52,7 @@ export const transcription = {
 					},
 				});
 			}
-			const { data: transcribedText, error: transcribeError } =
+			const { data: transcript, error: transcribeError } =
 				await transcribeBlob(audioBlob);
 			if (transcribeError) {
 				const { error: setRecordingTranscribingError } =
@@ -77,7 +77,7 @@ export const transcription = {
 			const { error: setRecordingTranscribedTextError } =
 				await db.recordings.update.execute({
 					...recording,
-					transcribedText,
+					transcript,
 					transcriptionStatus: 'DONE',
 				});
 			if (setRecordingTranscribedTextError) {
@@ -91,7 +91,7 @@ export const transcription = {
 					},
 				});
 			}
-			return Ok(transcribedText);
+			return Ok(transcript);
 		},
 	}),
 

apps/whispering/src/lib/query/transformer.ts

@@ -112,7 +112,7 @@ export const transformer = {
 
 			const { data: transformationRun, error: transformationRunError } =
 				await runTransformation({
-					input: recording.transcribedText,
+					input: recording.transcript,
 					transformation,
 					recordingId,
 				});

apps/whispering/src/lib/services/db/file-system.ts

@@ -10,52 +10,52 @@ import {
 } from '@tauri-apps/plugin-fs';
 import { type } from 'arktype';
 import matter from 'gray-matter';
-import { Ok, tryAsync } from 'wellcrafted/result';
+import { Err, Ok, tryAsync, type Result } from 'wellcrafted/result';
 import { getExtensionFromMimeType } from '$lib/constants/mime';
 import { PATHS } from '$lib/constants/paths';
 import * as services from '$lib/services';
-import type { Recording } from './models';
-import { Transformation, TransformationRun } from './models';
+import { Recording, Transformation, TransformationRun } from './models';
 import type { DbService } from './types';
 import { DbServiceErr } from './types';
 
-/**
- * Schema validator for Recording front matter (everything except transcribedText)
- */
-const RecordingFrontMatter = type({
-	id: 'string',
-	title: 'string',
-	subtitle: 'string',
-	timestamp: 'string',
-	createdAt: 'string',
-	updatedAt: 'string',
-	transcriptionStatus: '"UNPROCESSED" | "TRANSCRIBING" | "DONE" | "FAILED"',
-});
-
-type RecordingFrontMatter = typeof RecordingFrontMatter.infer;
-
 /**
  * Convert Recording to markdown format (frontmatter + body)
+ *
+ * Storage format:
+ * - Frontmatter: All metadata fields (id, title, subtitle, etc.) but NOT version
+ * - Body: The transcript text
+ *
+ * Version is excluded from frontmatter because desktop files don't need versioning;
+ * they always store transcript in the body (never had transcribedText in frontmatter).
+ * When reading, we use the Recording validator which handles any schema version.
  */
 function recordingToMarkdown(recording: Recording): string {
-	const { transcribedText, ...frontMatter } = recording;
-	return matter.stringify(transcribedText ?? '', frontMatter);
+	const { transcript, version: _version, ...frontMatter } = recording;
+	return matter.stringify(transcript ?? '', frontMatter);
 }
 
 /**
- * Convert markdown file (YAML frontmatter + body) to Recording
+ * Parse markdown file content into a Recording using the migrating validator.
+ *
+ * Desktop files are treated as V6 schema (no version field stored, body = transcript).
+ * The Recording validator defaults version to 6, then migrates V6 → V7 automatically.
  */
-function markdownToRecording({
-	frontMatter,
-	body,
-}: {
-	frontMatter: RecordingFrontMatter;
-	body: string;
-}): Recording {
-	return {
+function parseMarkdownToRecording(
+	content: string,
+): Result<Recording, { summary: string }> {
+	const { data: frontMatter, content: body } = matter(content);
+
+	// Recording validator accepts V6 or V7 input and always outputs V7
+	const result = Recording({
 		...frontMatter,
-		transcribedText: body,
-	};
+		transcribedText: body, // V6 schema: body maps to transcribedText, version defaults to 6
+		transcript: body, // V7 schema: body maps to transcript
+	});
+
+	if (result instanceof type.errors) {
+		return Err({ summary: result.summary });
+	}
+	return Ok(result);
 }
 
 /**
@@ -101,17 +101,14 @@ export function createFileSystemDb(): DbService {
 						// Use Rust command to read all markdown files at once
 						const contents = await readMarkdownFiles(recordingsPath);
 
-						// Parse all files
+						// Parse all files using the Recording validator (handles V6→V7 migration)
 						const recordings = contents.map((content) => {
-							const { data, content: body } = matter(content);
-
-							// Validate the front matter schema
-							const frontMatter = RecordingFrontMatter(data);
-							if (frontMatter instanceof type.errors) {
+							const { data, error } = parseMarkdownToRecording(content);
+							if (error) {
+								console.error('Invalid recording:', error.summary);
 								return null; // Skip invalid recording, don't crash the app
 							}
-
-							return markdownToRecording({ frontMatter, body });
+							return data;
 						});
 
 						// Filter out any null entries and sort by timestamp (newest first)
@@ -180,17 +177,15 @@ export function createFileSystemDb(): DbService {
 						if (!fileExists) return null;
 
 						const content = await readTextFile(mdPath);
-						const { data, content: body } = matter(content);
 
-						// Validate the front matter schema
-						const frontMatter = RecordingFrontMatter(data);
-						if (frontMatter instanceof type.errors) {
-							throw new Error(
-								`Invalid recording front matter: ${frontMatter.summary}`,
-							);
+						// Parse using the Recording validator (handles V6→V7 migration)
+						const { data, error } = parseMarkdownToRecording(content);
+						if (error) {
+							const { summary } = error;
+							throw new Error(`Invalid recording: ${summary}`);
 						}
 
-						return markdownToRecording({ frontMatter, body });
+						return data;
 					},
 					catch: (error) =>
 						DbServiceErr({

apps/whispering/src/lib/services/db/index.ts

@@ -12,6 +12,7 @@ export type {
 	TransformationStepRun,
 } from './models';
 export {
+	CURRENT_RECORDING_VERSION,
 	generateDefaultTransformation,
 	generateDefaultTransformationStep,
 	TRANSFORMATION_STEP_TYPES,

apps/whispering/src/lib/services/db/models/index.ts

@@ -1,12 +1,16 @@
 // Recordings
-export type {
+export {
+	CURRENT_RECORDING_VERSION,
 	Recording,
+} from './recordings';
+export type {
 	RecordingStoredInIndexedDB,
 	RecordingsDbSchemaV1,
 	RecordingsDbSchemaV2,
 	RecordingsDbSchemaV3,
 	RecordingsDbSchemaV4,
 	RecordingsDbSchemaV5,
+	RecordingsDbSchemaV6,
 	SerializedAudio,
 } from './recordings';
 // Transformation Runs
@@ -21,8 +25,7 @@ export {
 	TransformationStepRunRunning,
 } from './transformation-runs';
 export type {
-	TransformationStepV1,
-	TransformationStepV2,
+	TransformationStep,
 	TransformationV1,
 	TransformationV2,
 } from './transformations';
@@ -33,5 +36,4 @@ export {
 	TRANSFORMATION_STEP_TYPES,
 	TRANSFORMATION_STEP_TYPES_TO_LABELS,
 	Transformation,
-	TransformationStep,
 } from './transformations';