Gerador de vídeos narrativos (Godot + FFmpeg), painel Next.js, serviço de voz, Clipador de lives e Publicador para YouTube, TikTok e Instagram. Inclui a leitura das visualizações dos posts para o Dashboard e o botão "Publicar no <rede>" nos cartões das publicações. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
166 lines
14 KiB
TypeScript
166 lines
14 KiB
TypeScript
// Montagem do prompt enviado ao agente. O contexto (história, episódio, caminhos, escolha
|
||
// anterior) vem do banco; o texto do usuário entra como "Pedido". Comentários do público
|
||
// não entram.
|
||
import { childEpisodes, getEpisodeById } from "./stories";
|
||
import { BASE_SCENE, episodeChoicesPath, episodeConfigPath, episodeScriptPath, rel } from "./paths";
|
||
import type { AgentKind, EpisodeView, Provider, Story, StoryKind } from "./types";
|
||
|
||
/**
|
||
* Regras de roteiro: ficam em doc/roteiro/ (fonte única). O Codex lê os guias direto; o Claude
|
||
* delega ao subagente `cenaforge-story-writer`, que lê os mesmos guias. Assim os dois têm o
|
||
* mesmo contexto, e mudar uma regra é editar um .md, não este arquivo.
|
||
*/
|
||
const GUIDE_COMMON = "doc/roteiro/comum.md";
|
||
const GUIDE_BY_KIND: Record<StoryKind, string> = {
|
||
interactive: "doc/roteiro/ficcao.md",
|
||
linear: "doc/roteiro/ficcao.md",
|
||
documentary: "doc/roteiro/documental.md",
|
||
};
|
||
const FORMAT_LABEL: Record<StoryKind, string> = { interactive: "interativa", linear: "linear", documentary: "documental" };
|
||
|
||
/** Scripts sem LLM que substituem trabalho que o agente fazia lendo arquivos e imagens. */
|
||
const CHECK_FRAMES = "python .claude/skills/cenaforge/scripts/frame_check.py";
|
||
const CHECK_SCRIPT = "python .claude/skills/cenaforge/scripts/check_script.py";
|
||
|
||
/** Fecho das tarefas de texto: o script confere duração, narração por trecho e os JSON. */
|
||
function scriptCheck(storyId: string): string {
|
||
return `Antes de terminar, rode \`${CHECK_SCRIPT} stories/${storyId}\` e corrija os avisos (duração alvo, narração por trecho, meta.json, choices.json). Não reconte palavras à mão.`;
|
||
}
|
||
|
||
/** Pesquisa web do documental: as páginas abertas inteiras eram o que mais pesava no roteiro. */
|
||
const RESEARCH_ECONOMY = "Na pesquisa, busque o termo dentro da página em vez de abri-la inteira e pare em 3–5 fontes confiáveis que cubram os fatos do roteiro.";
|
||
|
||
function writingRules(provider: Provider, kind: StoryKind): string {
|
||
const guides = `\`${GUIDE_COMMON}\` e \`${GUIDE_BY_KIND[kind]}\``;
|
||
const core = kind === "documentary"
|
||
? "Formato DOCUMENTAL: vídeo único sobre fatos reais. Cidades, lugares e instituições reais pelo nome, cada fato com fonte; sem votação. As restrições de ficção não valem."
|
||
: `Formato ${FORMAT_LABEL[kind].toUpperCase()} (ficção): sem cidades, marcas nem pessoas reais.`;
|
||
return provider === "claude"
|
||
? `${core}\nPara o texto, use o subagente \`cenaforge-story-writer\` e diga a ele o formato (${FORMAT_LABEL[kind]}). Ele segue ${guides}.`
|
||
: `${core}\nLeia ${guides} e siga-os: são as regras e os formatos de arquivo. Escreva você mesmo; ` +
|
||
"não use `.claude/agents/` (subagentes do Claude, que leem esses mesmos guias).";
|
||
}
|
||
|
||
export function buildPrompt(input: { kind: AgentKind; provider: Provider; request: string; story?: Story; episode?: EpisodeView }): string {
|
||
const { kind, provider, request, story, episode } = input;
|
||
const documentary = story?.kind === "documentary";
|
||
// Economia de tokens: cada tarefa recebe só a lista curta do que ler. A skill inteira (SKILL.md +
|
||
// references, ~1.500 linhas) só entra nas tarefas que mexem no pipeline de render (cena, livre).
|
||
const reading: Record<AgentKind, string> = {
|
||
story: "Leia SÓ: `doc/roteiro/comum.md` e o guia do formato (`doc/roteiro/ficcao.md` ou `doc/roteiro/documental.md`). Não carregue a skill `cenaforge` nem `.claude/skills/`.",
|
||
script: "Leia SÓ: `doc/roteiro/comum.md`, o guia do formato e a pasta da história. Não carregue a skill `cenaforge` nem `.claude/skills/`.",
|
||
branches: "Leia SÓ: `doc/roteiro/comum.md`, `doc/roteiro/ficcao.md` e a pasta da história; para a cena, use o script `new_scene.py` indicado abaixo. Não carregue a skill inteira.",
|
||
godot: "Leia SÓ: `doc/godot/cenas.md` e `doc/godot/api.md` (assinaturas das peças e cenas; NÃO leia os .gd inteiros de outras cenas). Não carregue a skill `cenaforge`.",
|
||
scene: "Siga a skill `cenaforge` (.claude/skills/cenaforge/SKILL.md): leia só as seções que a tarefa pedir.",
|
||
free: "Siga o CLAUDE.md; consulte a skill `cenaforge` (.claude/skills/cenaforge/SKILL.md) só no que a tarefa pedir.",
|
||
};
|
||
const lines: (string | null)[] = [
|
||
"Você está trabalhando no repositório CenaForge (vídeos narrativos: cena descrita por JSON → Godot → MP4).",
|
||
"Responda em português do Brasil.",
|
||
reading[kind],
|
||
"Trabalhe só dentro do repositório. Seja econômico: Grep antes de ler, leia por intervalo de linhas, filtre saídas longas (`| Select-Object -Last 20` / `| tail -n 20`). " +
|
||
"Não acione os subagentes `cenaforge-skill-updater` nem `cenaforge-token-auditor` (100–150 mil tokens cada): isso é feito fora do painel. " +
|
||
"Ao terminar, liste os arquivos criados ou alterados e o que ficou pendente.",
|
||
provider === "codex"
|
||
? "Você é o Codex. Arquivos em `.claude/agents/` são subagentes do Claude: você não os aciona; quando o CLAUDE.md mandar delegar a um deles, faça o trabalho você mesmo. " +
|
||
"No PowerShell, leia texto com `Get-Content -Raw -Encoding UTF8` (sem isso os acentos saem quebrados) e rode o pnpm como `pnpm.cmd` " +
|
||
"(o `pnpm.ps1` é bloqueado pela política de execução): `pnpm.cmd render -- --config <json> --profile preview`."
|
||
: null,
|
||
];
|
||
if (story) {
|
||
const format = story.kind === "interactive"
|
||
? `interativa: cada episódio termina numa escolha do público entre ${story.branch_count} vertentes`
|
||
: documentary ? "documental: vídeo único sobre fatos reais, sem votação" : "linear";
|
||
lines.push("", "## Contexto",
|
||
`História: ${story.title} (id \`${story.id}\`, ${format}).`,
|
||
story.logline ? `Premissa: ${story.logline}` : "Premissa: ainda não definida.",
|
||
`Pasta da história: \`stories/${story.id}/\` (bíblia, episódios e assets exclusivos em \`stories/${story.id}/assets/\`). Biblioteca compartilhada: \`assets/library/\`.`);
|
||
}
|
||
if (story && episode) {
|
||
lines.push(`Episódio ${episode.number} (\`${episode.file_key}\`)${episode.title ? ` — ${episode.title}` : ""}.`,
|
||
`Roteiro: \`${episode.scriptPath}\` (${episode.hasScript ? "existe" : "ainda não existe"}).`,
|
||
`Cena: \`${episode.configPath}\` (${episode.hasConfig ? "existe" : "ainda não existe"}).`);
|
||
if (episode.parent_episode_id && episode.parent_choice) {
|
||
const parent = getEpisodeById(episode.parent_episode_id);
|
||
const label = episode.branch_label || parent?.choices.find((c) => c.letter === episode.parent_choice)?.label || null;
|
||
lines.push(`Escolha do público no episódio anterior: ${episode.parent_choice}${label ? ` ("${label}")` : ""}. O episódio precisa seguir essa consequência.`);
|
||
}
|
||
}
|
||
if (kind === "story" && story && documentary) {
|
||
const ep = episode ? episode.scriptPath : `stories/${story.id}/ep01.md`;
|
||
lines.push("", "## Tarefa: montar o vídeo documental a partir do texto do usuário",
|
||
"O texto em \"Pedido\" é o tema escolhido pelo criador. Pesquise na web, confira os fatos e escreva o vídeo.",
|
||
RESEARCH_ECONOMY,
|
||
writingRules(provider, story.kind),
|
||
`1. Escreva a ficha de pauta em \`stories/${story.id}/biblia.md\`.`,
|
||
`2. Escreva o roteiro do vídeo em \`${ep}\`.`,
|
||
`3. Grave \`stories/${story.id}/meta.json\` exatamente assim: {"title": "<título final, até 60 caracteres>", "logline": "<o vídeo em 1–2 frases>"}.`,
|
||
scriptCheck(story.id),
|
||
"Não crie cena JSON, não renderize e não altere código. Ao terminar, resuma o vídeo, liste as fontes usadas e as necessidades de produção.");
|
||
} else if (kind === "story" && story) {
|
||
const ep = episode ? episode.scriptPath : `stories/${story.id}/ep01.md`;
|
||
lines.push("", "## Tarefa: montar a história a partir do texto do usuário",
|
||
"O texto em \"Pedido\" é o material de partida do criador (ideia, sinopse ou rascunho). Transforme-o numa história do formato CenaForge:",
|
||
"episódios verticais curtos (~12 s), um de cada vez, " + (story.kind === "interactive" ? "cada um terminando numa escolha A/B do público." : "sem escolha do público."),
|
||
writingRules(provider, story.kind),
|
||
`1. Escreva a bíblia em \`stories/${story.id}/biblia.md\`.`,
|
||
`2. Escreva o primeiro episódio em \`${ep}\`.`,
|
||
`3. Grave \`stories/${story.id}/meta.json\` exatamente assim: {"title": "<título final, até 60 caracteres>", "logline": "<premissa em 1–2 frases>"}.`,
|
||
scriptCheck(story.id),
|
||
"Não crie cena JSON, não renderize e não altere código. Ao terminar, resuma a história e liste as necessidades de produção.");
|
||
} else if (kind === "script") {
|
||
lines.push("", "## Tarefa: roteiro",
|
||
story ? writingRules(provider, story.kind) : null,
|
||
story ? `Crie a ${documentary ? "ficha de pauta" : "bíblia"} \`stories/${story.id}/biblia.md\` se não existir.` : "Peça a história antes de escrever.",
|
||
episode ? `Escreva \`${episode.scriptPath}\`.` : null,
|
||
story && documentary ? RESEARCH_ECONOMY : null,
|
||
story ? scriptCheck(story.id) : null,
|
||
"Não crie cena JSON nem renderize nesta tarefa.");
|
||
} else if (kind === "godot") {
|
||
lines.push("", "## Tarefa: construir uma cena no Godot (biblioteca de cenas)",
|
||
"O pedido descreve uma cena (lugar, objeto, personagem, animação). Construa-a no Godot e guarde na biblioteca, para este e para os próximos vídeos.",
|
||
"Siga `doc/godot/cenas.md` (contrato, manifesto, teste e checklist). As peças e cenas prontas estão resumidas em `doc/godot/api.md`: use as funções de lá sem abrir os .gd inteiros.",
|
||
"1. Liste `godot/library/` e leia só os manifest.json: reaproveite cenas e peças (`godot/kits/`) em vez de refazer.",
|
||
"2. Crie ou estenda `godot/library/<id>/template.gd` e `manifest.json` (id em minúsculas com hífens). Peças reaproveitáveis em .gd separados na mesma pasta.",
|
||
`3. Teste com \`${CHECK_FRAMES} --config data/tmp/<id>-teste.json\`: ele renderiza o preview e devolve ~10 linhas (status, tempo, luz, contraste, movimento e enquadramento de cada quadro). ` +
|
||
"Corrija até passar no checklist do guia, inclusive variant 0, 1 e 2 e cada opção dos parâmetros. " +
|
||
"IMAGENS: no máximo UMA por render, a que o script indicar (folha de 480 px ou o quadro marcado). Não abra quadros soltos em resolução cheia, não abra imagens em lote " +
|
||
"e não gere imagens próprias de QA: cada imagem fica no histórico e é reenviada a todo turno. Não entregue sem olhar ao menos uma folha.",
|
||
"4. Não altere `godot/scripts/`, `scripts/` nem `panel/`: a cena aparece sozinha no painel (formulário e escolha automática pelas palavras-chave).",
|
||
story ? `Contexto: a cena é para o vídeo "${story.title}". Leia \`stories/${story.id}/\` (roteiro: coluna Imagem de cada trecho) para acertar o que a cena precisa mostrar.` : null,
|
||
"Ao terminar: rode `python .claude/skills/cenaforge/scripts/godot_api.py` (atualiza o resumo doc/godot/api.md), apague os JSON de teste de data/tmp/ e informe o id da cena, o que cada parâmetro faz e o tempo de render.");
|
||
} else if (kind === "scene") {
|
||
lines.push("", "## Tarefa: cena",
|
||
episode
|
||
? `Crie \`${episode.configPath}\` a partir do roteiro \`${episode.scriptPath}\`, usando ` +
|
||
`\`python .claude/skills/cenaforge/scripts/new_scene.py --id ${story!.id}-${episode.file_key} --base ${BASE_SCENE}\` ` +
|
||
"com --set para overlay (title, choiceA, choiceB) e o que o roteiro pedir dentro do contrato. Use seed diferente por episódio."
|
||
: "Escolha um episódio antes de montar a cena.",
|
||
"Valide (o script já valida). Não renderize: o render é disparado pelo painel. Se o roteiro pedir algo que o contrato não suporta, liste em 'pendências'.");
|
||
}
|
||
if (kind === "branches" && story && episode) {
|
||
const children = childEpisodes(episode.id);
|
||
const letters = children.map((c) => c.parent_choice).join(", ");
|
||
lines.push("", `## Tarefa: preparar as ${children.length} vertentes do episódio \`${episode.file_key}\` (só o próximo nível)`,
|
||
`O episódio \`${episode.scriptPath}\` termina numa decisão do público com ${children.length} opções (${letters}).`,
|
||
"Leia a bíblia da história e o roteiro deste episódio (e dos anteriores no caminho, se precisar de contexto).",
|
||
writingRules(provider, story.kind),
|
||
`1. Escreva as opções da decisão em \`${rel(episodeChoicesPath(story.id, episode.file_key))}\`, exatamente assim: ` +
|
||
`{${children.map((c) => `"${c.parent_choice}": "<texto curto da opção, até 60 caracteres>"`).join(", ")}}. ` +
|
||
"As opções precisam ser realmente diferentes entre si e levar a consequências distintas.",
|
||
"2. Para cada vertente, escreva o roteiro do episódio seguinte como consequência daquela escolha:",
|
||
...children.map((c) => ` - ${c.parent_choice}: \`${rel(episodeScriptPath(story.id, c.file_key))}\``),
|
||
" Cada roteiro termina na sua própria decisão para o público (o próximo nível será preparado depois).",
|
||
"3. Para cada vertente, crie a cena com " +
|
||
`\`python .claude/skills/cenaforge/scripts/new_scene.py --id ${story.id}-<file_key> --base ${BASE_SCENE}\` ` +
|
||
"(seed diferente em cada uma), gerando:",
|
||
...children.map((c) => ` - ${c.parent_choice}: \`${rel(episodeConfigPath(story.id, c.file_key))}\``),
|
||
`4. No overlay da cena deste episódio (\`${episode.configPath}\`), ajuste choiceA/choiceB para as opções A e B ` +
|
||
(children.length > 2 ? "(o render ainda só desenha duas opções na tela; C e D ficam no choices.json e no painel)." : "."),
|
||
scriptCheck(story.id),
|
||
"Não renderize, não gere áudio e não altere código. Ao terminar, liste as opções e os arquivos criados.");
|
||
}
|
||
lines.push("", "## Pedido", request);
|
||
return lines.filter((l): l is string => l !== null).join("\n");
|
||
}
|