eprec 1.6.0 → 1.8.0

package/app/assets/styles.css

@@ -199,6 +199,34 @@ p {
 	gap: var(--spacing-md);
 }
 
+.stacked-list {
+	display: flex;
+	flex-direction: column;
+	gap: 0;
+	margin: 0;
+	padding: 0;
+	list-style: none;
+}
+
+.stacked-item {
+	border-radius: 0;
+}
+
+.stacked-item:first-child {
+	border-top-left-radius: var(--radius-lg);
+	border-top-right-radius: var(--radius-lg);
+}
+
+.stacked-item:last-child {
+	border-bottom-left-radius: var(--radius-lg);
+	border-bottom-right-radius: var(--radius-lg);
+}
+
+.stacked-item.is-selected {
+	background: var(--color-info-surface);
+	box-shadow: inset 0 0 0 1px var(--color-border-accent);
+}
+
 .app-list {
 	margin: 0;
 	padding-left: var(--spacing-lg);
@@ -296,6 +324,93 @@ p {
 	line-height: 1.4;
 }
 
+.actions-card {
+	gap: var(--spacing-xl);
+}
+
+.actions-header {
+	display: flex;
+	flex-wrap: wrap;
+	align-items: flex-start;
+	justify-content: space-between;
+	gap: var(--spacing-lg);
+}
+
+.actions-meta {
+	min-width: 180px;
+}
+
+.actions-buttons {
+	display: flex;
+	flex-wrap: wrap;
+	gap: var(--spacing-sm);
+}
+
+.actions-grid {
+	display: grid;
+	grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
+	gap: var(--spacing-lg);
+}
+
+.actions-panel {
+	border: 1px solid var(--color-border);
+	border-radius: var(--radius-lg);
+	padding: var(--spacing-lg);
+	background: var(--color-surface-muted);
+	display: flex;
+	flex-direction: column;
+	gap: var(--spacing-md);
+}
+
+.actions-button-row {
+	display: flex;
+	flex-wrap: wrap;
+	gap: var(--spacing-sm);
+}
+
+.actions-queue {
+	display: flex;
+	flex-direction: column;
+	gap: var(--spacing-md);
+}
+
+.processing-list .stacked-item {
+	background: var(--color-surface);
+}
+
+.processing-row {
+	border: 1px solid var(--color-border);
+}
+
+.processing-row-header {
+	display: flex;
+	align-items: flex-start;
+	justify-content: space-between;
+	gap: var(--spacing-md);
+	padding: var(--spacing-md) var(--spacing-md) var(--spacing-sm);
+}
+
+.processing-row-header h4 {
+	margin: 0 0 var(--spacing-xs);
+	font-size: var(--font-size-base);
+}
+
+.processing-row-meta {
+	display: flex;
+	align-items: center;
+	justify-content: space-between;
+	gap: var(--spacing-md);
+	padding: 0 var(--spacing-md) var(--spacing-md);
+}
+
+.processing-row.is-running {
+	box-shadow: inset 0 0 0 1px var(--color-warning-border);
+}
+
+.processing-row.is-complete {
+	background: var(--color-success-surface);
+}
+
 .timeline-card {
 	gap: var(--spacing-xl);
 }
@@ -540,7 +655,7 @@ p {
 	margin: 0;
 	display: flex;
 	flex-direction: column;
-	gap: var(--spacing-sm);
+	gap: 0;
 }
 
 .cut-row {
@@ -549,14 +664,14 @@ p {
 	gap: var(--spacing-md);
 	justify-content: space-between;
 	border: 1px solid var(--color-border);
-	border-radius: var(--radius-lg);
+	border-radius: 0;
 	padding: var(--spacing-sm) var(--spacing-md);
 	background: var(--color-surface-muted);
 }
 
 .cut-row.is-selected {
-	border-color: var(--color-border-accent);
 	background: var(--color-info-surface);
+	box-shadow: inset 0 0 0 1px var(--color-border-accent);
 }
 
 .cut-select {
@@ -591,13 +706,13 @@ p {
 .command-list {
 	display: flex;
 	flex-direction: column;
-	gap: var(--spacing-md);
+	gap: 0;
 }
 
 .chapter-row,
 .command-row {
 	border: 1px solid var(--color-border);
-	border-radius: var(--radius-lg);
+	border-radius: 0;
 	padding: var(--spacing-md);
 	background: var(--color-surface-muted);
 	display: flex;
@@ -673,16 +788,22 @@ p {
 	list-style: none;
 	margin: 0;
 	padding: 0;
-	display: grid;
-	gap: var(--spacing-sm);
+	display: flex;
+	flex-direction: column;
+	gap: 0;
+}
+
+.transcript-results .stacked-item {
+	border: 1px solid var(--color-border);
+	background: var(--color-surface);
 }
 
 .transcript-result {
 	width: 100%;
-	border: 1px solid var(--color-border);
-	border-radius: var(--radius-md);
 	padding: var(--spacing-sm) var(--spacing-md);
-	background: var(--color-surface);
+	border: none;
+	border-radius: 0;
+	background: transparent;
 	display: grid;
 	grid-template-columns: auto 1fr;
 	gap: var(--spacing-md);
@@ -713,6 +834,10 @@ p {
 	overflow-x: auto;
 }
 
+.stacked-list .stacked-item + .stacked-item {
+	border-top: none;
+}
+
 @keyframes shimmer {
 	0% {
 		background-position: 0% 50%;

package/app/client/editing-workspace.tsx

@@ -1,3 +1,4 @@
+import { matchSorter } from 'match-sorter'
 import type { Handle } from 'remix/component'
 import {
 	sampleEditSession,
@@ -12,15 +13,34 @@ const MIN_CUT_LENGTH = 0.2
 const DEFAULT_CUT_LENGTH = 2.4
 const PLAYHEAD_STEP = 0.1
 
+type ProcessingStatus = 'queued' | 'running' | 'done'
+type ProcessingCategory = 'chapter' | 'transcript' | 'export'
+type ProcessingTask = {
+	id: string
+	title: string
+	detail: string
+	status: ProcessingStatus
+	category: ProcessingCategory
+}
+
 export function EditingWorkspace(handle: Handle) {
 	const duration = sampleEditSession.duration
 	const transcript = sampleEditSession.transcript
 	const commands = sampleEditSession.commands
+	const transcriptIndex = transcript.map((word) => ({
+		...word,
+		context: buildContext(transcript, word.index, 3),
+	}))
 	let cutRanges = sampleEditSession.cuts.map((range) => ({ ...range }))
 	let chapters = sampleEditSession.chapters.map((chapter) => ({ ...chapter }))
 	let playhead = 18.2
 	let selectedRangeId = cutRanges[0]?.id ?? null
 	let searchQuery = ''
+	let primaryChapterId = chapters[0]?.id ?? ''
+	let secondaryChapterId = chapters[1]?.id ?? chapters[0]?.id ?? ''
+	let processingQueue: ProcessingTask[] = []
+	let activeTaskId: string | null = null
+	let processingCount = 1
 	let manualCutId = 1
 	let previewDuration = 0
 	let previewReady = false
@@ -144,6 +164,128 @@ export function EditingWorkspace(handle: Handle) {
 		handle.update()
 	}
 
+	const findChapter = (chapterId: string) =>
+		chapters.find((chapter) => chapter.id === chapterId) ?? null
+
+	const updatePrimaryChapter = (chapterId: string) => {
+		primaryChapterId = chapterId
+		if (secondaryChapterId === chapterId) {
+			secondaryChapterId =
+				chapters.find((chapter) => chapter.id !== chapterId)?.id ??
+				chapterId
+		}
+		handle.update()
+	}
+
+	const updateSecondaryChapter = (chapterId: string) => {
+		secondaryChapterId = chapterId
+		handle.update()
+	}
+
+	const queueTask = (
+		title: string,
+		detail: string,
+		category: ProcessingCategory,
+	) => {
+		const task: ProcessingTask = {
+			id: `task-${processingCount++}`,
+			title,
+			detail,
+			status: 'queued',
+			category,
+		}
+		processingQueue = [...processingQueue, task]
+		handle.update()
+	}
+
+	const queueChapterEdit = () => {
+		const chapter = findChapter(primaryChapterId)
+		if (!chapter) return
+		queueTask(
+			`Edit ${chapter.title}`,
+			`Review trims for ${formatTimestamp(chapter.start)} - ${formatTimestamp(
+				chapter.end,
+			)}.`,
+			'chapter',
+		)
+	}
+
+	const queueCombineChapters = () => {
+		const primary = findChapter(primaryChapterId)
+		const secondary = findChapter(secondaryChapterId)
+		if (!primary || !secondary || primary.id === secondary.id) return
+		queueTask(
+			`Combine ${primary.title} + ${secondary.title}`,
+			'Merge both chapters into a single preview export.',
+			'chapter',
+		)
+	}
+
+	const queueTranscriptRegeneration = () => {
+		queueTask(
+			'Regenerate transcript',
+			'Run Whisper alignment and refresh search cues.',
+			'transcript',
+		)
+	}
+
+	const queueCommandScan = () => {
+		queueTask(
+			'Detect command windows',
+			'Scan for Jarvis commands and update cut ranges.',
+			'transcript',
+		)
+	}
+
+	const queuePreviewRender = () => {
+		queueTask(
+			'Render preview clip',
+			'Bake a short MP4 with current edits applied.',
+			'export',
+		)
+	}
+
+	const queueFinalExport = () => {
+		queueTask(
+			'Export edited chapters',
+			'Render final chapters and write the export package.',
+			'export',
+		)
+	}
+
+	const startNextTask = () => {
+		if (activeTaskId) return
+		const next = processingQueue.find((task) => task.status === 'queued')
+		if (!next) return
+		activeTaskId = next.id
+		processingQueue = processingQueue.map((task) =>
+			task.id === next.id ? { ...task, status: 'running' } : task,
+		)
+		handle.update()
+	}
+
+	const markActiveDone = () => {
+		if (!activeTaskId) return
+		processingQueue = processingQueue.map((task) =>
+			task.id === activeTaskId ? { ...task, status: 'done' } : task,
+		)
+		activeTaskId = null
+		handle.update()
+	}
+
+	const clearCompletedTasks = () => {
+		processingQueue = processingQueue.filter((task) => task.status !== 'done')
+		handle.update()
+	}
+
+	const removeTask = (taskId: string) => {
+		processingQueue = processingQueue.filter((task) => task.id !== taskId)
+		if (activeTaskId === taskId) {
+			activeTaskId = null
+		}
+		handle.update()
+	}
+
 	const syncVideoToPlayhead = (value: number) => {
 		if (
 			!previewNode ||
@@ -179,12 +321,24 @@ export function EditingWorkspace(handle: Handle) {
 		const currentContext = currentWord
 			? buildContext(transcript, currentWord.index, 4)
 			: 'No transcript cues found for the playhead.'
-		const query = searchQuery.trim().toLowerCase()
+		const query = searchQuery.trim()
 		const searchResults = query
-			? transcript
-					.filter((word) => word.word.toLowerCase().includes(query))
-					.slice(0, 12)
+			? matchSorter(transcriptIndex, query, {
+					keys: ['word'],
+				}).slice(0, 12)
 			: []
+		const queuedCount = processingQueue.filter(
+			(task) => task.status === 'queued',
+		).length
+		const completedCount = processingQueue.filter(
+			(task) => task.status === 'done',
+		).length
+		const runningTask =
+			processingQueue.find((task) => task.status === 'running') ?? null
+		const canCombineChapters =
+			primaryChapterId.length > 0 &&
+			secondaryChapterId.length > 0 &&
+			primaryChapterId !== secondaryChapterId
 		const commandPreview = buildCommandPreview(
 			sampleEditSession.sourceName,
 			chapters,
@@ -246,6 +400,227 @@ export function EditingWorkspace(handle: Handle) {
 					</div>
 				</section>
 
+				<section class="app-card app-card--full actions-card">
+					<div class="actions-header">
+						<div>
+							<h2>Processing actions</h2>
+							<p class="app-muted">
+								Queue chapter edits, transcript cleanup, and export jobs directly
+								from the workspace.
+							</p>
+						</div>
+						<div class="actions-meta">
+							<div class="summary-item">
+								<span class="summary-label">Queue</span>
+								<span class="summary-value">{queuedCount} queued</span>
+								<span class="summary-subtext">
+									{runningTask ? `Running: ${runningTask.title}` : 'Idle'}
+								</span>
+							</div>
+						</div>
+						<div class="actions-buttons">
+							<button
+								class="button button--primary"
+								type="button"
+								disabled={queuedCount === 0 || Boolean(runningTask)}
+								on={{ click: startNextTask }}
+							>
+								Run next
+							</button>
+							<button
+								class="button button--ghost"
+								type="button"
+								disabled={!runningTask}
+								on={{ click: markActiveDone }}
+							>
+								Mark running done
+							</button>
+							<button
+								class="button button--ghost"
+								type="button"
+								disabled={completedCount === 0}
+								on={{ click: clearCompletedTasks }}
+							>
+								Clear completed
+							</button>
+						</div>
+					</div>
+
+					<div class="actions-grid">
+						<article class="actions-panel">
+							<div class="panel-header">
+								<h3>Chapter processing</h3>
+								<span class="status-pill status-pill--info">Chapter</span>
+							</div>
+							<label class="input-label">
+								Primary chapter
+								<select
+									class="text-input"
+									value={primaryChapterId}
+									on={{
+										change: (event) => {
+											const target = event.currentTarget as HTMLSelectElement
+											updatePrimaryChapter(target.value)
+										},
+									}}
+								>
+									{chapters.map((chapter) => (
+										<option value={chapter.id}>{chapter.title}</option>
+									))}
+								</select>
+							</label>
+							<label class="input-label">
+								Secondary chapter
+								<select
+									class="text-input"
+									value={secondaryChapterId}
+									on={{
+										change: (event) => {
+											const target = event.currentTarget as HTMLSelectElement
+											updateSecondaryChapter(target.value)
+										},
+									}}
+								>
+									{chapters.map((chapter) => (
+										<option value={chapter.id}>{chapter.title}</option>
+									))}
+								</select>
+							</label>
+							<div class="actions-button-row">
+								<button
+									class="button button--primary"
+									type="button"
+									disabled={!primaryChapterId}
+									on={{ click: queueChapterEdit }}
+								>
+									Edit chapter
+								</button>
+								<button
+									class="button button--ghost"
+									type="button"
+									disabled={!canCombineChapters}
+									on={{ click: queueCombineChapters }}
+								>
+									Combine chapters
+								</button>
+							</div>
+							<p class="app-muted">
+								Stage edits or merge two chapters without leaving this view.
+							</p>
+						</article>
+
+						<article class="actions-panel">
+							<div class="panel-header">
+								<h3>Transcript utilities</h3>
+								<span class="status-pill status-pill--warning">Transcript</span>
+							</div>
+							<div class="actions-button-row">
+								<button
+									class="button button--ghost"
+									type="button"
+									on={{ click: queueTranscriptRegeneration }}
+								>
+									Regenerate transcript
+								</button>
+								<button
+									class="button button--ghost"
+									type="button"
+									on={{ click: queueCommandScan }}
+								>
+									Detect command windows
+								</button>
+							</div>
+							<p class="app-muted">
+								Refresh the transcript or scan for command markers on demand.
+							</p>
+						</article>
+
+						<article class="actions-panel">
+							<div class="panel-header">
+								<h3>Exports</h3>
+								<span class="status-pill status-pill--success">Export</span>
+							</div>
+							<div class="actions-button-row">
+								<button
+									class="button button--ghost"
+									type="button"
+									on={{ click: queuePreviewRender }}
+								>
+									Render preview clip
+								</button>
+								<button
+									class="button button--ghost"
+									type="button"
+									on={{ click: queueFinalExport }}
+								>
+									Export edited chapters
+								</button>
+							</div>
+							<p class="app-muted">
+								Trigger preview renders or finalize exports for the pipeline.
+							</p>
+						</article>
+					</div>
+
+					<div class="actions-queue">
+						<div class="panel-header">
+							<h3>Processing queue</h3>
+							<span class="summary-subtext">
+								{processingQueue.length} total
+							</span>
+						</div>
+						{processingQueue.length === 0 ? (
+							<p class="app-muted">
+								No actions queued yet. Use the buttons above to stage work.
+							</p>
+						) : (
+							<ul class="stacked-list processing-list">
+								{processingQueue.map((task) => (
+									<li
+										class={classNames(
+											'stacked-item',
+											'processing-row',
+											task.status === 'running' && 'is-running',
+											task.status === 'done' && 'is-complete',
+										)}
+									>
+										<div class="processing-row-header">
+											<div>
+												<h4>{task.title}</h4>
+												<p class="app-muted">{task.detail}</p>
+											</div>
+											<span
+												class={classNames(
+													'status-pill',
+													task.status === 'queued' && 'status-pill--info',
+													task.status === 'running' && 'status-pill--warning',
+													task.status === 'done' && 'status-pill--success',
+												)}
+											>
+												{task.status}
+											</span>
+										</div>
+										<div class="processing-row-meta">
+											<span class="summary-subtext">
+												{formatProcessingCategory(task.category)}
+											</span>
+											{task.status === 'queued' ? (
+												<button
+													class="button button--ghost"
+													type="button"
+													on={{ click: () => removeTask(task.id) }}
+												>
+													Remove
+												</button>
+											) : null}
+										</div>
+									</li>
+								))}
+							</ul>
+						)}
+					</div>
+				</section>
+
 				<section class="app-card app-card--full timeline-card">
 					<div class="timeline-header">
 						<div>
@@ -523,10 +898,11 @@ export function EditingWorkspace(handle: Handle) {
 							)}
 
 							<h3>Cut list</h3>
-							<ul class="cut-list">
+							<ul class="cut-list stacked-list">
 								{sortedCuts.map((range) => (
 									<li
 										class={classNames(
+											'stacked-item',
 											'cut-row',
 											range.id === selectedRangeId && 'is-selected',
 										)}
@@ -562,9 +938,9 @@ export function EditingWorkspace(handle: Handle) {
 						<p class="app-muted">
 							Update output names and mark chapters to skip before export.
 						</p>
-						<div class="chapter-list">
+						<div class="chapter-list stacked-list">
 							{chapters.map((chapter) => (
-								<article class="chapter-row">
+								<article class="chapter-row stacked-item">
 									<div class="chapter-header">
 										<div>
 											<h3>{chapter.title}</h3>
@@ -630,11 +1006,11 @@ export function EditingWorkspace(handle: Handle) {
 						<p class="app-muted">
 							Apply Jarvis commands to your cut list or chapter metadata.
 						</p>
-						<div class="command-list">
+						<div class="command-list stacked-list">
 							{commands.map((command) => {
 								const applied = isCommandApplied(command, sortedCuts, chapters)
 								return (
-									<article class="command-row">
+									<article class="command-row stacked-item">
 										<div class="command-header">
 											<h3>{command.label}</h3>
 											<span
@@ -705,10 +1081,14 @@ export function EditingWorkspace(handle: Handle) {
 						<p class="app-muted transcript-empty">
 							Type to search the transcript words. Click a result to jump to it.
 						</p>
+					) : searchResults.length === 0 ? (
+						<p class="app-muted transcript-empty">
+							No results found for "{query}".
+						</p>
 					) : (
-						<ul class="transcript-results">
+						<ul class="transcript-results stacked-list">
 							{searchResults.map((word) => (
-								<li>
+								<li class="stacked-item">
 									<button
 										class="transcript-result"
 										type="button"
@@ -717,9 +1097,7 @@ export function EditingWorkspace(handle: Handle) {
 										<span class="transcript-time">
 											{formatTimestamp(word.start)}
 										</span>
-										<span class="transcript-snippet">
-											{buildContext(transcript, word.index, 3)}
-										</span>
+										<span class="transcript-snippet">{word.context}</span>
 									</button>
 								</li>
 							))}
@@ -786,6 +1164,12 @@ function formatSeconds(value: number) {
 	return `${value.toFixed(1)}s`
 }
 
+function formatProcessingCategory(category: ProcessingCategory) {
+	if (category === 'chapter') return 'Chapter task'
+	if (category === 'transcript') return 'Transcript task'
+	return 'Export task'
+}
+
 function classNames(...values: Array<string | false | null | undefined>) {
 	return values.filter(Boolean).join(' ')
 }

package/app/config/import-map.ts

@@ -6,4 +6,5 @@ export const baseImportMap = {
 	'remix/component/jsx-runtime': '/node_modules/remix/component/jsx-runtime',
 	'remix/component/jsx-dev-runtime':
 		'/node_modules/remix/component/jsx-dev-runtime',
+	'match-sorter': '/node_modules/match-sorter',
 } as const

package/app/routes/index.tsx

@@ -17,6 +17,18 @@ const indexHandler = {
 							exports.
 						</p>
 					</header>
+					<section class="app-card app-card--full">
+						<h2>Processing actions</h2>
+						<p class="app-muted">
+							Queue chapter edits, transcript cleanup, and export jobs once the
+							client loads.
+						</p>
+						<ul class="app-list">
+							<li>Edit a chapter with the latest cut list.</li>
+							<li>Combine two chapters into a merged preview.</li>
+							<li>Regenerate the transcript or detect command windows.</li>
+						</ul>
+					</section>
 					<section class="app-card app-card--full">
 						<h2>Timeline editor</h2>
 						<p class="app-muted">

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "eprec",
   "type": "module",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "license": "MIT",
   "repository": {
     "type": "git",

package/process-course/chapter-processor.ts

@@ -54,6 +54,14 @@ import type {
 } from './types'
 import { createEditWorkspace } from './edits'
 
+export type ChapterProgressReporter = {
+	start: (options: { stepCount: number; label?: string }) => void
+	step: (label: string) => void
+	setLabel: (label: string) => void
+	finish: (label?: string) => void
+	skip: (label: string) => void
+}
+
 export interface ChapterProcessingOptions {
 	inputPath: string
 	outputDir: string
@@ -67,6 +75,7 @@ export interface ChapterProcessingOptions {
 	writeLogs: boolean
 	dryRun: boolean
 	previousProcessedChapter?: ProcessedChapterInfo | null
+	progress?: ChapterProgressReporter
 }
 
 export interface ChapterProcessingResult {
@@ -100,11 +109,16 @@ export async function processChapter(
 		)
 	}
 
+	const progress = options.progress
+	const stepCount = options.dryRun ? 1 : options.enableTranscription ? 8 : 7
+
 	const outputBasePath = path.join(
 		options.outputDir,
 		`${formatChapterFilename(chapter)}${path.extname(options.inputPath)}`,
 	)
 
+	progress?.start({ stepCount, label: 'Starting' })
+
 	// Check minimum duration before processing
 	if (duration < options.minChapterDurationSeconds) {
 		logInfo(
@@ -121,6 +135,7 @@ export async function processChapter(
 			])
 			logWritten = true
 		}
+		progress?.skip('Skipped (short)')
 		return { status: 'skipped', skipReason: 'short-initial', logWritten }
 	}
 
@@ -129,6 +144,7 @@ export async function processChapter(
 		logInfo(
 			`[dry-run] Would process chapter ${chapter.index + 1}: ${chapter.title}`,
 		)
+		progress?.finish('Dry run')
 		return { status: 'processed', skipReason: 'dry-run', logWritten: false }
 	}
 
@@ -139,6 +155,7 @@ export async function processChapter(
 
 	try {
 		// Step 1: Extract raw segment with padding trimmed
+		progress?.step('Extracting segment')
 		const rawTrimStart = chapter.start + CONFIG.rawTrimPaddingSeconds
 		const rawTrimEnd = chapter.end - CONFIG.rawTrimPaddingSeconds
 		const rawDuration = rawTrimEnd - rawTrimStart
@@ -156,6 +173,7 @@ export async function processChapter(
 		})
 
 		// Step 2: Normalize audio
+		progress?.step('Normalizing audio')
 		const analysis = await analyzeLoudness(paths.rawPath, 0, rawDuration)
 		await renderChapter({
 			inputPath: paths.rawPath,
@@ -170,8 +188,10 @@ export async function processChapter(
 		let commandFilenameOverride: string | null = null
 		let hasEditCommand = false
 		let commandNotes: Array<{ value: string; window: TimeRange }> = []
+		let usedSpliceStep = false
 
 		if (options.enableTranscription) {
+			progress?.step('Transcribing audio')
 			const transcriptionResult = await transcribeAndAnalyze({
 				normalizedPath: paths.normalizedPath,
 				transcriptionAudioPath: paths.transcriptionAudioPath,
@@ -192,6 +212,7 @@ export async function processChapter(
 					logWritten = true
 				}
 				await safeUnlink(outputBasePath)
+				progress?.skip('Skipped (transcript)')
 				return {
 					status: 'skipped',
 					skipReason: transcriptionResult.hasBadTake
@@ -213,6 +234,8 @@ export async function processChapter(
 						`Combine previous command detected for chapter ${chapter.index + 1}, but no previous chapter available. Processing normally.`,
 					)
 				} else {
+					progress?.step('Combining previous')
+					usedSpliceStep = true
 					const combineResult = await handleCombinePrevious({
 						chapter,
 						previousProcessedChapter: options.previousProcessedChapter,
@@ -227,8 +250,10 @@ export async function processChapter(
 					})
 					// If combine failed (returned null), continue with normal processing
 					if (combineResult !== null) {
+						progress?.finish('Combined')
 						return combineResult
 					}
+					progress?.setLabel('Splicing commands')
 					// Otherwise, fall through to normal processing
 				}
 			}
@@ -242,6 +267,9 @@ export async function processChapter(
 		)
 
 		// Step 5: Handle command splicing
+		if (!usedSpliceStep) {
+			progress?.step('Splicing commands')
+		}
 		const spliceResult = await handleCommandSplicing({
 			commandWindows,
 			normalizedPath: paths.normalizedPath,
@@ -252,6 +280,7 @@ export async function processChapter(
 		})
 
 		// Step 6: Detect speech bounds
+		progress?.step('Detecting speech')
 		const speechBounds = await detectSpeechBounds(
 			spliceResult.sourcePath,
 			0,
@@ -275,6 +304,7 @@ export async function processChapter(
 		}
 
 		// Step 7: Apply speech padding
+		progress?.step('Trimming')
 		const paddedStart = clamp(
 			speechBounds.start - CONFIG.preSpeechPaddingSeconds,
 			0,
@@ -314,10 +344,12 @@ export async function processChapter(
 				logWritten = true
 			}
 			await safeUnlink(outputBasePath)
+			progress?.skip('Skipped (trimmed)')
 			return { status: 'skipped', skipReason: 'short-trimmed', logWritten }
 		}
 
 		// Step 9: Write final output
+		progress?.step('Writing output')
 		await extractChapterSegment({
 			inputPath: spliceResult.sourcePath,
 			outputPath: finalOutputPath,
@@ -326,6 +358,7 @@ export async function processChapter(
 		})
 
 		// Step 10: Verify no jarvis in final output
+		progress?.step('Verifying output')
 		let jarvisWarning: JarvisWarning | undefined
 		await extractTranscriptionAudio({
 			inputPath: finalOutputPath,
@@ -412,6 +445,7 @@ export async function processChapter(
 			processedDuration: trimmedDuration,
 		}
 
+		progress?.finish('Complete')
 		return {
 			status: 'processed',
 			jarvisWarning,

package/process-course/edits/cli.ts

@@ -361,7 +361,8 @@ async function promptForEditsCommand(
 		{
 			name: 'edit-video - Edit a single video using transcript text edits',
 			value: 'edit-video',
-			description: 'edit-video --input <file> --transcript <json> --edited <txt>',
+			description:
+				'edit-video --input <file> --transcript <json> --edited <txt>',
 			keywords: ['transcript', 'cuts', 'remove', 'trim'],
 		},
 		{

package/src/process-course-video.ts

@@ -10,6 +10,7 @@ import { writeJarvisLogs, writeSummaryLogs } from '../process-course/summary'
 import {
 	processChapter,
 	type ChapterProcessingOptions,
+	type ChapterProgressReporter,
 } from '../process-course/chapter-processor'
 import type {
 	JarvisEdit,
@@ -20,6 +21,7 @@ import type {
 } from '../process-course/types'
 import { formatSeconds } from './utils'
 import { checkSegmentHasSpeech } from './speech-detection'
+import { setActiveSpinnerText } from '../cli-ux'
 
 interface ProcessingSummary {
 	totalSelected: number
@@ -35,6 +37,137 @@ interface ProcessingSummary {
 
 export type ProcessCourseOptions = Omit<CliArgs, 'shouldExit'>
 
+const PROGRESS_BAR_WIDTH = 12
+
+type SpinnerProgressContext = {
+	fileIndex: number
+	fileCount: number
+	fileName: string
+	chapterCount: number
+}
+
+type ChapterProgressContext = {
+	chapterIndex: number
+	chapterTitle: string
+}
+
+function clampProgress(value: number) {
+	return Math.max(0, Math.min(1, value))
+}
+
+function formatPercent(value: number) {
+	return `${Math.round(clampProgress(value) * 100)}%`
+}
+
+function formatProgressBar(value: number, width = PROGRESS_BAR_WIDTH) {
+	const clamped = clampProgress(value)
+	const filled = Math.round(clamped * width)
+	return `[${'#'.repeat(filled)}${'-'.repeat(width - filled)}]`
+}
+
+function truncateLabel(value: string, maxLength: number) {
+	const trimmed = value.trim()
+	if (trimmed.length <= maxLength) {
+		return trimmed
+	}
+	return `${trimmed.slice(0, Math.max(0, maxLength - 3))}...`
+}
+
+function buildProgressText(params: {
+	fileIndex: number
+	fileCount: number
+	fileName: string
+	chapterIndex: number
+	chapterCount: number
+	chapterTitle: string
+	stepIndex: number
+	stepCount: number
+	stepLabel: string
+}) {
+	const chapterProgress =
+		params.stepCount > 0 ? params.stepIndex / params.stepCount : 0
+	const fileProgress =
+		params.chapterCount > 0
+			? (params.chapterIndex - 1 + chapterProgress) / params.chapterCount
+			: 1
+	const fileLabel =
+		params.fileCount > 1
+			? `File ${params.fileIndex}/${params.fileCount}`
+			: 'File'
+	const fileName = truncateLabel(params.fileName, 22)
+	const fileSegment = fileName ? `${fileLabel} ${fileName}` : fileLabel
+	const chapterLabel = `Chapter ${params.chapterIndex}/${params.chapterCount}`
+	const chapterTitle = truncateLabel(params.chapterTitle, 26)
+	const chapterSegment = chapterTitle
+		? `${chapterLabel} ${chapterTitle}`
+		: chapterLabel
+	const stepSegment = truncateLabel(params.stepLabel, 28) || 'Working'
+	return `Processing course | ${fileSegment} ${formatPercent(fileProgress)} ${formatProgressBar(fileProgress)} | ${chapterSegment} ${formatPercent(chapterProgress)} ${formatProgressBar(chapterProgress)} | ${stepSegment}`
+}
+
+function createSpinnerProgressReporter(context: SpinnerProgressContext) {
+	const chapterCount = Math.max(1, context.chapterCount)
+	return {
+		createChapterProgress({ chapterIndex, chapterTitle }: ChapterProgressContext) {
+			let stepIndex = 0
+			let stepCount = 1
+			let stepLabel = 'Starting'
+
+			const normalizeStepCount = (value: number) =>
+				Math.max(1, Math.round(value))
+
+			const update = () => {
+				setActiveSpinnerText(
+					buildProgressText({
+						fileIndex: context.fileIndex,
+						fileCount: context.fileCount,
+						fileName: context.fileName,
+						chapterIndex,
+						chapterCount,
+						chapterTitle,
+						stepIndex,
+						stepCount,
+						stepLabel,
+					}),
+				)
+			}
+
+			const progress: ChapterProgressReporter = {
+				start({ stepCount: initialCount, label }) {
+					stepCount = normalizeStepCount(initialCount)
+					stepIndex = 0
+					stepLabel = label ?? 'Starting'
+					update()
+				},
+				step(label) {
+					stepCount = normalizeStepCount(stepCount)
+					stepIndex = Math.min(stepIndex + 1, stepCount)
+					stepLabel = label
+					update()
+				},
+				setLabel(label) {
+					stepLabel = label
+					update()
+				},
+				finish(label) {
+					stepCount = normalizeStepCount(stepCount)
+					stepIndex = stepCount
+					stepLabel = label ?? 'Complete'
+					update()
+				},
+				skip(label) {
+					stepCount = normalizeStepCount(stepCount)
+					stepIndex = stepCount
+					stepLabel = label
+					update()
+				},
+			}
+
+			return progress
+		},
+	}
+}
+
 export async function runProcessCourse(options: ProcessCourseOptions) {
 	const {
 		inputPaths,
@@ -53,7 +186,7 @@ export async function runProcessCourse(options: ProcessCourseOptions) {
 	await ensureFfmpegAvailable()
 
 	// Process each input file in turn
-	for (const inputPath of inputPaths) {
+	for (const [fileIndex, inputPath] of inputPaths.entries()) {
 		// Determine output directory for this file
 		let fileOutputDir: string
 		if (outputDir) {
@@ -72,6 +205,8 @@ export async function runProcessCourse(options: ProcessCourseOptions) {
 		}
 
 		await processInputFile({
+			fileIndex: fileIndex + 1,
+			fileCount: inputPaths.length,
 			inputPath,
 			outputDir: fileOutputDir,
 			minChapterDurationSeconds,
@@ -97,6 +232,8 @@ export async function runProcessCourseCli(rawArgs?: string[]) {
 }
 
 async function processInputFile(options: {
+	fileIndex: number
+	fileCount: number
 	inputPath: string
 	outputDir: string
 	minChapterDurationSeconds: number
@@ -110,6 +247,8 @@ async function processInputFile(options: {
 	whisperBinaryPath: string | undefined
 }) {
 	const {
+		fileIndex,
+		fileCount,
 		inputPath,
 		outputDir,
 		minChapterDurationSeconds,
@@ -168,6 +307,13 @@ async function processInputFile(options: {
 		? chapters.filter((chapter) => chapterIndexes.includes(chapter.index))
 		: chapters
 
+	const progressReporter = createSpinnerProgressReporter({
+		fileIndex,
+		fileCount,
+		fileName: path.basename(inputPath),
+		chapterCount: selectedChapters.length,
+	})
+
 	const summary: ProcessingSummary = {
 		totalSelected: selectedChapters.length,
 		processed: 0,
@@ -203,7 +349,11 @@ async function processInputFile(options: {
 	const processedChaptersWithSpeech: ProcessedChapterInfo[] = []
 	let previousProcessedChapter: ProcessedChapterInfo | null = null
 
-	for (const chapter of selectedChapters) {
+	for (const [chapterOffset, chapter] of selectedChapters.entries()) {
+		const chapterProgress = progressReporter.createChapterProgress({
+			chapterIndex: chapterOffset + 1,
+			chapterTitle: chapter.title,
+		})
 		// Determine which chapter to combine with
 		// Always use the most recent processed chapter with speech (if any)
 		const chapterToCombineWith: ProcessedChapterInfo | null =
@@ -222,6 +372,7 @@ async function processInputFile(options: {
 		const result = await processChapter(chapter, {
 			...processingOptions,
 			previousProcessedChapter: chapterToCombineWith,
+			progress: chapterProgress,
 		})
 
 		// Update summary based on result