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
/**
* Music Video — get a newly attached song ready without a click.
*
* Creating a project with a track (an imported Suno song, the default case),
* attaching or changing its track, and importing its lyrics are the director's
* own actions; what follows from them is mechanical. This runs the offline
* beat/tempo/section analysis when the song has none, then starts word
* alignment (forced alignment against the isolated vocal, separating it first
* when there is no stem yet) when the lyric lines have never been aligned or
* were aligned only against the full mix.
*
* Analysis is a local DSP pass of a few seconds and resolves inline; alignment
* is a job, so its id comes back for the page to follow. Nothing here calls an
* AI provider. A song whose lines already carry vocal-aligned word times, an instrumental,
* and a project an autonomous run is driving are left alone.
*/
import { isNonBlankStr } from '../../lib/textUtils.js';
import { requireProject } from './requireProject.js';
import { analyzeProjectSong } from './projectAudio.js';
import { startLyricAlign } from './lyricAlignJob.js';
const hasAudio = (project) => Boolean(project?.trackId || project?.uploadedAudioFilename);
const autonomousRunActive = (project) => {
const run = project?.autonomousRun;
return Boolean(run) && !['completed', 'canceled', 'failed'].includes(run.status);
};
/**
* Whether the project's lyric lines are waiting for word alignment on the
* isolated vocal: never aligned, or aligned only against the full mix (whose
* word times stretch over intros and dense verses).
*/
function needsAutoAlignment(project) {
if (project?.productionReview?.draft?.lyricsMode === 'instrumental') return false;
const cues = (project?.lyricCues || []).filter((cue) => isNonBlankStr(cue?.text));
if (cues.length === 0) return false;
const aligned = cues.some((cue) => Array.isArray(cue.words) && cue.words.length > 0);
return !aligned || project.lyricAlignSource !== 'vocal-stem';
}
/**
* Analyze and align what is missing. Resolves `{ project, analyzed, alignJobId }`:
* the current project, whether analysis ran, and the alignment job to follow
* (null when none was needed).
*/
export async function autoPrepareSong(projectId, { analyze = analyzeProjectSong, align = startLyricAlign } = {}) {
let project = await requireProject(projectId);
if (!hasAudio(project) || autonomousRunActive(project)) return { project, analyzed: false, alignJobId: null };
let analyzed = false;
if (!project.audioAnalysis) {
project = await analyze(project.id);
analyzed = true;
}
let alignJobId = null;
if (needsAutoAlignment(project)) {
({ jobId: alignJobId } = await align(project.id, { separateVocals: true }));
console.log(`🎤 Started automatic lyric alignment for ${project.id}`);
}
return { project, analyzed, alignJobId };
}