CenaForge: primeira versão pública
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>
This commit is contained in:
@@ -0,0 +1,165 @@
|
||||
// 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");
|
||||
}
|
||||
Reference in New Issue
Block a user