Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS
JavaScript ai-agentsdashboarddeveloper-toolsdigital-twinquantified-selfsecond-brainself-hostedtailscale
/**
* Import the linked track's lyric sheet onto a Music Video project.
*
* A track in the music library carries the song's lyrics as a plain sheet
* with `[Verse]`/`[Chorus]` headers and stage directions. The project needs
* them as lyric cues (the sung lines) plus lyric markers (the structure), and
* nothing else reads them off the track once the project exists. The
* director's "Use track lyrics" button replaces the lines; the autopilot
* kickoff imports only when the project has no lines, so a re-run never
* overwrites lines the director edited.
*/
import { ServerError } from '../../lib/errorHandler.js';
import { getTrack } from '../tracks/index.js';
import { updateProject } from './projects.js';
import { requireProject } from './requireProject.js';
import { parseLyricCues } from './timedText.js';
export const MAX_LYRIC_CUES = 2000;
/**
* @param {string} projectId
* @param {{ mode?: 'replace' | 'if-empty' }} [options]
* @returns {Promise<{ project: object, imported: number, markers: number, skipped: string|null }>}
*/
export async function importTrackLyrics(projectId, { mode = 'replace' } = {}) {
const project = await requireProject(projectId);
const ifEmpty = mode === 'if-empty';
const skip = (skipped) => ({ project, imported: 0, markers: 0, skipped });
if (ifEmpty && (project.lyricCues || []).length > 0) return skip('has-lyrics');
if (!project.trackId) {
if (ifEmpty) return skip('no-track');
throw new ServerError('Link a track from the music library first', { status: 400, code: 'NO_TRACK' });
}
const track = await getTrack(project.trackId);
if (!track) throw new ServerError('Linked track not found', { status: 404, code: 'NOT_FOUND' });
const { cues, markers } = parseLyricCues(typeof track.lyrics === 'string' ? track.lyrics : '');
if (cues.length === 0) {
if (ifEmpty) return skip('no-track-lyrics');
throw new ServerError('The linked track has no lyrics', { status: 422, code: 'NO_TRACK_LYRICS' });
}
if (cues.length > MAX_LYRIC_CUES) {
throw new ServerError(`A project holds at most ${MAX_LYRIC_CUES} lyric cues`, { status: 400, code: 'VALIDATION_ERROR' });
}
const updated = await updateProject(project.id, { lyricCues: cues, lyricMarkers: markers });
console.log(`🎼 Imported ${cues.length} track lyric lines (${markers.length} markers) into ${project.id}`);
return { project: updated, imported: cues.length, markers: markers.length, skipped: null };
}