Skip to content

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

6.4 KB
Raw Blame
import { describe, expect, it } from 'vitest';
import { buildCodeAnimationBriefPrompt, extractBriefIdea } from './brief.js';
import { CODE_ANIMATION_LIMITS } from './prompt.js';

const FORMAT = { durationSeconds: 20, aspectRatio: '16:9' };

const UNIVERSE = {
  name: 'Example Universe',
  logline: 'A drowned city keeps its lamps lit',
  premise: 'Lamplighters trade memory for oil',
  embrace: ['ink wash', 'muted indigo'],
  avoid: ['photorealism'],
  styleNotes: 'quiet, melancholic, slow camera',
  styleReferences: [{ title: 'Night markets', prompt: 'paper lanterns over water' }],
  characters: [{ name: 'Mira', role: 'lamplighter', physicalDescription: 'tall, oil-stained coat' }],
  places: [{ name: 'The Lower Market', description: 'flooded arcade of stalls' }],
  objects: [{ name: 'The Brass Wick', significance: 'the last lamp that never gutters' }],
};

describe('buildCodeAnimationBriefPrompt', () => {
  it('grounds the brief in the universe bible, its cast, and the artist\'s spark', () => {
    const prompt = buildCodeAnimationBriefPrompt({
      universe: UNIVERSE,
      moodBoard: { name: 'Dusk', description: 'amber evenings', items: [{ caption: 'harbor glow' }] },
      seedIdea: 'a chase that ends in silence',
      format: FORMAT,
      current: { title: 'The Brass Wick', concept: '', onScreenText: '', styleNotes: '' },
    });
    expect(prompt).toContain('20-second 16:9 animated short');
    expect(prompt).toContain('a chase that ends in silence');
    expect(prompt).toContain('The film is set in the universe "Example Universe"');
    expect(prompt).toContain('Logline: A drowned city keeps its lamps lit');
    expect(prompt).toContain('  - Mira [lamplighter]: tall, oil-stained coat');
    expect(prompt).toContain('  - The Lower Market: flooded arcade of stalls');
    expect(prompt).toContain('  - The Brass Wick (the last lamp that never gutters)');
    expect(prompt).toContain('Mood board: "Dusk"');
    expect(prompt).toContain('Title: The Brass Wick');
    expect(prompt).toContain('"cast": "..."');
  });

  it('asks for a director\'s plan: a timed beat sheet and a rig-ready character bible', () => {
    const prompt = buildCodeAnimationBriefPrompt({ seedIdea: 'a robot realizes its world is generated', format: FORMAT });
    expect(prompt).toContain('HOW TO DIRECT IT');
    expect(prompt).toContain('each led by its time range covering the full 20 seconds');
    expect(prompt).toContain('identity lock');
  });

  it('shows the writer the character bible the artist already drafted', () => {
    const prompt = buildCodeAnimationBriefPrompt({
      format: FORMAT,
      current: { title: '', concept: '', cast: 'Wick — a paper lantern with a drooping wire handle', onScreenText: '', styleNotes: '' },
    });
    expect(prompt).toContain('Characters: Wick — a paper lantern with a drooping wire handle');
  });

  it('tells the model to invent a cast when the universe has no canon yet', () => {
    const prompt = buildCodeAnimationBriefPrompt({
      universe: { name: 'Bare World', embrace: [], avoid: [] },
      format: FORMAT,
    });
    expect(prompt).toContain('no canon characters, places, or objects recorded yet');
    expect(prompt).not.toContain('CANON —');
  });

  it('falls back to a blank-slate instruction with nothing to go on', () => {
    const prompt = buildCodeAnimationBriefPrompt({ format: FORMAT });
    expect(prompt).toContain('invent a striking, self-contained concept');
  });

  it('withholds a reveal-gated character\'s concealed canon', () => {
    const prompt = buildCodeAnimationBriefPrompt({
      universe: {
        ...UNIVERSE,
        characters: [{
          name: 'Corin',
          role: 'archivist',
          spoiler: true,
          surfaceDescriptor: 'a quiet clerk',
          background: 'signed the order that drowned the city',
          personality: 'remorseless',
        }],
      },
      format: FORMAT,
    });
    expect(prompt).toContain('a quiet clerk');
    expect(prompt).toContain('reveal-gated');
    expect(prompt).not.toContain('signed the order that drowned the city');
    expect(prompt).not.toContain('remorseless');
  });
});

describe('brief writer film style grammar', () => {
  it('hands the writer the native-move names only, and nothing without a grammar', () => {
    const base = { universe: UNIVERSE, seedIdea: 'a chase', format: FORMAT, current: {} };
    expect(buildCodeAnimationBriefPrompt(base)).not.toContain('MEDIUM');
    const prompt = buildCodeAnimationBriefPrompt({ ...base, styleGrammarId: 'blueprint-draft' });
    expect(prompt).toContain('MEDIUM');
    expect(prompt).toContain('Exploded assembly; Dimension lock; Revision cloud');
    expect(prompt).not.toContain('Pull an object apart along its axes');
  });
});

describe('extractBriefIdea', () => {
  const response = (body) => `Here you go:\n\`\`\`json\n${JSON.stringify(body)}\n\`\`\``;

  it('parses a fenced brief and keeps an intentionally empty field empty', () => {
    expect(extractBriefIdea(response({
      title: 'The Brass Wick',
      concept: 'Mira climbs the flooded arcade…',
      cast: 'Mira — tall, oil-stained coat',
      onScreenText: '',
      styleNotes: 'colder blues at the climax',
    }))).toEqual({
      title: 'The Brass Wick',
      concept: 'Mira climbs the flooded arcade…',
      cast: 'Mira — tall, oil-stained coat',
      onScreenText: '',
      styleNotes: 'colder blues at the climax',
    });
  });

  it('clamps every field to the limit the brief form enforces', () => {
    const parsed = extractBriefIdea(response({
      title: 'T'.repeat(500),
      concept: 'C'.repeat(CODE_ANIMATION_LIMITS.conceptMax + 100),
      cast: 'K'.repeat(CODE_ANIMATION_LIMITS.castMax + 100),
      onScreenText: 'O'.repeat(CODE_ANIMATION_LIMITS.textMax + 100),
      styleNotes: 'S'.repeat(CODE_ANIMATION_LIMITS.styleNotesMax + 100),
    }));
    expect(parsed.title.length).toBe(CODE_ANIMATION_LIMITS.titleMax);
    expect(parsed.concept.length).toBe(CODE_ANIMATION_LIMITS.conceptMax);
    expect(parsed.cast.length).toBe(CODE_ANIMATION_LIMITS.castMax);
    expect(parsed.onScreenText.length).toBe(CODE_ANIMATION_LIMITS.textMax);
    expect(parsed.styleNotes.length).toBe(CODE_ANIMATION_LIMITS.styleNotesMax);
  });

  it('rejects a response with no usable concept', () => {
    expect(() => extractBriefIdea('I could not write that.')).toThrow(/did not return a usable brief/);
    expect(() => extractBriefIdea(response({ concept: '   ' }))).toThrow(/did not return a usable brief/);
  });
});