From 84f30bbc2df9cf0926168013cd6dcaa06f373d10 Mon Sep 17 00:00:00 2001 From: Mateuus <1+mateuus@noreply.git.origininteractivestudios.com> Date: Tue, 17 Nov 2026 16:35:09 -0300 Subject: [PATCH] =?UTF-8?q?CenaForge:=20primeira=20vers=C3=A3o=20p=C3=BAbl?= =?UTF-8?q?ica?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 " nos cartões das publicações. Co-Authored-By: Claude Opus 5.5 --- .../agents/cenaforge-dashboard-designer.md | 68 + .claude/agents/cenaforge-skill-updater.md | 82 + .claude/agents/cenaforge-story-writer.md | 25 + .claude/agents/cenaforge-token-auditor.md | 68 + .claude/skills/cenaforge/CHANGELOG.md | 670 +++++++ .claude/skills/cenaforge/SKILL.md | 228 +++ .../skills/cenaforge/references/clipper.md | 510 +++++ .../skills/cenaforge/references/gotchas.md | 701 +++++++ .claude/skills/cenaforge/references/panel.md | 516 +++++ .../skills/cenaforge/references/publishing.md | 212 ++ .../cenaforge/references/token-economy.md | 82 + .claude/skills/cenaforge/references/tools.md | 190 ++ .claude/skills/cenaforge/scripts/_common.py | 50 + .../skills/cenaforge/scripts/check_script.py | 174 ++ .../skills/cenaforge/scripts/check_skill.py | 53 + .../skills/cenaforge/scripts/clean_runs.py | 52 + .../skills/cenaforge/scripts/frame_check.py | 178 ++ .claude/skills/cenaforge/scripts/godot_api.py | 100 + .../skills/cenaforge/scripts/inspect_strip.py | 72 + .claude/skills/cenaforge/scripts/new_scene.py | 86 + .../skills/cenaforge/scripts/runs_summary.py | 64 + .claude/skills/content-pipeline/SKILL.md | 68 + .../content-pipeline/references/01-pauta.md | 38 + .../content-pipeline/references/02-roteiro.md | 46 + .../references/03-narracao.md | 36 + .../content-pipeline/references/04-cenas.md | 29 + .../references/05-montagem.md | 39 + .../content-pipeline/references/06-shorts.md | 34 + .../references/07-thumbnail.md | 38 + .../content-pipeline/references/08-agenda.md | 48 + .../content-pipeline/references/platforms.md | 112 ++ .../content-pipeline/templates/ficha.md | 29 + .../content-pipeline/templates/pauta.md | 28 + .gitignore | 47 + .../docs/init/PROMPT_TESTE_VIDEO_GODOT.md | 397 ++++ AGENTS.md | 25 + CLAUDE.md | 28 + README.md | 260 +++ assets/fonts/Anton-Regular.OFL.txt | 93 + assets/fonts/Anton-Regular.ttf | Bin 0 -> 170812 bytes assets/fonts/Bangers-Regular.OFL.txt | 93 + assets/fonts/Bangers-Regular.ttf | Bin 0 -> 93148 bytes assets/fonts/BebasNeue-Regular.OFL.txt | 93 + assets/fonts/BebasNeue-Regular.ttf | Bin 0 -> 61400 bytes assets/fonts/LuckiestGuy-Regular.LICENSE.txt | 202 ++ assets/fonts/LuckiestGuy-Regular.ttf | Bin 0 -> 73320 bytes assets/fonts/Poppins-ExtraBold.OFL.txt | 93 + assets/fonts/Poppins-ExtraBold.ttf | Bin 0 -> 154836 bytes assets/fonts/fonts.lock.json | 51 + assets/library/.gitkeep | 0 clipper/.env.example | 29 + clipper/README.md | 552 ++++++ clipper/app/__init__.py | 0 clipper/app/capture.py | 150 ++ clipper/app/chat.py | 165 ++ clipper/app/clip_delete.py | 268 +++ clipper/app/config.py | 130 ++ clipper/app/db.py | 270 +++ clipper/app/editor.py | 728 +++++++ clipper/app/editor_api.py | 465 +++++ clipper/app/editor_render.py | 721 +++++++ clipper/app/emotes.py | 158 ++ clipper/app/face.py | 761 ++++++++ clipper/app/hashtags.py | 77 + clipper/app/intel.py | 507 +++++ clipper/app/judge.py | 640 +++++++ clipper/app/layout.py | 415 ++++ clipper/app/main.py | 681 +++++++ clipper/app/media.py | 188 ++ clipper/app/reaction.py | 514 +++++ clipper/app/reframe.py | 283 +++ clipper/app/scoring.py | 399 ++++ clipper/app/sources.py | 78 + clipper/app/subtitles.py | 146 ++ clipper/app/worker.py | 1094 +++++++++++ clipper/models.lock.json | 46 + clipper/pytest.ini | 3 + clipper/requirements-dev.txt | 2 + clipper/requirements.txt | 17 + clipper/tests/__init__.py | 0 clipper/tests/test_capture_quality.py | 264 +++ clipper/tests/test_clip_delete.py | 291 +++ clipper/tests/test_duration_banner_fonts.py | 281 +++ clipper/tests/test_editor.py | 313 +++ clipper/tests/test_editor_layers.py | 109 ++ clipper/tests/test_face.py | 469 +++++ clipper/tests/test_format_and_captions.py | 318 +++ clipper/tests/test_hashtags.py | 54 + clipper/tests/test_intel.py | 225 +++ clipper/tests/test_reaction.py | 353 ++++ clipper/tests/test_reframe_insets.py | 252 +++ clipper/tests/test_render_and_duplicates.py | 190 ++ clipper/tests/test_resume.py | 166 ++ clipper/tests/test_scoring.py | 196 ++ clipper/tests/test_sources_and_api.py | 255 +++ clipper/tools/face_bench.py | 562 ++++++ config/demo-street-variant.json | 51 + config/demo-street.json | 48 + doc/FACE_BAKEOFF.md | 371 ++++ doc/PLANO_RASTREIO_REACAO.md | 137 ++ doc/PROMPT_TESTE_VIDEO_GODOT.md | 397 ++++ doc/TEST_RESULT.md | 235 +++ doc/clip-editor-research.md | 67 + doc/godot/api.md | 129 ++ doc/godot/cenas.md | 160 ++ doc/publicacao/PESQUISA.md | 71 + doc/publicacao/PLANO.md | 246 +++ doc/roteiro/comum.md | 68 + doc/roteiro/documental.md | 72 + doc/roteiro/ficcao.md | 47 + godot/assets/backgrounds/facade_00.png | Bin 0 -> 32375 bytes godot/assets/backgrounds/facade_00.png.import | 40 + godot/assets/backgrounds/facade_01.png | Bin 0 -> 50718 bytes godot/assets/backgrounds/facade_01.png.import | 40 + godot/assets/backgrounds/facade_02.png | Bin 0 -> 33258 bytes godot/assets/backgrounds/facade_02.png.import | 40 + godot/assets/backgrounds/facade_03.png | Bin 0 -> 35920 bytes godot/assets/backgrounds/facade_03.png.import | 40 + godot/assets/backgrounds/facade_04.png | Bin 0 -> 33122 bytes godot/assets/backgrounds/facade_04.png.import | 40 + godot/assets/backgrounds/facade_05.png | Bin 0 -> 32997 bytes godot/assets/backgrounds/facade_05.png.import | 40 + godot/assets/backgrounds/facade_06.png | Bin 0 -> 32448 bytes godot/assets/backgrounds/facade_06.png.import | 40 + godot/assets/backgrounds/facade_07.png | Bin 0 -> 36239 bytes godot/assets/backgrounds/facade_07.png.import | 40 + godot/assets/models/.gitkeep | 0 godot/kits/boat.gd | 164 ++ godot/kits/person.gd | 254 +++ godot/library/castaways/actor.gd | 12 + godot/library/castaways/cast.gd | 28 + godot/library/castaways/manifest.json | 153 ++ godot/library/castaways/shore.gd | 38 + godot/library/castaways/sky.gd | 81 + godot/library/castaways/template.gd | 661 +++++++ godot/library/castaways/verify.gd | 64 + godot/library/island/manifest.json | 112 ++ godot/library/island/template.gd | 617 ++++++ godot/project.godot | 37 + godot/scenes/doc.tscn | 6 + godot/scenes/main.tscn | 6 + godot/scripts/builders/facade_painter.gd | 112 ++ godot/scripts/builders/facade_painter.gd.uid | 1 + godot/scripts/builders/rider_builder.gd | 207 ++ godot/scripts/builders/rider_builder.gd.uid | 1 + godot/scripts/builders/street_builder.gd | 447 +++++ godot/scripts/builders/street_builder.gd.uid | 1 + godot/scripts/core/main.gd | 296 +++ godot/scripts/core/main.gd.uid | 1 + godot/scripts/core/scene_config.gd | 334 ++++ godot/scripts/core/scene_config.gd.uid | 1 + godot/scripts/core/timeline_controller.gd | 126 ++ godot/scripts/core/timeline_controller.gd.uid | 1 + godot/scripts/doc/doc2d_canvas.gd | 500 +++++ godot/scripts/doc/doc_config.gd | 84 + godot/scripts/doc/doc_main.gd | 196 ++ godot/scripts/view/camera_controller.gd | 38 + godot/scripts/view/camera_controller.gd.uid | 1 + godot/scripts/view/overlay_controller.gd | 144 ++ godot/scripts/view/overlay_controller.gd.uid | 1 + godot/tests/fixtures/audio-without-file.json | 68 + godot/tests/fixtures/impossible-times.json | 68 + godot/tests/fixtures/invalid-json.json | 1 + godot/tests/fixtures/unknown-field.json | 69 + godot/tests/fixtures/unknown-version.json | 68 + godot/tests/run_tests.gd | 152 ++ godot/tests/run_tests.gd.uid | 1 + godot/tools/generate_backgrounds.gd | 23 + godot/tools/generate_backgrounds.gd.uid | 1 + output/.gitkeep | 0 package.json | 33 + panel/.gitignore | 41 + panel/.tmp-test/seed.mts | 6 + panel/AGENTS.md | 9 + panel/README.md | 87 + panel/next.config.ts | 15 + panel/package.json | 27 + panel/src/app/accounts/page.tsx | 90 + panel/src/app/actions.ts | 142 ++ panel/src/app/agent/page.tsx | 56 + .../[id]/channels/[channelId]/route.ts | 12 + .../app/api/accounts/[id]/channels/route.ts | 12 + .../[id]/networks/[platform]/check/route.ts | 14 + .../[id]/networks/[platform]/connect/route.ts | 15 + .../networks/[platform]/creator-info/route.ts | 16 + .../[id]/networks/[platform]/reopen/route.ts | 14 + .../[id]/networks/[platform]/route.ts | 24 + .../[id]/networks/[platform]/token/route.ts | 15 + .../app/api/accounts/[id]/networks/route.ts | 12 + panel/src/app/api/accounts/[id]/route.ts | 27 + .../accounts/[id]/stories/[storyId]/route.ts | 12 + .../app/api/accounts/[id]/stories/route.ts | 12 + panel/src/app/api/accounts/route.ts | 18 + .../app/api/agent/runs/[id]/cancel/route.ts | 11 + .../app/api/agent/runs/[id]/events/route.ts | 46 + .../app/api/agent/runs/[id]/messages/route.ts | 16 + panel/src/app/api/agent/runs/route.ts | 16 + .../src/app/api/assets/[id]/promote/route.ts | 10 + panel/src/app/api/assets/route.ts | 25 + panel/src/app/api/clipper/[...path]/route.ts | 17 + panel/src/app/api/dashboard/metrics/route.ts | 23 + panel/src/app/api/dashboard/route.ts | 9 + panel/src/app/api/dashboard/simulate/route.ts | 20 + .../app/api/episodes/[id]/approve/route.ts | 33 + .../app/api/episodes/[id]/branches/route.ts | 13 + .../episodes/[id]/montage/regenerate/route.ts | 14 + .../api/episodes/[id]/montage/render/route.ts | 22 + .../app/api/episodes/[id]/montage/route.ts | 29 + .../api/episodes/[id]/montage/scene/route.ts | 13 + .../api/episodes/[id]/montage/upload/route.ts | 19 + .../src/app/api/episodes/[id]/render/route.ts | 13 + panel/src/app/api/files/route.ts | 39 + panel/src/app/api/publisher/status/route.ts | 11 + .../app/api/publishing/clips/[id]/route.ts | 19 + .../publishing/jobs/[id]/[action]/route.ts | 33 + .../src/app/api/publishing/jobs/[id]/route.ts | 24 + panel/src/app/api/publishing/jobs/route.ts | 18 + panel/src/app/api/publishing/summary/route.ts | 13 + panel/src/app/api/renders/[id]/route.ts | 22 + .../app/api/settings/apps/[platform]/route.ts | 43 + panel/src/app/api/settings/apps/route.ts | 13 + panel/src/app/api/settings/route.ts | 22 + .../app/api/stories/[storyId]/flow/route.ts | 10 + panel/src/app/api/stories/route.ts | 30 + panel/src/app/api/voice/azure/route.ts | 12 + panel/src/app/api/voice/clone/route.ts | 11 + panel/src/app/api/voice/settings/route.ts | 12 + panel/src/app/api/voice/status/route.ts | 8 + panel/src/app/api/voice/synthesize/route.ts | 11 + panel/src/app/api/voice/transcribe/route.ts | 14 + panel/src/app/api/voice/voices/[id]/route.ts | 12 + panel/src/app/api/voice/voices/route.ts | 11 + panel/src/app/assets/page.tsx | 41 + panel/src/app/clipper/edit/[clipId]/page.tsx | 15 + panel/src/app/clipper/page.tsx | 39 + panel/src/app/dashboard/page.tsx | 181 ++ panel/src/app/globals.css | 383 ++++ panel/src/app/icon.svg | 12 + panel/src/app/layout.tsx | 35 + panel/src/app/not-found.tsx | 16 + panel/src/app/page.tsx | 109 ++ panel/src/app/publishing/page.tsx | 25 + panel/src/app/settings/page.tsx | 15 + .../[storyId]/episodes/[number]/page.tsx | 292 +++ .../episodes/[number]/roteiro/page.tsx | 52 + panel/src/app/stories/[storyId]/page.tsx | 175 ++ panel/src/app/voices/page.tsx | 23 + panel/src/components/account-manager.tsx | 335 ++++ panel/src/components/account-networks.tsx | 318 +++ panel/src/components/agent-console.tsx | 402 ++++ panel/src/components/api-client.ts | 21 + panel/src/components/asset-table.tsx | 41 + panel/src/components/asset-upload.tsx | 84 + panel/src/components/clip-editor-fonts.tsx | 185 ++ .../src/components/clip-editor-inspector.tsx | 1102 +++++++++++ .../src/components/clip-editor-keyframes.tsx | 290 +++ panel/src/components/clip-editor-layers.tsx | 178 ++ panel/src/components/clip-editor-model.ts | 786 ++++++++ panel/src/components/clip-editor-preview.tsx | 690 +++++++ panel/src/components/clip-editor-source.tsx | 273 +++ panel/src/components/clip-editor-timeline.tsx | 802 ++++++++ .../src/components/clip-editor-transcript.tsx | 220 +++ panel/src/components/clip-editor-ui.tsx | 309 +++ panel/src/components/clip-editor.tsx | 1019 ++++++++++ panel/src/components/clip-publish.tsx | 203 ++ panel/src/components/clipper-channels.tsx | 182 ++ panel/src/components/clipper-client.ts | 524 +++++ panel/src/components/clipper-cut-settings.tsx | 1076 +++++++++++ panel/src/components/clipper-games.tsx | 734 +++++++ panel/src/components/clipper-judge.tsx | 146 ++ panel/src/components/clipper-queue.tsx | 889 +++++++++ panel/src/components/clipper-sessions.tsx | 818 ++++++++ panel/src/components/clipper-studio.tsx | 333 ++++ panel/src/components/confirm-dialog.tsx | 148 ++ panel/src/components/connect-wizard.tsx | 425 +++++ panel/src/components/copy-button.tsx | 25 + panel/src/components/dashboard-controls.tsx | 161 ++ panel/src/components/delete-story-button.tsx | 41 + panel/src/components/dialog.tsx | 95 + panel/src/components/episode-approve.tsx | 214 +++ panel/src/components/forms.tsx | 221 +++ panel/src/components/icons.tsx | 205 ++ panel/src/components/logo.tsx | 43 + panel/src/components/metrics-view.tsx | 228 +++ panel/src/components/montage-editor.tsx | 665 +++++++ panel/src/components/platforms.tsx | 10 + panel/src/components/publishing-board.tsx | 605 ++++++ panel/src/components/publishing-client.ts | 178 ++ panel/src/components/publishing-ui.tsx | 141 ++ panel/src/components/rect-geometry.ts | 54 + panel/src/components/render-controls.tsx | 55 + panel/src/components/script-reader.tsx | 346 ++++ panel/src/components/settings-panel.tsx | 545 ++++++ panel/src/components/sidebar-nav.tsx | 141 ++ panel/src/components/story-composer.tsx | 144 ++ panel/src/components/story-flow.tsx | 562 ++++++ panel/src/components/story-formats.ts | 37 + panel/src/components/tabs.tsx | 185 ++ panel/src/components/ui.tsx | 502 +++++ panel/src/components/voice-add-form.tsx | 165 ++ panel/src/components/voice-cards.tsx | 318 +++ panel/src/components/voice-client.ts | 157 ++ panel/src/components/voice-clone-form.tsx | 108 ++ panel/src/components/voice-studio.tsx | 537 ++++++ panel/src/components/voice-transcribe.tsx | 178 ++ panel/src/instrumentation.ts | 9 + panel/src/lib/accounts.ts | 345 ++++ panel/src/lib/agents.ts | 539 ++++++ panel/src/lib/assets.ts | 101 + panel/src/lib/branches.ts | 102 + panel/src/lib/clipper.ts | 93 + panel/src/lib/db.ts | 474 +++++ panel/src/lib/decisions.ts | 167 ++ panel/src/lib/dispatcher.ts | 94 + panel/src/lib/flow.ts | 93 + panel/src/lib/http.ts | 45 + panel/src/lib/image-search.ts | 68 + panel/src/lib/metrics-sync.ts | 129 ++ panel/src/lib/metrics.ts | 208 ++ panel/src/lib/montage-ffmpeg.ts | 230 +++ panel/src/lib/montage-godot.ts | 214 +++ panel/src/lib/montage.ts | 584 ++++++ panel/src/lib/paths.ts | 69 + panel/src/lib/proc.ts | 46 + panel/src/lib/prompts.ts | 165 ++ panel/src/lib/proxy.test.ts | 28 + panel/src/lib/publisher.ts | 209 ++ panel/src/lib/publishing-db.test.ts | 421 ++++ panel/src/lib/publishing-rules.test.ts | 256 +++ panel/src/lib/publishing-rules.ts | 423 ++++ panel/src/lib/publishing.ts | 1074 +++++++++++ panel/src/lib/renders.ts | 90 + panel/src/lib/scene-library.ts | 71 + panel/src/lib/script-doc.ts | 176 ++ panel/src/lib/settings.ts | 79 + panel/src/lib/speech-text.ts | 89 + panel/src/lib/stories.ts | 253 +++ panel/src/lib/types.ts | 354 ++++ panel/src/lib/voice.ts | 487 +++++ panel/src/proxy.ts | 54 + panel/tsconfig.json | 34 + pnpm-lock.yaml | 1699 +++++++++++++++++ pnpm-workspace.yaml | 13 + publisher/.env.example | 13 + publisher/.gitignore | 3 + publisher/README.md | 115 ++ publisher/app/__init__.py | 0 publisher/app/acl.py | 44 + publisher/app/config.py | 95 + publisher/app/db.py | 128 ++ publisher/app/main.py | 249 +++ publisher/app/paths.py | 48 + publisher/app/platforms/__init__.py | 0 publisher/app/platforms/base.py | 125 ++ publisher/app/platforms/instagram_api.py | 189 ++ publisher/app/platforms/session/__init__.py | 0 publisher/app/platforms/session/browser.py | 425 +++++ publisher/app/platforms/session/common.py | 203 ++ .../app/platforms/session/instagram_web.py | 280 +++ publisher/app/platforms/session/runner.py | 177 ++ publisher/app/platforms/session/stats.py | 144 ++ .../app/platforms/session/tiktok_studio.py | 189 ++ .../app/platforms/session/youtube_studio.py | 217 +++ publisher/app/platforms/stats.py | 82 + publisher/app/platforms/tiktok_api.py | 237 +++ publisher/app/platforms/youtube_api.py | 271 +++ publisher/app/service.py | 584 ++++++ publisher/app/vault.py | 150 ++ publisher/app/worker.py | 113 ++ publisher/pytest.ini | 3 + publisher/requirements-dev.txt | 2 + publisher/requirements.txt | 8 + publisher/tests/__init__.py | 0 publisher/tests/conftest.py | 134 ++ publisher/tests/test_api.py | 166 ++ publisher/tests/test_browser.py | 323 ++++ publisher/tests/test_hardening.py | 333 ++++ publisher/tests/test_oauth.py | 157 ++ publisher/tests/test_stats.py | 41 + publisher/tests/test_uploads.py | 271 +++ publisher/tests/test_vault.py | 38 + publisher/tests/test_worker.py | 127 ++ scripts/cli.ts | 183 ++ scripts/dev.ts | 256 +++ scripts/lib/args.ts | 44 + scripts/lib/audio.ts | 55 + scripts/lib/frames.ts | 77 + scripts/lib/paths.ts | 31 + scripts/lib/process.ts | 126 ++ scripts/lib/render.ts | 418 ++++ scripts/lib/tools.ts | 105 + scripts/lib/verify.ts | 106 + scripts/setup.ps1 | 273 +++ scripts/tests/launcher.test.ts | 195 ++ setup.bat | 11 + start.bat | 4 + stories/README.md | 18 + .../asset.json | 18 + ...o-1-bothrops-insularis-instituto-butan.jpg | Bin 0 -> 442455 bytes .../asset.json | 18 + ...-trecho-3-bothrops-insularis-210457562.jpg | Bin 0 -> 226362 bytes .../asset.json | 18 + ...o-4-bothrops-insularis-queimada-grande.jpg | Bin 0 -> 420105 bytes .../asset.json | 18 + ...o-8-navio-balizador-faroleiro-mario-se.jpg | Bin 0 -> 578659 bytes .../asset.json | 18 + ...o-9-bothrops-insularis-ilha-queimada-g.jpg | Bin 0 -> 553320 bytes .../biblia.md | 37 + .../ep01.md | 41 + .../ep01.montage.json | 237 +++ .../godot/ep01-t01.json | 14 + .../godot/ep01-t02.json | 29 + .../godot/ep01-t03.json | 14 + .../godot/ep01-t04.json | 14 + .../godot/ep01-t05.json | 19 + .../godot/ep01-t06.json | 19 + .../godot/ep01-t07.json | 16 + .../godot/ep01-t08.json | 14 + .../godot/ep01-t09.json | 14 + .../meta.json | 1 + .../asset.json | 18 + ...o-10-bothrops-insularis-instituto-buta.jpg | Bin 0 -> 442455 bytes .../asset.json | 18 + ...trecho-11-bothrops-insularis-210457562.jpg | Bin 0 -> 226362 bytes .../naufragos-na-ilha-das-cobras/biblia.md | 68 + stories/naufragos-na-ilha-das-cobras/ep01.md | 67 + .../ep01.montage.json | 319 ++++ .../godot/ep01-t01.json | 16 + .../godot/ep01-t02.json | 16 + .../godot/ep01-t03.json | 16 + .../godot/ep01-t04.json | 16 + .../godot/ep01-t05.json | 16 + .../godot/ep01-t06.json | 16 + .../godot/ep01-t07.json | 16 + .../godot/ep01-t08.json | 16 + .../godot/ep01-t09.json | 16 + .../godot/ep01-t10.json | 17 + .../godot/ep01-t11.json | 17 + .../naufragos-na-ilha-das-cobras/meta.json | 1 + tsconfig.json | 17 + voice/.env.example | 27 + voice/README.md | 186 ++ voice/app/__init__.py | 0 voice/app/audio.py | 48 + voice/app/catalog.py | 246 +++ voice/app/config.py | 215 +++ voice/app/decode.py | 44 + voice/app/device.py | 106 + voice/app/engine.py | 361 ++++ voice/app/errors.py | 125 ++ voice/app/keys.py | 310 +++ voice/app/main.py | 507 +++++ voice/app/rvc.py | 84 + voice/app/schemas.py | 75 + voice/app/service.py | 113 ++ voice/app/store.py | 171 ++ voice/app/stt.py | 176 ++ voice/app/transcription.py | 187 ++ voice/app/work_queue.py | 125 ++ voice/clone/requirements.txt | 2 + voice/clone/worker.py | 212 ++ voice/models.lock.json | 155 ++ voice/pytest.ini | 3 + voice/requirements-cuda.txt | 5 + voice/requirements-dev.txt | 3 + voice/requirements-rvc.txt | 20 + voice/requirements.txt | 22 + voice/scripts/bench.py | 53 + voice/scripts/bench_stt.py | 89 + voice/scripts/fetch_models.py | 67 + voice/scripts/healthcheck.py | 12 + voice/scripts/smoke.py | 96 + voice/tests/__init__.py | 0 voice/tests/conftest.py | 84 + voice/tests/test_auth.py | 65 + voice/tests/test_cenaforge.py | 373 ++++ voice/tests/test_idempotency_cache.py | 82 + voice/tests/test_key_isolation.py | 274 +++ voice/tests/test_keys.py | 216 +++ voice/tests/test_queue.py | 98 + voice/tests/test_synthesize.py | 92 + voice/tests/test_transcribe.py | 185 ++ voice/tests/test_voices.py | 66 + voice/voices/catalog.json | 1284 +++++++++++++ 484 files changed, 74826 insertions(+) create mode 100644 .claude/agents/cenaforge-dashboard-designer.md create mode 100644 .claude/agents/cenaforge-skill-updater.md create mode 100644 .claude/agents/cenaforge-story-writer.md create mode 100644 .claude/agents/cenaforge-token-auditor.md create mode 100644 .claude/skills/cenaforge/CHANGELOG.md create mode 100644 .claude/skills/cenaforge/SKILL.md create mode 100644 .claude/skills/cenaforge/references/clipper.md create mode 100644 .claude/skills/cenaforge/references/gotchas.md create mode 100644 .claude/skills/cenaforge/references/panel.md create mode 100644 .claude/skills/cenaforge/references/publishing.md create mode 100644 .claude/skills/cenaforge/references/token-economy.md create mode 100644 .claude/skills/cenaforge/references/tools.md create mode 100644 .claude/skills/cenaforge/scripts/_common.py create mode 100644 .claude/skills/cenaforge/scripts/check_script.py create mode 100644 .claude/skills/cenaforge/scripts/check_skill.py create mode 100644 .claude/skills/cenaforge/scripts/clean_runs.py create mode 100644 .claude/skills/cenaforge/scripts/frame_check.py create mode 100644 .claude/skills/cenaforge/scripts/godot_api.py create mode 100644 .claude/skills/cenaforge/scripts/inspect_strip.py create mode 100644 .claude/skills/cenaforge/scripts/new_scene.py create mode 100644 .claude/skills/cenaforge/scripts/runs_summary.py create mode 100644 .claude/skills/content-pipeline/SKILL.md create mode 100644 .claude/skills/content-pipeline/references/01-pauta.md create mode 100644 .claude/skills/content-pipeline/references/02-roteiro.md create mode 100644 .claude/skills/content-pipeline/references/03-narracao.md create mode 100644 .claude/skills/content-pipeline/references/04-cenas.md create mode 100644 .claude/skills/content-pipeline/references/05-montagem.md create mode 100644 .claude/skills/content-pipeline/references/06-shorts.md create mode 100644 .claude/skills/content-pipeline/references/07-thumbnail.md create mode 100644 .claude/skills/content-pipeline/references/08-agenda.md create mode 100644 .claude/skills/content-pipeline/references/platforms.md create mode 100644 .claude/skills/content-pipeline/templates/ficha.md create mode 100644 .claude/skills/content-pipeline/templates/pauta.md create mode 100644 .gitignore create mode 100644 .studies/docs/init/PROMPT_TESTE_VIDEO_GODOT.md create mode 100644 AGENTS.md create mode 100644 CLAUDE.md create mode 100644 README.md create mode 100644 assets/fonts/Anton-Regular.OFL.txt create mode 100644 assets/fonts/Anton-Regular.ttf create mode 100644 assets/fonts/Bangers-Regular.OFL.txt create mode 100644 assets/fonts/Bangers-Regular.ttf create mode 100644 assets/fonts/BebasNeue-Regular.OFL.txt create mode 100644 assets/fonts/BebasNeue-Regular.ttf create mode 100644 assets/fonts/LuckiestGuy-Regular.LICENSE.txt create mode 100644 assets/fonts/LuckiestGuy-Regular.ttf create mode 100644 assets/fonts/Poppins-ExtraBold.OFL.txt create mode 100644 assets/fonts/Poppins-ExtraBold.ttf create mode 100644 assets/fonts/fonts.lock.json create mode 100644 assets/library/.gitkeep create mode 100644 clipper/.env.example create mode 100644 clipper/README.md create mode 100644 clipper/app/__init__.py create mode 100644 clipper/app/capture.py create mode 100644 clipper/app/chat.py create mode 100644 clipper/app/clip_delete.py create mode 100644 clipper/app/config.py create mode 100644 clipper/app/db.py create mode 100644 clipper/app/editor.py create mode 100644 clipper/app/editor_api.py create mode 100644 clipper/app/editor_render.py create mode 100644 clipper/app/emotes.py create mode 100644 clipper/app/face.py create mode 100644 clipper/app/hashtags.py create mode 100644 clipper/app/intel.py create mode 100644 clipper/app/judge.py create mode 100644 clipper/app/layout.py create mode 100644 clipper/app/main.py create mode 100644 clipper/app/media.py create mode 100644 clipper/app/reaction.py create mode 100644 clipper/app/reframe.py create mode 100644 clipper/app/scoring.py create mode 100644 clipper/app/sources.py create mode 100644 clipper/app/subtitles.py create mode 100644 clipper/app/worker.py create mode 100644 clipper/models.lock.json create mode 100644 clipper/pytest.ini create mode 100644 clipper/requirements-dev.txt create mode 100644 clipper/requirements.txt create mode 100644 clipper/tests/__init__.py create mode 100644 clipper/tests/test_capture_quality.py create mode 100644 clipper/tests/test_clip_delete.py create mode 100644 clipper/tests/test_duration_banner_fonts.py create mode 100644 clipper/tests/test_editor.py create mode 100644 clipper/tests/test_editor_layers.py create mode 100644 clipper/tests/test_face.py create mode 100644 clipper/tests/test_format_and_captions.py create mode 100644 clipper/tests/test_hashtags.py create mode 100644 clipper/tests/test_intel.py create mode 100644 clipper/tests/test_reaction.py create mode 100644 clipper/tests/test_reframe_insets.py create mode 100644 clipper/tests/test_render_and_duplicates.py create mode 100644 clipper/tests/test_resume.py create mode 100644 clipper/tests/test_scoring.py create mode 100644 clipper/tests/test_sources_and_api.py create mode 100644 clipper/tools/face_bench.py create mode 100644 config/demo-street-variant.json create mode 100644 config/demo-street.json create mode 100644 doc/FACE_BAKEOFF.md create mode 100644 doc/PLANO_RASTREIO_REACAO.md create mode 100644 doc/PROMPT_TESTE_VIDEO_GODOT.md create mode 100644 doc/TEST_RESULT.md create mode 100644 doc/clip-editor-research.md create mode 100644 doc/godot/api.md create mode 100644 doc/godot/cenas.md create mode 100644 doc/publicacao/PESQUISA.md create mode 100644 doc/publicacao/PLANO.md create mode 100644 doc/roteiro/comum.md create mode 100644 doc/roteiro/documental.md create mode 100644 doc/roteiro/ficcao.md create mode 100644 godot/assets/backgrounds/facade_00.png create mode 100644 godot/assets/backgrounds/facade_00.png.import create mode 100644 godot/assets/backgrounds/facade_01.png create mode 100644 godot/assets/backgrounds/facade_01.png.import create mode 100644 godot/assets/backgrounds/facade_02.png create mode 100644 godot/assets/backgrounds/facade_02.png.import create mode 100644 godot/assets/backgrounds/facade_03.png create mode 100644 godot/assets/backgrounds/facade_03.png.import create mode 100644 godot/assets/backgrounds/facade_04.png create mode 100644 godot/assets/backgrounds/facade_04.png.import create mode 100644 godot/assets/backgrounds/facade_05.png create mode 100644 godot/assets/backgrounds/facade_05.png.import create mode 100644 godot/assets/backgrounds/facade_06.png create mode 100644 godot/assets/backgrounds/facade_06.png.import create mode 100644 godot/assets/backgrounds/facade_07.png create mode 100644 godot/assets/backgrounds/facade_07.png.import create mode 100644 godot/assets/models/.gitkeep create mode 100644 godot/kits/boat.gd create mode 100644 godot/kits/person.gd create mode 100644 godot/library/castaways/actor.gd create mode 100644 godot/library/castaways/cast.gd create mode 100644 godot/library/castaways/manifest.json create mode 100644 godot/library/castaways/shore.gd create mode 100644 godot/library/castaways/sky.gd create mode 100644 godot/library/castaways/template.gd create mode 100644 godot/library/castaways/verify.gd create mode 100644 godot/library/island/manifest.json create mode 100644 godot/library/island/template.gd create mode 100644 godot/project.godot create mode 100644 godot/scenes/doc.tscn create mode 100644 godot/scenes/main.tscn create mode 100644 godot/scripts/builders/facade_painter.gd create mode 100644 godot/scripts/builders/facade_painter.gd.uid create mode 100644 godot/scripts/builders/rider_builder.gd create mode 100644 godot/scripts/builders/rider_builder.gd.uid create mode 100644 godot/scripts/builders/street_builder.gd create mode 100644 godot/scripts/builders/street_builder.gd.uid create mode 100644 godot/scripts/core/main.gd create mode 100644 godot/scripts/core/main.gd.uid create mode 100644 godot/scripts/core/scene_config.gd create mode 100644 godot/scripts/core/scene_config.gd.uid create mode 100644 godot/scripts/core/timeline_controller.gd create mode 100644 godot/scripts/core/timeline_controller.gd.uid create mode 100644 godot/scripts/doc/doc2d_canvas.gd create mode 100644 godot/scripts/doc/doc_config.gd create mode 100644 godot/scripts/doc/doc_main.gd create mode 100644 godot/scripts/view/camera_controller.gd create mode 100644 godot/scripts/view/camera_controller.gd.uid create mode 100644 godot/scripts/view/overlay_controller.gd create mode 100644 godot/scripts/view/overlay_controller.gd.uid create mode 100644 godot/tests/fixtures/audio-without-file.json create mode 100644 godot/tests/fixtures/impossible-times.json create mode 100644 godot/tests/fixtures/invalid-json.json create mode 100644 godot/tests/fixtures/unknown-field.json create mode 100644 godot/tests/fixtures/unknown-version.json create mode 100644 godot/tests/run_tests.gd create mode 100644 godot/tests/run_tests.gd.uid create mode 100644 godot/tools/generate_backgrounds.gd create mode 100644 godot/tools/generate_backgrounds.gd.uid create mode 100644 output/.gitkeep create mode 100644 package.json create mode 100644 panel/.gitignore create mode 100644 panel/.tmp-test/seed.mts create mode 100644 panel/AGENTS.md create mode 100644 panel/README.md create mode 100644 panel/next.config.ts create mode 100644 panel/package.json create mode 100644 panel/src/app/accounts/page.tsx create mode 100644 panel/src/app/actions.ts create mode 100644 panel/src/app/agent/page.tsx create mode 100644 panel/src/app/api/accounts/[id]/channels/[channelId]/route.ts create mode 100644 panel/src/app/api/accounts/[id]/channels/route.ts create mode 100644 panel/src/app/api/accounts/[id]/networks/[platform]/check/route.ts create mode 100644 panel/src/app/api/accounts/[id]/networks/[platform]/connect/route.ts create mode 100644 panel/src/app/api/accounts/[id]/networks/[platform]/creator-info/route.ts create mode 100644 panel/src/app/api/accounts/[id]/networks/[platform]/reopen/route.ts create mode 100644 panel/src/app/api/accounts/[id]/networks/[platform]/route.ts create mode 100644 panel/src/app/api/accounts/[id]/networks/[platform]/token/route.ts create mode 100644 panel/src/app/api/accounts/[id]/networks/route.ts create mode 100644 panel/src/app/api/accounts/[id]/route.ts create mode 100644 panel/src/app/api/accounts/[id]/stories/[storyId]/route.ts create mode 100644 panel/src/app/api/accounts/[id]/stories/route.ts create mode 100644 panel/src/app/api/accounts/route.ts create mode 100644 panel/src/app/api/agent/runs/[id]/cancel/route.ts create mode 100644 panel/src/app/api/agent/runs/[id]/events/route.ts create mode 100644 panel/src/app/api/agent/runs/[id]/messages/route.ts create mode 100644 panel/src/app/api/agent/runs/route.ts create mode 100644 panel/src/app/api/assets/[id]/promote/route.ts create mode 100644 panel/src/app/api/assets/route.ts create mode 100644 panel/src/app/api/clipper/[...path]/route.ts create mode 100644 panel/src/app/api/dashboard/metrics/route.ts create mode 100644 panel/src/app/api/dashboard/route.ts create mode 100644 panel/src/app/api/dashboard/simulate/route.ts create mode 100644 panel/src/app/api/episodes/[id]/approve/route.ts create mode 100644 panel/src/app/api/episodes/[id]/branches/route.ts create mode 100644 panel/src/app/api/episodes/[id]/montage/regenerate/route.ts create mode 100644 panel/src/app/api/episodes/[id]/montage/render/route.ts create mode 100644 panel/src/app/api/episodes/[id]/montage/route.ts create mode 100644 panel/src/app/api/episodes/[id]/montage/scene/route.ts create mode 100644 panel/src/app/api/episodes/[id]/montage/upload/route.ts create mode 100644 panel/src/app/api/episodes/[id]/render/route.ts create mode 100644 panel/src/app/api/files/route.ts create mode 100644 panel/src/app/api/publisher/status/route.ts create mode 100644 panel/src/app/api/publishing/clips/[id]/route.ts create mode 100644 panel/src/app/api/publishing/jobs/[id]/[action]/route.ts create mode 100644 panel/src/app/api/publishing/jobs/[id]/route.ts create mode 100644 panel/src/app/api/publishing/jobs/route.ts create mode 100644 panel/src/app/api/publishing/summary/route.ts create mode 100644 panel/src/app/api/renders/[id]/route.ts create mode 100644 panel/src/app/api/settings/apps/[platform]/route.ts create mode 100644 panel/src/app/api/settings/apps/route.ts create mode 100644 panel/src/app/api/settings/route.ts create mode 100644 panel/src/app/api/stories/[storyId]/flow/route.ts create mode 100644 panel/src/app/api/stories/route.ts create mode 100644 panel/src/app/api/voice/azure/route.ts create mode 100644 panel/src/app/api/voice/clone/route.ts create mode 100644 panel/src/app/api/voice/settings/route.ts create mode 100644 panel/src/app/api/voice/status/route.ts create mode 100644 panel/src/app/api/voice/synthesize/route.ts create mode 100644 panel/src/app/api/voice/transcribe/route.ts create mode 100644 panel/src/app/api/voice/voices/[id]/route.ts create mode 100644 panel/src/app/api/voice/voices/route.ts create mode 100644 panel/src/app/assets/page.tsx create mode 100644 panel/src/app/clipper/edit/[clipId]/page.tsx create mode 100644 panel/src/app/clipper/page.tsx create mode 100644 panel/src/app/dashboard/page.tsx create mode 100644 panel/src/app/globals.css create mode 100644 panel/src/app/icon.svg create mode 100644 panel/src/app/layout.tsx create mode 100644 panel/src/app/not-found.tsx create mode 100644 panel/src/app/page.tsx create mode 100644 panel/src/app/publishing/page.tsx create mode 100644 panel/src/app/settings/page.tsx create mode 100644 panel/src/app/stories/[storyId]/episodes/[number]/page.tsx create mode 100644 panel/src/app/stories/[storyId]/episodes/[number]/roteiro/page.tsx create mode 100644 panel/src/app/stories/[storyId]/page.tsx create mode 100644 panel/src/app/voices/page.tsx create mode 100644 panel/src/components/account-manager.tsx create mode 100644 panel/src/components/account-networks.tsx create mode 100644 panel/src/components/agent-console.tsx create mode 100644 panel/src/components/api-client.ts create mode 100644 panel/src/components/asset-table.tsx create mode 100644 panel/src/components/asset-upload.tsx create mode 100644 panel/src/components/clip-editor-fonts.tsx create mode 100644 panel/src/components/clip-editor-inspector.tsx create mode 100644 panel/src/components/clip-editor-keyframes.tsx create mode 100644 panel/src/components/clip-editor-layers.tsx create mode 100644 panel/src/components/clip-editor-model.ts create mode 100644 panel/src/components/clip-editor-preview.tsx create mode 100644 panel/src/components/clip-editor-source.tsx create mode 100644 panel/src/components/clip-editor-timeline.tsx create mode 100644 panel/src/components/clip-editor-transcript.tsx create mode 100644 panel/src/components/clip-editor-ui.tsx create mode 100644 panel/src/components/clip-editor.tsx create mode 100644 panel/src/components/clip-publish.tsx create mode 100644 panel/src/components/clipper-channels.tsx create mode 100644 panel/src/components/clipper-client.ts create mode 100644 panel/src/components/clipper-cut-settings.tsx create mode 100644 panel/src/components/clipper-games.tsx create mode 100644 panel/src/components/clipper-judge.tsx create mode 100644 panel/src/components/clipper-queue.tsx create mode 100644 panel/src/components/clipper-sessions.tsx create mode 100644 panel/src/components/clipper-studio.tsx create mode 100644 panel/src/components/confirm-dialog.tsx create mode 100644 panel/src/components/connect-wizard.tsx create mode 100644 panel/src/components/copy-button.tsx create mode 100644 panel/src/components/dashboard-controls.tsx create mode 100644 panel/src/components/delete-story-button.tsx create mode 100644 panel/src/components/dialog.tsx create mode 100644 panel/src/components/episode-approve.tsx create mode 100644 panel/src/components/forms.tsx create mode 100644 panel/src/components/icons.tsx create mode 100644 panel/src/components/logo.tsx create mode 100644 panel/src/components/metrics-view.tsx create mode 100644 panel/src/components/montage-editor.tsx create mode 100644 panel/src/components/platforms.tsx create mode 100644 panel/src/components/publishing-board.tsx create mode 100644 panel/src/components/publishing-client.ts create mode 100644 panel/src/components/publishing-ui.tsx create mode 100644 panel/src/components/rect-geometry.ts create mode 100644 panel/src/components/render-controls.tsx create mode 100644 panel/src/components/script-reader.tsx create mode 100644 panel/src/components/settings-panel.tsx create mode 100644 panel/src/components/sidebar-nav.tsx create mode 100644 panel/src/components/story-composer.tsx create mode 100644 panel/src/components/story-flow.tsx create mode 100644 panel/src/components/story-formats.ts create mode 100644 panel/src/components/tabs.tsx create mode 100644 panel/src/components/ui.tsx create mode 100644 panel/src/components/voice-add-form.tsx create mode 100644 panel/src/components/voice-cards.tsx create mode 100644 panel/src/components/voice-client.ts create mode 100644 panel/src/components/voice-clone-form.tsx create mode 100644 panel/src/components/voice-studio.tsx create mode 100644 panel/src/components/voice-transcribe.tsx create mode 100644 panel/src/instrumentation.ts create mode 100644 panel/src/lib/accounts.ts create mode 100644 panel/src/lib/agents.ts create mode 100644 panel/src/lib/assets.ts create mode 100644 panel/src/lib/branches.ts create mode 100644 panel/src/lib/clipper.ts create mode 100644 panel/src/lib/db.ts create mode 100644 panel/src/lib/decisions.ts create mode 100644 panel/src/lib/dispatcher.ts create mode 100644 panel/src/lib/flow.ts create mode 100644 panel/src/lib/http.ts create mode 100644 panel/src/lib/image-search.ts create mode 100644 panel/src/lib/metrics-sync.ts create mode 100644 panel/src/lib/metrics.ts create mode 100644 panel/src/lib/montage-ffmpeg.ts create mode 100644 panel/src/lib/montage-godot.ts create mode 100644 panel/src/lib/montage.ts create mode 100644 panel/src/lib/paths.ts create mode 100644 panel/src/lib/proc.ts create mode 100644 panel/src/lib/prompts.ts create mode 100644 panel/src/lib/proxy.test.ts create mode 100644 panel/src/lib/publisher.ts create mode 100644 panel/src/lib/publishing-db.test.ts create mode 100644 panel/src/lib/publishing-rules.test.ts create mode 100644 panel/src/lib/publishing-rules.ts create mode 100644 panel/src/lib/publishing.ts create mode 100644 panel/src/lib/renders.ts create mode 100644 panel/src/lib/scene-library.ts create mode 100644 panel/src/lib/script-doc.ts create mode 100644 panel/src/lib/settings.ts create mode 100644 panel/src/lib/speech-text.ts create mode 100644 panel/src/lib/stories.ts create mode 100644 panel/src/lib/types.ts create mode 100644 panel/src/lib/voice.ts create mode 100644 panel/src/proxy.ts create mode 100644 panel/tsconfig.json create mode 100644 pnpm-lock.yaml create mode 100644 pnpm-workspace.yaml create mode 100644 publisher/.env.example create mode 100644 publisher/.gitignore create mode 100644 publisher/README.md create mode 100644 publisher/app/__init__.py create mode 100644 publisher/app/acl.py create mode 100644 publisher/app/config.py create mode 100644 publisher/app/db.py create mode 100644 publisher/app/main.py create mode 100644 publisher/app/paths.py create mode 100644 publisher/app/platforms/__init__.py create mode 100644 publisher/app/platforms/base.py create mode 100644 publisher/app/platforms/instagram_api.py create mode 100644 publisher/app/platforms/session/__init__.py create mode 100644 publisher/app/platforms/session/browser.py create mode 100644 publisher/app/platforms/session/common.py create mode 100644 publisher/app/platforms/session/instagram_web.py create mode 100644 publisher/app/platforms/session/runner.py create mode 100644 publisher/app/platforms/session/stats.py create mode 100644 publisher/app/platforms/session/tiktok_studio.py create mode 100644 publisher/app/platforms/session/youtube_studio.py create mode 100644 publisher/app/platforms/stats.py create mode 100644 publisher/app/platforms/tiktok_api.py create mode 100644 publisher/app/platforms/youtube_api.py create mode 100644 publisher/app/service.py create mode 100644 publisher/app/vault.py create mode 100644 publisher/app/worker.py create mode 100644 publisher/pytest.ini create mode 100644 publisher/requirements-dev.txt create mode 100644 publisher/requirements.txt create mode 100644 publisher/tests/__init__.py create mode 100644 publisher/tests/conftest.py create mode 100644 publisher/tests/test_api.py create mode 100644 publisher/tests/test_browser.py create mode 100644 publisher/tests/test_hardening.py create mode 100644 publisher/tests/test_oauth.py create mode 100644 publisher/tests/test_stats.py create mode 100644 publisher/tests/test_uploads.py create mode 100644 publisher/tests/test_vault.py create mode 100644 publisher/tests/test_worker.py create mode 100644 scripts/cli.ts create mode 100644 scripts/dev.ts create mode 100644 scripts/lib/args.ts create mode 100644 scripts/lib/audio.ts create mode 100644 scripts/lib/frames.ts create mode 100644 scripts/lib/paths.ts create mode 100644 scripts/lib/process.ts create mode 100644 scripts/lib/render.ts create mode 100644 scripts/lib/tools.ts create mode 100644 scripts/lib/verify.ts create mode 100644 scripts/setup.ps1 create mode 100644 scripts/tests/launcher.test.ts create mode 100644 setup.bat create mode 100644 start.bat create mode 100644 stories/README.md create mode 100644 stories/a-ilha-da-queimada-grande-conhecida-como/assets/image/ep01-trecho-1-bothrops-insularis-instituto-butan/asset.json create mode 100644 stories/a-ilha-da-queimada-grande-conhecida-como/assets/image/ep01-trecho-1-bothrops-insularis-instituto-butan/ep01-trecho-1-bothrops-insularis-instituto-butan.jpg create mode 100644 stories/a-ilha-da-queimada-grande-conhecida-como/assets/image/ep01-trecho-3-bothrops-insularis-210457562/asset.json create mode 100644 stories/a-ilha-da-queimada-grande-conhecida-como/assets/image/ep01-trecho-3-bothrops-insularis-210457562/ep01-trecho-3-bothrops-insularis-210457562.jpg create mode 100644 stories/a-ilha-da-queimada-grande-conhecida-como/assets/image/ep01-trecho-4-bothrops-insularis-queimada-grande/asset.json create mode 100644 stories/a-ilha-da-queimada-grande-conhecida-como/assets/image/ep01-trecho-4-bothrops-insularis-queimada-grande/ep01-trecho-4-bothrops-insularis-queimada-grande.jpg create mode 100644 stories/a-ilha-da-queimada-grande-conhecida-como/assets/image/ep01-trecho-8-navio-balizador-faroleiro-mario-se/asset.json create mode 100644 stories/a-ilha-da-queimada-grande-conhecida-como/assets/image/ep01-trecho-8-navio-balizador-faroleiro-mario-se/ep01-trecho-8-navio-balizador-faroleiro-mario-se.jpg create mode 100644 stories/a-ilha-da-queimada-grande-conhecida-como/assets/image/ep01-trecho-9-bothrops-insularis-ilha-queimada-g/asset.json create mode 100644 stories/a-ilha-da-queimada-grande-conhecida-como/assets/image/ep01-trecho-9-bothrops-insularis-ilha-queimada-g/ep01-trecho-9-bothrops-insularis-ilha-queimada-g.jpg create mode 100644 stories/a-ilha-da-queimada-grande-conhecida-como/biblia.md create mode 100644 stories/a-ilha-da-queimada-grande-conhecida-como/ep01.md create mode 100644 stories/a-ilha-da-queimada-grande-conhecida-como/ep01.montage.json create mode 100644 stories/a-ilha-da-queimada-grande-conhecida-como/godot/ep01-t01.json create mode 100644 stories/a-ilha-da-queimada-grande-conhecida-como/godot/ep01-t02.json create mode 100644 stories/a-ilha-da-queimada-grande-conhecida-como/godot/ep01-t03.json create mode 100644 stories/a-ilha-da-queimada-grande-conhecida-como/godot/ep01-t04.json create mode 100644 stories/a-ilha-da-queimada-grande-conhecida-como/godot/ep01-t05.json create mode 100644 stories/a-ilha-da-queimada-grande-conhecida-como/godot/ep01-t06.json create mode 100644 stories/a-ilha-da-queimada-grande-conhecida-como/godot/ep01-t07.json create mode 100644 stories/a-ilha-da-queimada-grande-conhecida-como/godot/ep01-t08.json create mode 100644 stories/a-ilha-da-queimada-grande-conhecida-como/godot/ep01-t09.json create mode 100644 stories/a-ilha-da-queimada-grande-conhecida-como/meta.json create mode 100644 stories/naufragos-na-ilha-das-cobras/assets/image/ep01-trecho-10-bothrops-insularis-instituto-buta/asset.json create mode 100644 stories/naufragos-na-ilha-das-cobras/assets/image/ep01-trecho-10-bothrops-insularis-instituto-buta/ep01-trecho-10-bothrops-insularis-instituto-buta.jpg create mode 100644 stories/naufragos-na-ilha-das-cobras/assets/image/ep01-trecho-11-bothrops-insularis-210457562/asset.json create mode 100644 stories/naufragos-na-ilha-das-cobras/assets/image/ep01-trecho-11-bothrops-insularis-210457562/ep01-trecho-11-bothrops-insularis-210457562.jpg create mode 100644 stories/naufragos-na-ilha-das-cobras/biblia.md create mode 100644 stories/naufragos-na-ilha-das-cobras/ep01.md create mode 100644 stories/naufragos-na-ilha-das-cobras/ep01.montage.json create mode 100644 stories/naufragos-na-ilha-das-cobras/godot/ep01-t01.json create mode 100644 stories/naufragos-na-ilha-das-cobras/godot/ep01-t02.json create mode 100644 stories/naufragos-na-ilha-das-cobras/godot/ep01-t03.json create mode 100644 stories/naufragos-na-ilha-das-cobras/godot/ep01-t04.json create mode 100644 stories/naufragos-na-ilha-das-cobras/godot/ep01-t05.json create mode 100644 stories/naufragos-na-ilha-das-cobras/godot/ep01-t06.json create mode 100644 stories/naufragos-na-ilha-das-cobras/godot/ep01-t07.json create mode 100644 stories/naufragos-na-ilha-das-cobras/godot/ep01-t08.json create mode 100644 stories/naufragos-na-ilha-das-cobras/godot/ep01-t09.json create mode 100644 stories/naufragos-na-ilha-das-cobras/godot/ep01-t10.json create mode 100644 stories/naufragos-na-ilha-das-cobras/godot/ep01-t11.json create mode 100644 stories/naufragos-na-ilha-das-cobras/meta.json create mode 100644 tsconfig.json create mode 100644 voice/.env.example create mode 100644 voice/README.md create mode 100644 voice/app/__init__.py create mode 100644 voice/app/audio.py create mode 100644 voice/app/catalog.py create mode 100644 voice/app/config.py create mode 100644 voice/app/decode.py create mode 100644 voice/app/device.py create mode 100644 voice/app/engine.py create mode 100644 voice/app/errors.py create mode 100644 voice/app/keys.py create mode 100644 voice/app/main.py create mode 100644 voice/app/rvc.py create mode 100644 voice/app/schemas.py create mode 100644 voice/app/service.py create mode 100644 voice/app/store.py create mode 100644 voice/app/stt.py create mode 100644 voice/app/transcription.py create mode 100644 voice/app/work_queue.py create mode 100644 voice/clone/requirements.txt create mode 100644 voice/clone/worker.py create mode 100644 voice/models.lock.json create mode 100644 voice/pytest.ini create mode 100644 voice/requirements-cuda.txt create mode 100644 voice/requirements-dev.txt create mode 100644 voice/requirements-rvc.txt create mode 100644 voice/requirements.txt create mode 100644 voice/scripts/bench.py create mode 100644 voice/scripts/bench_stt.py create mode 100644 voice/scripts/fetch_models.py create mode 100644 voice/scripts/healthcheck.py create mode 100644 voice/scripts/smoke.py create mode 100644 voice/tests/__init__.py create mode 100644 voice/tests/conftest.py create mode 100644 voice/tests/test_auth.py create mode 100644 voice/tests/test_cenaforge.py create mode 100644 voice/tests/test_idempotency_cache.py create mode 100644 voice/tests/test_key_isolation.py create mode 100644 voice/tests/test_keys.py create mode 100644 voice/tests/test_queue.py create mode 100644 voice/tests/test_synthesize.py create mode 100644 voice/tests/test_transcribe.py create mode 100644 voice/tests/test_voices.py create mode 100644 voice/voices/catalog.json diff --git a/.claude/agents/cenaforge-dashboard-designer.md b/.claude/agents/cenaforge-dashboard-designer.md new file mode 100644 index 0000000..2ae2328 --- /dev/null +++ b/.claude/agents/cenaforge-dashboard-designer.md @@ -0,0 +1,68 @@ +--- +name: cenaforge-dashboard-designer +description: Designer e desenvolvedor front-end do painel CenaForge (panel/, Next.js 16 + React 19 + Tailwind 4). Use para criar ou modernizar a interface do painel — identidade visual, logo, design system (tokens, componentes), layout, navegação, estados vazios/carregando/erro, acessibilidade e responsividade. Não mexe na lógica de dados, agentes, renders nem na cena Godot. +tools: Read, Glob, Grep, Edit, Write, Bash +model: opus +--- + +Você é o designer do painel do CenaForge: uma ferramenta local para produzir histórias animadas +em episódios verticais, com decisão A/B do público, assets por história e uma biblioteca +compartilhada, render de vídeo e agentes de código (Claude, Codex) acionados pela CLI. +Quem usa é o criador das histórias, trabalhando horas seguidas no painel. Escreva textos de +interface em português do Brasil; identificadores de código em inglês. + +## Antes de começar + +1. Leia `panel/README.md`, `panel/AGENTS.md` e o `CLAUDE.md` da raiz. +2. **Este Next.js (16.4) difere do que você conhece.** Antes de usar qualquer API do Next, leia o + guia correspondente em `node_modules/next/dist/docs/` (a partir de `panel/` ou da raiz do + repositório). Ex.: metadados e ícones em `01-app/03-api-reference/03-file-conventions/01-metadata/`. +3. Leia as páginas em `panel/src/app/` e os componentes em `panel/src/components/` para entender + o que existe antes de propor mudanças. + +## Limites + +- Pode editar: `panel/src/app/**` (páginas, `layout.tsx`, `globals.css`, ícones e metadados), + `panel/src/components/**` e `panel/public/**`. +- **Não edite**: `panel/src/lib/**`, `panel/src/app/api/**`, `panel/src/app/actions.ts` (contratos de + dados e servidor), nada fora de `panel/`. Se precisar de um dado novo, descreva no retorno o que + o servidor deveria expor. +- Preserve todo comportamento existente: os mesmos formulários, ações, rotas, nomes de campos + (`name=`), confirmações e mensagens de erro vindas do servidor. +- Dependências: prefira zero novas. Tailwind 4 e SVG inline resolvem quase tudo. Se uma + dependência for indispensável (ex.: biblioteca de ícones), use versão exata, explique por quê no + retorno e não adicione mais de uma. +- Sem fontes ou imagens de CDN externo: o painel funciona offline. Use fontes do sistema ou um + arquivo de fonte local com licença livre. +- Porta do painel: 4500 (faixa do projeto 4500–4599). Não suba servidores em outras portas. + +## Padrão visual (design system) + +- **Tokens** em `panel/src/app/globals.css` (`@theme` do Tailwind 4): cores de superfície, texto, + borda, destaque, estados (sucesso, aviso, erro, informação), raio, sombra e espaçamento. As + páginas usam os tokens, não cores soltas. +- **Componentes base** em `panel/src/components/ui/` (ou `ui.tsx`, se ficar pequeno): botão + (primário, secundário, fantasma, perigo), campo, select, textarea, cartão, badge de estado, + cabeçalho de página, estado vazio, tabela, abas se necessário. Um jeito de fazer cada coisa. +- **Identidade:** tema escuro como padrão (uso prolongado, vídeo em destaque), contraste + WCAG AA, foco visível em todo elemento interativo, navegação por teclado, `prefers-reduced-motion` + respeitado, layout que funciona de 1280 px até 1920 px e não quebra em 1024 px. +- **Logo:** SVG próprio, simples e legível a 16 px (favicon) e a 32 px (barra lateral), sem + imitar marca existente. Entregue o componente React do logo, `app/icon.svg` (favicon) e, se + fizer sentido, `app/apple-icon.png` gerado a partir do SVG. + +## Verificação obrigatória + +1. `pnpm --filter cenaforge-panel build`: sem erros de tipo e sem avisos novos. +2. Com o painel rodando em http://127.0.0.1:4500 (se não estiver, `pnpm panel` em segundo plano), + confira que `/`, `/assets`, `/agent` e uma história inexistente (`/stories/x` → 404) respondem. +3. Se houver navegador automatizado disponível, tire capturas das páginas e avalie; se não houver, + diga isso no retorno. Não afirme aparência que não viu. + +## Retorno + +1. O que mudou (tokens, componentes, páginas, logo), com caminhos. +2. Decisões de design e por quê (paleta, tipografia, hierarquia). +3. Resultado da verificação (build, rotas, capturas ou "não vistas"). +4. Pendências e sugestões para o servidor (dados que faltam na interface). +5. Bloco "Para o cenaforge-skill-updater": o que registrar na skill. diff --git a/.claude/agents/cenaforge-skill-updater.md b/.claude/agents/cenaforge-skill-updater.md new file mode 100644 index 0000000..d9bfa6b --- /dev/null +++ b/.claude/agents/cenaforge-skill-updater.md @@ -0,0 +1,82 @@ +--- +name: cenaforge-skill-updater +description: Especialista em manter a skill do CenaForge (.claude/skills/cenaforge/) atualizada e fiel ao repositório. Use PROATIVAMENTE depois de qualquer melhoria no projeto CenaForge — campo novo no JSON, preset, comando, ferramenta nova ou trocada (Godot, FFmpeg, encoder, gerador 3D, voz), armadilha descoberta, mudança no pipeline de render ou desempenho medido. Passe o que mudou, os arquivos tocados e a evidência. Só edita a skill; nunca altera o código do projeto. +model: sonnet +tools: Read, Grep, Glob, Edit, Write, Bash +--- + +Você é o mantenedor da skill `cenaforge`. Seu único trabalho é deixar +`.claude/skills/cenaforge/` correta, completa e enxuta, refletindo o estado REAL do +repositório. Responda e escreva em português (pt-BR); identificadores, comandos e caminhos +ficam como estão no código. + +## Arquivos que você mantém (e só estes) + +``` +.claude/skills/cenaforge/SKILL.md receita, mapa "onde mexer", invariantes, validação +.claude/skills/cenaforge/references/tools.md inventário de ferramentas e versões, candidatas, critérios +.claude/skills/cenaforge/references/gotchas.md armadilhas: sintoma → causa → correção → onde +.claude/skills/cenaforge/CHANGELOG.md histórico com versão semântica da skill +``` + +Pode criar um novo arquivo em `references/` quando um assunto crescer demais para o +`SKILL.md` (ex.: `references/assets-3d.md` quando houver pipeline de GLB). Nunca edite nada +fora de `.claude/skills/cenaforge/`. Se perceber que o código, o README ou o +`doc/TEST_RESULT.md` estão errados ou se contradizem, **relate** no seu retorno — não corrija. + +## Entrada esperada + +Quem te chama deve informar: o que mudou e por quê, arquivos tocados e evidência (comando +executado + resultado). Se faltar algo, descubra no repositório; se ainda assim não der para +confirmar, registre como "não verificado" ou deixe de fora — nunca invente. + +## Procedimento + +1. **Leia a skill inteira** (os quatro arquivos) antes de mudar qualquer coisa. +2. **Confira cada fato no repositório**, não no resumo recebido: + - comandos → `package.json` e `scripts/cli.ts`; + - campos do JSON → `godot/scripts/core/scene_config.gd` e `config/*.json`; + - caminhos → `Glob`; + - versões de ferramentas → rode `--version` / `-version` (só comandos de leitura); + - tempos e resultados → `output/runs/*/report.json` ou `doc/TEST_RESULT.md`. + Pode rodar `pnpm run doctor`, `pnpm test` e `pnpm typecheck` se a mudança alega + comportamento. **Não** rode `pnpm render`, não instale nem atualize nada, não apague + arquivos do projeto. +3. **Decida onde a informação mora:** + - como fazer / onde mexer / regra que não pode quebrar → `SKILL.md`; + - ferramenta, versão, candidata, critério de adoção → `references/tools.md`; + - problema observado e sua solução → `references/gotchas.md`; + - detalhe que já está bem descrito no README → só um ponteiro, sem duplicar. +4. **Edite substituindo, não empilhando.** Remova o que ficou obsoleto (comando renomeado, + versão antiga, armadilha que deixou de existir). Uma informação, um lugar. +5. **Mantenha o `SKILL.md` curto** (meta: até ~200 linhas). Mova detalhes para `references/`. +6. **Revise o `description` do frontmatter** quando a skill ganhar capacidade nova: ele é o que + faz a skill ser acionada. Deve listar os tipos de pedido que ela cobre, sem promessas falsas. +7. **Versione:** atualize a linha "Versão da skill" no `SKILL.md` e acrescente uma entrada no + topo do `CHANGELOG.md` com a data absoluta (DD/MM/AAAA) e o que mudou. + patch = correção; minor = capacidade/ferramenta/preset/comando/armadilha nova; + major = mudança incompatível no contrato JSON ou no pipeline. +8. **Autoverificação final:** + - todo caminho citado existe (`Glob`); + - todo comando citado existe em `package.json`/`cli.ts`; + - versões batem com o que você verificou; + - nenhum caminho pessoal, e-mail, token ou segredo na skill (use caminhos relativos ao repo); + - ferramentas candidatas continuam marcadas como "não integradas" até haver evidência. + +## Regras de conteúdo + +- Ferramenta só vai para "Em uso" com versão exata, data e evidência de um render de prévia que + passou. Antes disso, fica em "Planejadas ou candidatas". +- Não afirme desempenho, qualidade ou compatibilidade sem medição registrada. +- Integrações fora do escopo atual (painel, API, banco, Instagram, Applio, Meshy) aparecem só + como candidatas/visão futura, até o usuário pedir e haver teste. +- Escreva para outro agente que vai produzir vídeos: instruções diretas, exemplos de comando + reais, sem narrativa. + +## Retorno + +Responda em poucas linhas: +1. arquivos alterados e nova versão da skill; +2. o que mudou em cada um; +3. o que não pôde ser verificado ou ficou de fora, e por quê; +4. inconsistências encontradas no projeto (se houver), sem tê-las corrigido. diff --git a/.claude/agents/cenaforge-story-writer.md b/.claude/agents/cenaforge-story-writer.md new file mode 100644 index 0000000..6918a1c --- /dev/null +++ b/.claude/agents/cenaforge-story-writer.md @@ -0,0 +1,25 @@ +--- +name: cenaforge-story-writer +description: Roteirista do CenaForge, roda num modelo mais barato. Use para escrever ou revisar enredo, episódios, diálogos, narração, título da chamada final e opções A/B de uma história, ou o roteiro de um vídeo documental — qualquer trabalho de TEXTO narrativo. Não mexe em código, render nem configurações; devolve o texto pronto e os campos de overlay no formato do JSON. +tools: Read, Glob, Grep, Write +model: sonnet +--- + +Você é o roteirista do CenaForge: vídeos verticais curtos — histórias animadas (interativas com +votação, ou lineares) e vídeos documentais sobre fatos reais. + +## Regras: as mesmas do Codex + +As regras de texto ficam em `doc/roteiro/`, a mesma fonte que o painel manda o Codex seguir. +Não há regra de roteiro neste arquivo: tudo vem de lá. + +1. Leia `doc/roteiro/comum.md` (idioma, onde escrever, estrutura, limites do overlay, retorno). +2. Leia o guia do formato da história: + - interativa ou linear → `doc/roteiro/ficcao.md`; + - documental → `doc/roteiro/documental.md`. + +O formato vem no pedido. Se não vier, está na primeira linha de `stories//biblia.md`. +Num pedido documental, as restrições de ficção (sem cidade real, escolha A/B) não valem. + +Sua ferramenta não busca na web. Num documental, use as fontes que o pedido ou a ficha de pauta +trouxerem. Se faltar fonte para um fato, marque-o como "a confirmar" em vez de inventar. diff --git a/.claude/agents/cenaforge-token-auditor.md b/.claude/agents/cenaforge-token-auditor.md new file mode 100644 index 0000000..5c425d7 --- /dev/null +++ b/.claude/agents/cenaforge-token-auditor.md @@ -0,0 +1,68 @@ +--- +name: cenaforge-token-auditor +description: Especialista em economia de tokens do CenaForge. Use quando o trabalho estiver ficando caro ou repetitivo, ao fim de uma sessão longa, ou quando pedirem para "economizar tokens", "automatizar" ou "usar modelo mais barato". Encontra tarefas repetidas e as transforma em scripts .py (ou .ps1 quando for algo só do Windows), e decide qual modelo/agente deve fazer cada tipo de tarefa. Só cria scripts na skill e edita o guia de economia. +tools: Read, Grep, Glob, Edit, Write, Bash +model: sonnet +--- + +Você reduz o custo de trabalhar no CenaForge sem reduzir a qualidade das entregas. Escreva em +português (pt-BR); identificadores de código em inglês, comentários e mensagens em português. + +## O que você mantém + +``` +.claude/skills/cenaforge/scripts/*.py scripts de tarefas repetidas (biblioteca padrão) +.claude/skills/cenaforge/scripts/*.ps1 só se a tarefa for exclusivamente Windows +.claude/skills/cenaforge/references/token-economy.md guia: modelo por tarefa, regras, scripts +``` + +Não edite `SKILL.md`, `tools.md`, `gotchas.md`, `CHANGELOG.md`, código do projeto (`godot/`, +`scripts/` da raiz, `config/`) nem outros agentes. Quando criar ou mudar um script, termine +o retorno com o bloco "Para o cenaforge-skill-updater", com o que ele deve registrar. + +## Como encontrar desperdício + +Pergunte (ou leia, se te passarem) o que foi feito na sessão. Procure: + +1. **Comandos repetidos** com pequenas variações (mesma sequência de ffmpeg/ffprobe, python + one-liners lendo `report.json`, buscas de caminho) → script com argumentos. +2. **Leituras grandes para extrair pouco** (log inteiro, JSON inteiro, vários PNGs) → script que + imprime só o necessário, ou uma imagem única (tira/contact sheet). +3. **Trabalho de texto feito pelo modelo caro** (enredo, diálogos, variações de título) → + `cenaforge-story-writer` (sonnet) ou `haiku` para variações em massa. +4. **Verificações manuais repetidas** (caminhos da skill, versões) → script de checagem. +5. **Busca ampla no código** → agente `Explore` em vez de ler arquivo por arquivo. + +Só crie um script se a tarefa já se repetiu (≥ 2 vezes) ou vai se repetir a cada vídeo. +Antes, verifique se já existe algo equivalente em `.claude/skills/cenaforge/scripts/` ou no +lançador (`pnpm render`, `pnpm verify`, `pnpm run doctor`) — não duplique o lançador. + +## Regras para scripts + +- Python 3.10+ só com biblioteca padrão; importe `_common.py` (raiz do repo, `find_tool`, + `utf8_stdout`, `rel`). Sem dependências novas. +- Docstring no topo com o que faz, **por que economiza tokens** e exemplos de uso. +- Saída curta e estável (uma linha por item); caminhos relativos à raiz; código de saída ≠ 0 + em falha. +- Nunca use shell para montar comandos (`subprocess.run([...])` com lista). +- Ação destrutiva só com `--apply`; o padrão é simular. +- **Teste de verdade** cada script (caso normal + caso de erro) antes de entregar, e mostre a + saída no retorno. Não rode `pnpm render` só para testar um script: use execuções que já + existam em `output/runs/`. + +## Escolha de modelo (resumo; detalhes no guia) + +| Tarefa | Quem | +|---|---| +| Arquitetura, depuração difícil, pipeline de render, revisão final | modelo principal | +| Enredo, episódios, diálogos, títulos, opções A/B | `cenaforge-story-writer` (sonnet) | +| Muitas variações curtas de texto, classificar, resumir logs | subagente com `model: haiku` | +| Atualizar a skill | `cenaforge-skill-updater` | +| Busca ampla no repositório | `Explore` | + +## Retorno + +1. Desperdícios encontrados (com estimativa qualitativa: alto/médio/baixo). +2. Scripts criados/alterados, com a saída real dos testes. +3. Mudanças no guia `token-economy.md`. +4. Bloco "Para o cenaforge-skill-updater". diff --git a/.claude/skills/cenaforge/CHANGELOG.md b/.claude/skills/cenaforge/CHANGELOG.md new file mode 100644 index 0000000..59af25e --- /dev/null +++ b/.claude/skills/cenaforge/CHANGELOG.md @@ -0,0 +1,670 @@ +# Histórico da skill cenaforge + +Versão semântica da **skill** (não do projeto): +- **patch** — correção de texto, dado ou caminho; +- **minor** — capacidade, ferramenta, preset, comando ou armadilha nova; +- **major** — mudança incompatível no contrato JSON ou no pipeline. + +Mantido pelo subagente `cenaforge-skill-updater`. Entradas mais novas no topo. + +## 1.42.0 — 17/11/2026 + +Instagram sem corte quadrado, corte sem rótulo de IA e ação "Apaguei na rede". +- `references/publishing.md`: regra do formato "Original" (`keep_original_shape`), corte nunca leva rótulo de IA, ação + `removed`/`markRemoved`; evidência do 1º reel real. +- `references/gotchas.md`: itens novos 147 (reel 1:1; `common.find` olha até 6 ocorrências), 148 (rótulo de IA em corte; + "Perfil gerado por IA" provavelmente do perfil, não confirmado), 149 ("Apaguei na rede"), 150 (`python -I` e + `PYTHONIOENCODING`). +- `SKILL.md`: versão e resumo de armadilhas. +- Evidência: `pnpm test:publisher` → 78 passed (reexecutado). Informados, não reexecutados: `test:panel` 66/66, typecheck, + ensaio ao vivo sem publicar. Não verificado: publicação real com o formato novo (precisa reiniciar o `pnpm dev`). + +## 1.41.0 — 17/11/2026 + +Modo sessão do Instagram: botão "Postar", seletores presos ao diálogo, `prepare`/`upload`, rótulo de IA e link do reel. +- `references/publishing.md`: regra "Instagram em modo sessão" (fluxo, `prepare` sem clicar, `find_ai_switch`, + `close_suggestions`, `find_reel_url`, ensaio sem publicar, o que foi e o que não foi validado); evidência; linha do + "Primeiro envio real" atualizada. +- `references/gotchas.md`: itens novos 145 (botão Postar e "Compartilhar" do feed) e 146 (sugestões de hashtag por cima do + rótulo de IA; sem `force=True`); nota "Relacionadas". +- `SKILL.md`: versão e resumo de armadilhas. +- Evidência: `pnpm test:publisher` → 78 passed (reexecutado). Informado, não reexecutado: ensaio ao vivo com conta real. + Não verificado: Compartilhar, confirmação e `find_reel_url` com conta real; falta reiniciar o `pnpm dev`. + +## 1.40.0 — 17/11/2026 + +Hashtags da legenda dos cortes, espera do link do TikTok com recarga da lista e armadilha do serviço com código antigo. +- `references/clipper.md`: seção "Hashtags da legenda" (`hashtags.py`: `to_tag`, `fold`, `split_hashtags`, `compose`, + `build_caption`; campo `hashtags` no veredito e no perfil do jogo; painel), linha em "Onde mexer", `hashtags` no `PUT + /v1/games`, evidência e "Não verificado". +- `references/publishing.md`: `find_video_url` com 12 cargas × 5 leituras (~3 min) e progresso; mensagem do painel + "Saiu na rede…" (`readPublisherJob`); evidência. +- `references/gotchas.md`: item 140 atualizado (2ª versão); itens novos 143 (processo mais antigo que o arquivo: rodou código + antigo) e 144 (hashtags do perfil/cortes antigos). +- `SKILL.md`: versão, `description`, linha em "Onde mexer" e resumo de armadilhas. +- API do perfil: `GameRefineIn.section` aceita `"hashtags"` e `GameProfileIn.hashtags` (máx. 20) evita apagar as tags ao + salvar o perfil à mão (corrigido pelo coordenador; registrado em `clipper.md`). +- Evidência: `pnpm test:clipper` → 278 passed e `pnpm test:publisher` → 76 passed (ambos reexecutados). Informados, não + reexecutados: `test:panel` 65/65, typecheck, validação ao vivo do link. + +## 1.39.0 — 17/11/2026 + +Modo sessão (TikTok): aviso de novidade do Studio bloqueava o clique na legenda. +- `references/gotchas.md`: item 142 (sintoma, causa, `TIP_BUTTONS`/`dismiss_tips`/`click_through`, regra de só fechar + avisos "entendi", mensagens de `browser_error_text`, testes); nota "Relacionadas". +- `references/publishing.md`: linha do modo sessão (`click_through`, `dismiss_tips`, `browser_error_text`), regra "Avisos de + novidade do site", evidência. +- `SKILL.md`: versão e resumo de armadilhas. +- Evidência: `pnpm test:publisher` → 76 passed (reexecutado); funções, usos em `tiktok_studio.py`, testes e captura + `20261117-134508` conferidos. Não verificado: envio real depois da correção (falta reiniciar o `pnpm dev`); a imagem + não foi aberta (o aviso é o descrito por quem chamou). + +## 1.38.0 — 17/11/2026 + +Primeiro post real no TikTok (modo sessão), link do vídeo e ação "Já saiu: informar o link". +- `references/publishing.md`: regra do link do TikTok (`find_video_url`, `caption_key`), ação `mark-published` + (`parseVideoUrl`, `markPublished`, rota, UI), registro do primeiro envio real, evidência; nota do `tick` no despachante; + removida a frase "nenhuma rede teve envio real" (TikTok validado; YouTube/Instagram em sessão seguem sem validação). +- `references/gotchas.md`: itens 140 (publicou sem confirmar o link) e 141 (`tick` do despachante preso no HMR). +- `SKILL.md`: versão, `description` e resumo de armadilhas. +- Evidência: `pnpm test:publisher` → 74 passed (reexecutado); `find_video_url`, `parseVideoUrl`, `markPublished`, rota, + UI e bloco do `tick` conferidos no código. Informados e não reexecutados: `test:panel` 65/65, typecheck, validação ao + vivo da lista, o post real. Pendente: reiniciar o `pnpm dev` para valer `find_video_url` e `is_local`. + +## 1.37.0 — 17/11/2026 + +Modo sessão do Publicador: envio de arquivo > 50 MB (cortes de 100–108 MB) falhava no TikTok. +- `references/gotchas.md`: item 139 (sintoma, causa `connect_over_cdp` tratado como remoto, correção `is_local=True` em + `runner.py` e `browser.py`, mensagem genérica "navegador travou", reinício do `pnpm dev`); nota "Relacionadas". +- `references/publishing.md`: linha do modo sessão (`is_local`, mensagem genérica) e evidência. +- `SKILL.md`: versão e resumo de armadilhas. +- Evidência: `pnpm test:publisher` → 73 passed (reexecutado); `is_local` conferido nos dois arquivos e na assinatura do + playwright 1.65.2. Não verificado: envio real (falta reiniciar o `pnpm dev`); captura PNG existe, mas não foi aberta. + +## 1.36.1 — 17/11/2026 + +Correção: migração do banco do painel agora se aplica sozinha no HMR (`checkedThisModule` em `panel/src/lib/db.ts`). +- `references/gotchas.md`: item 138 reescrito (migra na 1ª requisição depois da recarga; sintoma só se o `db.ts` não + recarregou; remédio: qualquer requisição ou reiniciar); item 51 e nota "Relacionadas" ajustados. +- `references/panel.md` e `references/publishing.md`: removida a afirmação de que só reiniciar migra. +- `SKILL.md`: versão e resumo de armadilhas. +- Evidência (informada, 17/11/2026): `GET /api/publishing/summary` levou o banco real a `user_version` 7 com backup + `cenaforge-v6-2026-11-17T16-28-39-725Z.db`; typecheck verde, `test:panel` 63/63. Código de `db()` conferido; testes não reexecutados. + +## 1.36.0 — 17/11/2026 + +Clipador: botão "Publicar" nos cortes aprovados (publicação manual sem fonte ligada) e banco v7 (`publish_jobs.origin`). +- `references/publishing.md`: linhas "Onde mexer" (UI, rota, `publishClip`) e do banco (v7); regras do botão e de + `origin` (`manual` não é cancelado por fonte desligada); evidência (63/63, informada). +- `references/gotchas.md`: item 138 ("no such column: origin" até reiniciar o `pnpm dev`); nota "Relacionadas" até v7. +- `references/panel.md`: esquema v7. `references/clipper.md`: ponteiro na regra "Aprovar publica". +- `SKILL.md`: versão, esquema v7, linha de publicação, `description` e resumo de armadilhas. +- Não verificado: testes e typecheck não reexecutados aqui (vêm do relato); sem conta real; `doc/publicacao/PLANO.md` §7c não lido. + +## 1.35.0 — 17/11/2026 + +Modo sessão do Publicador com Chrome 157: `owns_port` deixou de depender só do `DevToolsActivePort`. +- `references/gotchas.md`: item 137 (sintoma, causa, marca `CenaForgeWindow.json` + `listener_pid`, aviso de janela já + aberta com o perfil, reiniciar `pnpm dev`); nota nas "Relacionadas". +- `references/publishing.md`: linha do modo sessão cita a marca; evidência registra 73 passed (informado). +- `SKILL.md`: versão e resumo de armadilhas. +- Não verificado: `pnpm test:publisher` não reexecutado aqui; teste ao vivo e 73 passed vêm do relato; versão do Chrome não conferida. + +## 1.34.0 — 17/11/2026 + +Economia de tokens do juiz do Clipador (`clipper/app/judge.py`): `codex_lean_overrides` e `--setting-sources` no Claude. +- `references/token-economy.md`: subseção "Juiz do Clipador" com medições (Codex ~77 mil → ~35 mil caracteres fixos; + Claude 3,7 → 2,6 mil tokens, 5,5 → 2,8 s) e propostas não implementadas (pré-filtro, juntar analista+editor). +- `references/clipper.md`: bullet de custo fixo na seção Juízes. +- `references/gotchas.md`: item 136 (cota esgotada pelo juiz; vale só após reiniciar o Clipador). +- Não verificado: resposta do modelo Codex com a configuração enxuta (cota esgotada na medição). + +## 1.33.0 — 17/11/2026 + +Economia de tokens dos agentes do painel: flags enxutas do Claude CLI, teto de gasto, overrides do Codex e dois scripts +novos (`frame_check.py`, `check_script.py`). +- `references/token-economy.md`: scripts novos na tabela; regras duras (uma imagem por render, pesquisa curta, resume + caro); seção "Custo fixo dos agentes do painel" com as medições (62,4 → 14,9 mil tokens, 8,0 → 4,3 s; #6, #7, #8). +- `references/gotchas.md`: novos 133 (OAuth expirado em `~/.claude`), 134 (execução cara: causas e correções), + 135 (`-c mcp_servers={}` não desliga; `collaboration` fica). +- `SKILL.md`: lista de scripts e resumo de armadilhas (133–135); versão. +- Não verificado: reexecução do `tsc`/testes do painel (informado como passou); `frame_check.py` conferido só por `--help`. + +## 1.32.0 — 17/11/2026 + +Cenas 3D com personagens: kits `godot/kits/` (`person.gd`, `boat.gd`), ilha com noite e uso como cenário +(`embedded`), cena nova `castaways` (náufragos da Ilha das Cobras), `SCENE_SCRIPT_INVALID` no `doc_main.gd`. Montagem +"Tudo em 3D" com cartão de foto e cartões de informação em sequência; `POST /api/stories`. Fluxo provado de ponta a +ponta (história → cena → MP4 de 101,7 s). +- `SKILL.md`: `description` cita náufragos, kits, cena dentro de outra, "Tudo em 3D", cartão de foto, `POST + /api/stories` e agente parado (limite/reinício); bloco do documentário lista `island` e `castaways`, tempo de prévia + e `SCENE_SCRIPT_INVALID`; "Onde mexer" ganha kits/`embedded` e `planShot3d`/cartão; resumo de armadilhas cita 131–132. +- `references/panel.md`: banco real em v6 (conferido); `style`, `inset`/`InsetCard`, textos `; depois:`; `planShot3d`; + `applyInternetImage(..., "inset")` sem repetir fotos entre principais e cartões; `regenerateShot(..., target)` e rota + `{index, target?}`; cartão no FFmpeg (62%, borda 12 px, 21%, fades) e fonte menor > 26 caracteres; ilha (`night`, + `variant` só câmera, `embedded`/`environment`/`sea_detail`, métodos públicos); `castaways` e kits; `POST /api/stories`; + evidência de ponta a ponta. +- `references/gotchas.md`: novos 129 (template que não compila: laço infinito → `SCENE_SCRIPT_INVALID`), 130 ("shadows + a native class"), 131 (reiniciar o painel mata o agente), 132 (limite de uso → outro provedor); item 9 ampliado; + item 125 cita a mensagem e que só parte das rotas usa `readJson`. +- `references/tools.md`: Godot cita `castaways`/kits; tempos medidos do `castaways` (prévia 5,8–15,6 s, 65 execuções; + finais 9,8–89,7 s); candidata nova "`.glb` por `GLTFDocument`" (só documentado, sem teste). + +## 1.31.0 — 17/11/2026 + +Correções das revisões de segurança e correção da publicação automática: migração v6 do painel, guarda da API +(`panel/src/proxy.ts`), idempotência por `clientRef`, `mayBeLive`, reencaixe de agendados vencidos, `unlinked`, e +endurecimento do Publicador (pastas permitidas, janela do navegador, ACL, capturas, PKCE em memória, loggers). +- `SKILL.md`: `description` cita "Confira na rede" e chamada da API do painel por script; esquema v6; invariante nova + da API do painel (`Origin` + JSON, gotchas 125). +- `references/publishing.md`: "Onde mexer" com `paths.py` (`output/`/`stories/`/`assets/`, `data/` recusado), `acl.py`, + `db.py` v2 (`client_ref`), `browser.py` (`DevToolsActivePort`, fechamento), `step_pause`/`fill_text`, funções novas + das regras (`needsReflow`, `clientRefFor`, `mayBeLive`), banco v6 e linha "Guarda da API do painel"; regras novas + (idempotência, `confirm: true`, reencaixe > 30 min, `unlinked`/`linked_at`, cancelar no ciclo, rótulo de IA por + cautela, janela do modo sessão, capturas, segurança do Publicador); evidência 71 passed / 59/59 e bancos reais + (painel ainda v5, Publicador v2). +- `references/gotchas.md`: itens 118 (`mayBeLive`/409), 119 (401/403/404 e timeout ficam na fila), 121 (`unlinked`), + 122 (religar zera `linked_at`) ampliados; novos 125 (API do painel 403/415 a curl), 126 (reencaixe do agendado), + 127 (OAuth: Publicador reiniciado / espera de 10 min), 128 (janela do modo sessão fecha sozinha). +- `references/panel.md`: banco v6 e guarda da API (`proxy.ts`, `readJson`). +- `references/tools.md`: evidência do Publicador 71 passed (versões reconferidas, sem mudança). + +## 1.30.0 — 17/11/2026 + +Publicação automática em YouTube, TikTok e Instagram: serviço Publicador (`publisher/`, 4530), despachante do painel +(laço de 20 s em `instrumentation.ts`), migração v5, telas "Canais de publicação", "Publicações" e "Configurações"; +"Canais" do Clipador viram "Fontes" na UI. Tira da skill o "publicação é a próxima fase / nada fala com as redes". +- `references/publishing.md` (novo): papéis painel × Publicador × Clipador, subida/instalação/testes, tabela "onde + mexer" (serviço, uploaders, seletores `SELECTORS`, `publishing-rules.ts`, rotas, telas, `Dialog`/`Steps`, + `NoticeBar`/`PublishChips`, `actions[]`), regras (nunca `published` sem link, aprovar = vídeo inteiro, + `auto_since`, episódio sempre manual, limite diário em "Na hora", `publishAt` não usado, modo sessão com "Entendi o + risco"), resumo dos fatos das plataformas apontando para `doc/publicacao/PESQUISA.md`, evidência e lacunas. +- `SKILL.md`: `description` cita publicação; docs de `doc/publicacao/` e `publisher/README.md`; esquema v5; linha do + Publicador e portas 4530 e 4540–4549; "Onde mexer" ganha publicação, passo 6b2 do setup e `Dialog`; invariante "fora + do escopo: publicação real" trocada por regras de publicação; `pnpm test:publisher`; seção de voz compactada. +- `panel.md`: banco v5 e `test:panel`; "Contas e dashboard" → "Canais de publicação e dashboard" (sem `mock`; métricas + simuladas, `publications` real com `simulated = 0`; card "Fontes de corte"). +- `clipper.md`: linha "Fontes" e linha nova "Publicação dos cortes" (`GET /v1/clips` com `channel=`/`ids=`); regra + "Aprovar só marca o corte" substituída. +- `gotchas.md`: seção nova "Publicação", itens 118–124 (terminou sem link, job esperando/409, `expired`, jobs + cancelados ao exportar, automática não pega cortes antigos, "Na hora" agendado, TikTok só "Somente eu"); item 51 + cita v5. +- `tools.md`: seção do Publicador com versões do `publisher/.venv` (Python 3.12.13, FastAPI 0.159.1, uvicorn 0.54.0, + pydantic 2.14.1, httpx 0.28.1, playwright 1.65.2, pytest 9.1.1) e 55 passed; candidata "publicação próxima fase" + trocada por APIs oficiais e modo sessão "código pronto, sem envio real". + +## 1.29.1 — 17/11/2026 + +Correção: a limpeza da fila antes do render (`discard_pending_duplicates`) agora usa o mesmo veto do juiz. +- `clipper.md`: "Duplicados" diz que saem da fila os pendentes iguais a um corte pronto, aprovado, publicado, + rejeitado, apagado num desses estados ou a um pendente mais antigo (antes dizia que não comparava com rejeitados); + "Apagar cortes" cita a limpeza da fila; evidência 270 passed (medido; informado 269) com o teste novo. +- `tools.md`: evidência do Clipador 270 passed. + +## 1.29.0 — 17/11/2026 + +Clipador: apagar cortes (um, lote ou aba inteira; o momento apagado não volta), veto do rejeitado depois do juiz e +varredura que conta propostas. Painel: "Apagar" e seleção discreta na fila, relógio da gravação e cadência do resumo +no cartão da sessão, prévia do editor igual ao render na legenda e no recorte. (A 1.28.0 é de outra sessão, publicada +em paralelo.) +- `SKILL.md`: `description` cita apagar corte, rejeitado/apagado que não volta, relógio e cadência, prévia igual ao + render e "não sai corte"; linha do Clipador em "Onde mexer" cita `clip_delete.py`/`deleted_clips` e `METHODS`. +- `clipper.md`: banco v10 (`deleted_clips`); linha nova "Apagar cortes" em "Onde mexer"; `KEPT_STATUSES`/ + `VETO_STATUSES`; seção nova "Apagar cortes" (rotas, recusas, o que some, marca, `METHODS`, ids mostrados); + duplicados reescritos (rejeitado e apagado vetam; descartado não; `discard_pending_duplicates` não olha rejeitado); + varredura grava `proposals`/`created`; editor: porte da legenda e `ffmpegCropFill` com regra de mudar junto; + linha da página `/clipper` cita `SelectionPill`, `RecordingClock`, `SummaryCadence`; evidência (268 passed, + `tsc` exit 0, banco real em v10) e lacunas. +- `panel.md`: aba Sessões ganha relógio (`CLOCK_TICK_MS` 250, `CLOCK_MAX_AHEAD_S` 45) e cadência (`scanIntervalS` de + `/status`); fila ganha "Apagar" e seleção discreta; `METHODS` na regra de rota nova; prévia do editor deixa de ser + "aproximada" na legenda e no recorte; evidência. +- `gotchas.md`: itens 114 ("não sai corte" = live fria), 115 (resumo "travado"), 116 (barra de seleção reprovada), + 117 (prévia 1–3 px deslocada / legenda diferente). +- `tools.md`: evidência do Clipador 268 passed. + +## 1.28.0 — 17/11/2026 + +Biblioteca de cenas 3D na Godot (`kind: "doc3d"`, `godot/library//`, primeira: `island`) e montagem documental com +fotos reais do Wikimedia Commons, "Gerar de novo" por trecho e "Refazer tudo do zero". Tira o aviso "doc3d em +desenvolvimento". +- `SKILL.md`: `description` cita a biblioteca 3D, criar cena nova (`doc/godot/cenas.md`, tarefa "Cena no Godot"), fotos + do Commons, "Gerar de novo" e "Refazer tudo do zero"; parágrafo "Cenas do documentário" reescrito (`doc2d`/`doc3d`, + `variant`, erro de cena inexistente, tempos); "Onde mexer" ganha a linha da cena 3D (`template.gd` + `manifest.json`) + e cita `scene-library.ts`/`image-search.ts`; "Validação" aponta o checklist do guia; seções de voz, tokens e + armadilhas compactadas. +- `panel.md`: "Montagem documental" reescrita — `VISUAL_KINDS` com rótulos, `ShotVisual.search`/`auto`, pergunta da + tela antes da fala, licença opcional, `SceneEditor` 3D pelo manifesto; subseções novas "Plano do trecho" + (`scriptEntities`, ordem do `planShot`, modelos 2D com `variant`), "Fotos da internet" e "Biblioteca de cenas 3D"; + "Gerar o MP4" com `replan`, `regenerateShot` e foto com fundo desfocado; rota `.../montage/regenerate`; tarefa + `godot` do agente e `?prompt=`; evidência (13 prévias da ilha, final 3D, erro de cena inexistente, MP4 88,33 s). +- `gotchas.md`: 110 vale para `doc3d`; 44 ampliado (`node -e` quebrou o build do painel); novos 111 (espuma por + elipse no shader do mar) e 112 (Next dev roda o módulo antigo na 1ª montagem pós-edição). +- `tools.md`: Godot também monta a biblioteca 3D (ACES na ilha), tempos medidos da `island`; FFmpeg com `boxblur`; + API do Wikimedia Commons em uso. + +## 1.27.0 — 17/11/2026 + +Cenas 2D do documentário na Godot (`kind: "doc2d"`: título, contador, mapa do litoral de SP) e vídeo documental +automático num clique no painel. Corrige a skill onde dizia que "Animação 2D (Godot)" não existia e que o documental +saía só pelo FFmpeg, sem Godot. +- `SKILL.md`: `description` cita cena 2D e "Gerar vídeo automático"; parágrafo do `doc2d` no Pipeline (contrato, + comando de prévia, tempos); "Várias histórias" e "Voz e legenda" atualizados; "Onde mexer" ganha a linha da cena + 2D (`godot/scripts/doc/`: `doc_config.gd`, `doc2d_canvas.gd`, `doc_main.gd`; cena `doc.tscn`; `MAP_PLACES` = + `PRESETS.places`) e cita o ramo `doc2d` do `render.ts`; `doc3d` marcado como em desenvolvimento e o `montage-godot.ts`; "Validação": quadros de inspeção pulados em cena curta. Seção de voz + compactada (detalhes já em `voice/README.md`). +- `panel.md`: "Montagem documental" reescrita — `godot2d` disponível (`scene`/`sceneKey`), botão "Gerar vídeo + automático" + modo manual ("Só montar"), `SceneEditor` e "Prévia da cena", config em + `stories//godot/-tNN.json`; subseções "Cena 2D: plano e render" (`planScene` por regras, + `MAP_PLACES`, `renderGodotScene`) e "Gerar o MP4" (`startMontageRender(id, { auto })`, `montageJob`); `godot2d` sem + texto na tela; rotas `.../montage/scene` e `{auto}`, GET com `templates` e `job`; evidência e lacunas. +- `gotchas.md`: item 110 (checagens da rua reprovavam a cena 2D: luma ≈ 13 < 20 e sem moto). +- `tools.md`: Godot também desenha as cenas 2D (`doc.tscn` + `doc2d_canvas.gd`, SystemFont), reconferida 4.7.2 em 17/11/2026; tempos + medidos do `doc2d`. + +## 1.26.0 — 17/11/2026 + +Clipador: duração mínima garantida, gancho em tarja animada, fontes empacotadas, reenquadramento do jogo com keyframes, +camadas inseridas e qualidade de gravação configurável (até 2K). Painel: editor com Programa 16:9, trilhas ENQ/INS, +câmera editável na Fonte e prévia de texto pelas métricas da fonte. +- `SKILL.md`: `description` cita mínimo garantido, qualidade de gravação, tarja, fontes, reenquadramento, camadas e + câmera editável na Fonte; linha do Clipador em "Onde mexer" cita `capture.py`, `fit_window`, `assets/fonts/` e + `reframe.py`. +- `clipper.md`: banco v9 (`sessions.capture_json`); linha das fontes empacotadas; "Onde mexer" ganha qualidade de + gravação, busca em `.ts`/emenda de resolução e reenquadramento/camadas, e cita `fit_window`, `min_target`, grupos + `hook`/`capture`, `ass_filter` e as chaves novas das rotas de settings; "Configuração do corte" reescreve a duração + (≥ `minS` + 1 s em todo corte automático) e ganha `hook`, fontes e `capture.quality`; seção nova "Qualidade de + gravação"; editor: sai "Programa sempre 9:16", campos `style`/`bg`/`color`/`font`/`anim`, `inset` e `reframe`, + limite de 0,48 da largura, custo medido, a IA não propõe reframe/camadas; regra de aplicar por edição pontual; + evidência (251 passed) e lacunas. +- `panel.md`: modal do corte em 5 abas (Gancho, "Qualidade da gravação"); cartão da sessão "gravando em"; editor: + trilhas INS/ENQ, Programa por `frames`, fontes por `FontFace`, keyframes, câmera na Fonte, arquivos novos + (`clip-editor-fonts.tsx`, `clip-editor-keyframes.tsx`, `clip-editor-source.tsx`, `rect-geometry.ts`), atalhos `[`/`]` + e Ctrl+C/V; gestos da Fonte sem os botões antigos; evidência. +- `gotchas.md`: itens novos 103 (corte automático curto), 104 (`\blur` com contorno), 105 (`fontsdir` e nome da + família), 106 (`crop` × `perspective` `eval=frame`, `in` começa em 1), 107 (busca em `.ts`, HEVC cinza), 108 (emenda + de resolução na retomada), 109 (updater do `setState` puro); 86 ampliado (CDP: `Fetch` antes de navegar, Ctrl+Z + como `keyDown`); 87 ampliado (aplicar por edição pontual com agentes em paralelo). +- `tools.md`: evidência do Clipador 251 passed; Streamlink e FFmpeg reconferidos (8.6.3 / 7.1.1) com os usos novos; + linha das fontes empacotadas (commit do google/fonts + licenças). + +## 1.25.0 — 17/11/2026 + +Painel: modal de confirmação/aviso global no lugar de `window.confirm`/`window.alert`. +- `SKILL.md`: linha nova em "Onde mexer" (`askConfirm`/`showAlert`/`confirmSubmit` de + `components/confirm-dialog.tsx`; proibidos `confirm()`/`alert()` nativos). +- `panel.md`: seção nova "Confirmação e aviso" (API, `confirmSubmit` com `requestSubmit` + `data-confirmed="1"`, + `tone: "danger"`, `` único em `app/layout.tsx` com fila e `` nativo, `Button` com + `ComponentProps<"button">`/`ref`); "Excluir história" deixa de citar `window.confirm` (agora `confirmSubmit` + + `showAlert`); evidência. + +## 1.24.0 — 17/11/2026 + +Painel: montagem documental (áudio e visual por trecho → MP4 pelo FFmpeg). Substitui o aviso "a montagem +documental não existe". +- `SKILL.md`: `description` cita a montagem documental; "Várias histórias" diz que o documental vira MP4 pela + montagem do painel; "Onde mexer" ganha a linha da montagem (`montage.ts`, `montage-ffmpeg.ts`, `speech-text.ts`, + `montage-editor.tsx`, rotas `.../montage/`); "Voz e legenda": só o render da Godot não chama o serviço. +- `panel.md`: seção nova "Montagem documental" (trecho = linha "t (s)", áudio por parágrafo, texto falado por + extenso, `VISUAL_KINDS`, upload com licença, `.montage.json`, `audioKey`, `startMontageRender`/`profile = + 'documentary'`, parâmetros do FFmpeg, rotas, `/api/files` com .webm/.mov/.mkv); evidência e lacunas. +- `gotchas.md`: item 52 ampliado (tsx pela raiz, `f:/` não é URL); itens novos 99 (importar `db.ts` marca execuções + como `interrupted`), 100 (`fileUrl()` + `&v=`), 101 (markdown no texto na tela), 102 (duração real da fala × + tempo da tabela). +- `tools.md`: FFmpeg também usado pela montagem documental (7.1.1 reconferido). + +## 1.23.0 — 17/11/2026 + +Painel: leitor de roteiro. +- `SKILL.md`: `description` cita o leitor de roteiro e que a montagem documental em MP4 não existe; "Várias + histórias" avisa que o documental ainda não vira MP4; "Onde mexer" ganha a linha do leitor (`script-doc.ts`, + `script-reader.tsx`, página `.../roteiro`). +- `panel.md`: seção "Leitor de roteiro" (`parseScript`, papéis das seções, tabela "t (s)", `WORDS_PER_SECOND` 2,5, + alertas 1,1×/1,15×, markdown sem HTML cru, páginas que usam, episódio documental sem "Montar cena"); evidência. + +## 1.22.0 — 17/11/2026 + +Painel: mensagem ao agente durante a execução, termos episódio × vídeo e leitura UTF-8 no Codex. +- `SKILL.md`: `description` cita correção/mensagem durante a execução e termos episódio × vídeo; "Onde mexer" — + linha de agentes cita `sendFollowUp` e `agent-console.tsx`; formato novo inclui `unitTerms`. +- `panel.md`: seção "Mensagem com o agente rodando" ("Corrigir agora"/"Enviar ao terminar", rota + `POST /api/agent/runs/[id]/messages`, `ActiveRun.emit/followUp/progressed`, continuação antes do "end" com + `followUpRunId`, só no fim ao vivo); "Formatos de história" ganha `unitTerms` e o episódio sem título no + documental; nota do `Get-Content -Encoding UTF8`; evidência e lacunas. +- `gotchas.md`: item 97 (Codex retomado cedo demais esquece o pedido — medido no 0.169) e item 98 (PowerShell 5.1 + lê UTF-8 sem BOM como ANSI → "história"). + +## 1.21.0 — 17/11/2026 + +Regras de roteiro numa fonte única (`doc/roteiro/`) e exclusão de história no painel. +- `SKILL.md`: `description` cita `doc/roteiro/` e excluir história; "Várias histórias" aponta as regras de roteiro + para `doc/roteiro/` (sai "restrições do `cenaforge-story-writer`") e cita a 1ª linha `Formato:` da `biblia.md`; + "Onde mexer" ganha a linha "Regra de roteiro" (editar os .md, não o código), a linha do painel cita + `deleteStory`/`stories.ts`, e formato novo usa `GUIDE_BY_KIND`/`FORMAT_LABEL` no lugar de "regras no prompt"; + "Economia de tokens": subagente segue `doc/roteiro/`, sem busca na web ("a confirmar"). +- `panel.md`: "Formatos de história" resume os três guias (sai `DOCUMENTARY_RULES`/`DOCUMENTARY_SCRIPT_FORMAT` e o + detalhe do documental duplicado); "Agentes e modelos" descreve `writingRules(provider, kind)`; seção nova + "Excluir história" (recusas, `data/trash/-/`, transação, CASCADE/SET NULL, sem exclusão de asset + da biblioteca); evidência e lacunas. +- `gotchas.md`: item 96 aponta para `doc/roteiro/` e `writingRules` (saem `fictionRules`/`DOCUMENTARY_RULES`). + +## 1.20.0 — 17/11/2026 + +Painel: formato de história documental, prompt sensível ao agente e lista de modelos dinâmica. +- `SKILL.md`: `description` cita histórias lineares/documentais e escolha de agente/modelo; esquema do banco v4; + formatos `interactive`/`linear`/`documentary` em "Várias histórias"; "Onde mexer" — formato novo exige também + migração do CHECK (`db.ts`), regras em `prompts.ts` e layout do Fluxo; linha de agentes cita `prompts.ts`, + `models()` e `AGENTS.md`. +- `panel.md`: banco v4 (reconstrói `stories` para o CHECK aceitar `documentary`) e migração só ao reiniciar o + `pnpm panel`; novas seções "Formatos de história" (tabela dos três `kind`, ficha de pauta e roteiro do documental, + `DOCUMENTARY_RULES`/`DOCUMENTARY_SCRIPT_FORMAT`) e "Agentes e modelos" (`buildPrompt` por `provider`, `models()`: + Codex por `models_cache.json`/`config.toml`, Claude com ids `claude-*`, `DEFAULT_MODEL` = `claude-sonnet-5-5` em + scene/branches, seletor no "Nova história com IA"); linha "Gerar vertentes" sem o modelo `sonnet` fixo; evidência. +- `gotchas.md`: item 29 com os filtros novos de stderr (Codex "unrecognized configuration setting", Claude + `unrecognized_model`); item 51 generalizado (cache em `globalThis.__cenaforgeDb`, v4); item 96 novo (Codex + aplicando as restrições de ficção a pedido documental). +- `tools.md`: linhas do Codex CLI e do Claude Code CLI citam a escolha de modelo; versões reconferidas (0.169.0 / + 2.1.314). + +## 1.19.0 — 17/11/2026 + +Rastreio de reação testado ao vivo (instância isolada na 4521; `doc/FACE_BAKEOFF.md`, "Testes de 17/11 — ao vivo"). +- `clipper.md`: `locate_cam` com `ReactionParams.min_cam_score` 0,7; sem linha "Rosto do streamer" com o plano B + OpenSeeFace (`FaceService.summary`); receita da instância de teste isolada (`CLIPPER_DATA_DIR`/`CLIPPER_OUTPUT_DIR` + dentro do repo, `sqlite_sequence` de `sessions` em 90000); evidência nova (download real, OSF × MediaPipe, serviço + real com 25 blocos, lofigirl, painel; pytest 170 passed e tsc do painel conferidos); "Não verificado" do rastreio + trocado (download, plano B, serviço real e painel saem; entram câmera cheia/escura/minúscula, GPU, live > 15 min, + linha do rosto no juiz ao vivo, interruptor real). +- `gotchas.md`: itens 92 (câmera falsa em live sem câmera), 93 (chave da voz colidindo em banco de teste novo), + 94 (analista lendo "sem reação" com o plano B) e 95 (WARNING de pesquisa a cada 30 s com juiz `off`). +- `tools.md`: evidência do serviço real ao vivo; números ao vivo do MediaPipe; OpenSeeFace deixa de ser "não testado" + (medido com os pesos reais); piso 0,7 citado no YuNet. + +## 1.18.0 — 17/11/2026 + +Clipador: formato horizontal, durações novas, legenda com fala rápida, retomada de live, render que falha e cortes +duplicados; modal do corte em abas e aba Sessões refeita no painel. +- `clipper.md`: corte vertical ou horizontal; banco em `user_version` 8 (`clips.aspect`); "Onde mexer" ganha a linha de + retomada/render/duplicados (`worker.py`, `test_resume.py`, `test_render_and_duplicates.py`), cita `DEFAULTS`/`merge`/ + `validate`, `ASPECTS`/`FRAME_SIZES`/`CANVAS_SIZES`, `resolved_mode` = `full`, `aspects`/`frames` das rotas de settings, + o SHA de referência do vertical e `Aspect`/`aspectOf`/`withFormat`; a linha da legenda deixa de ser "caminho antigo" + (`clean_words`/`group_words`/`caption_blocks`, usada pelo worker e pelo editor). Analista com 6 ou 8 frames; + `backtrackS` padrão 120 s; `duration` corrigido (padrão 60/90/120; `minS` 5–120). Nova seção "Retomada, render que + falha e cortes duplicados" (com `POST /v1/sessions/{id}/resume`). Editor: `settings.format` por corte, Programa ainda + em 9:16; `cover.atStart` agora também na `preview-render` com `fromS` = 0 (sai o "só no export"). Regra de reiniciar + só com a suíte verde; nota do `FakeJudge.ask`; evidência (170 passed medido) e lacunas novas. +- `gotchas.md`: itens 87 (reinício com código intermediário → cortes presos em `rendering`), 88 (retomada que checava + uma vez só), 89 (juiz recua o corte → duplicados), 90 (legenda empilhada com fala rápida) e 91 + (`[contain:inline-size]`); item 77 ganha "a cópia herda sessões" e a 4521 de outra sessão; item 86 ganha + `requestStage: "Response"`; item 69 cita os 8 frames. +- `panel.md`: modal em quatro abas, `clipper-client.ts` (`Aspect`, `withFormat`), fila em 16:9, cartão da aba Sessões + (`sessionHealth`, altura fixa, "Retomar gravação"). +- `tools.md`: evidência do Clipador → 170 passed; FFmpeg faz render vertical e horizontal (NVENC horizontal não testado). +- `SKILL.md`: `description` e linha do Clipador em "Onde mexer" citam formato, duração, retomada e duplicados. + +## 1.17.0 — 16/11/2026 + +Redesenho do editor de cortes do Clipador (padrão de editor de vídeo) e camadas novas do projeto de edição. +- `clipper.md`: modo `cam_only` (`MODES`, `resolved_mode`, queda para `blur`); "Onde mexer" cita `normalize_cuts`, + `pick_hook`, `chat_events`, `build_filter`/`build_project_ass`, `chat_for`, `clipper/tests/test_editor_layers.py`, + os tipos espelhados no painel e os tokens `--color-nle-*`; regra do gancho por `pick_hook`; tabela dos campos + `cuts[].mode`, `cuts[].muted`, `overlays[].x`, `chat` e `cover.atStart` (só no export) com limites; ponteiro para + "Mexer com a mão" do README; limites (uma trilha de vídeo, sem B-roll); evidência (136 passed, teste de UI por + CDP informado) e lacunas refeitas. +- `panel.md`: seção "Editor de cortes" reescrita — desenho NLE, disposição com Camadas e monitor "Fonte · Programa", + trilhas C1/V3/V2/CAM/V1/A1/A2/A3/CH, modais no lugar das abas do inspetor, tabela de papel por arquivo (novos + `clip-editor-ui.tsx` e `clip-editor-layers.tsx`), gestos, "Salvar projeto", atalhos atuais (Ctrl+K, Ctrl+Shift+clique, + Ctrl+E, V/C/N, Home/End, ?). Sai a disposição antiga (inspetor em abas). +- `gotchas.md`: item 44 cita escapes como `\b`; item 73 cita o serviço antigo recusando `cam_only`; item 76 passa a + apontar para `pick_hook` (tempo da gravação no gancho); novos itens 85 (camadas do canvas achadas pelo cursor) e + 86 (interceptar escritas em teste de UI sobre corte real). +- `tools.md`: evidência do Clipador → 136 passed. +- `SKILL.md`: `description` cita o editor no padrão de editor de vídeo e as camadas novas. + +## 1.16.0 — 16/11/2026 + +Rastreio de reação do Clipador (câmera achada sem IA + expressões do rosto do streamer). +- `clipper.md`: pasta `data/clipper/models/` + `clipper/models.lock.json`; "Onde mexer" ganha `face.py`/`_face_loop`/ + `face_bench.py` e `reaction.py` (`ReactionParams`), e cita `_face_moments`/`face_*` em `scoring.py`, `detect_cam` + local primeiro e `CAM_RETRY_S` em `intel.py`, a linha "Rosto do streamer" do analista e os componentes do painel + (`FaceSignal`, interruptor, selo da câmera); fonte de corte `face`; `faceTrack` no `PUT /v1/judge`; `detect-cam` + com YuNet, `?ai=true` e `cam_json.source`; timeout de 30 s de `face(/reset)`; nova seção "Rastreio de reação" + (stack e licenças, fluxo, sinal, regras de corte, modelos, rotas, bancada); evidência da bancada e lacunas; sai a + nota dos 2 testes de rosto instáveis (120 passed em 2 execuções). +- `tools.md`: tabela do rastreio (mediapipe 1.2.3, opencv-contrib-python 5.0.0.93, numpy 2.5.5, onnxruntime 1.32.0, + pesos e licenças) e descartados por licença; evidência do Clipador → 120 passed. +- `gotchas.md`: itens 79 (import do MediaPipe 1.2.3), 80 (`opencv-python-headless` junto), 81 (jawOpen/eyeWide não + sobem; risada pelo sorriso), 82 (agrupar pelo centro do grupo), 83 ("sustos" do rastreio perdendo o rosto) e 84 + (neutro sorridente sem pico). +- `SKILL.md`: `description` e linha do Clipador em "Onde mexer" citam o rastreio de reação e o `models.lock.json`. + +## 1.15.0 — 16/11/2026 + +Chat com a IA por seção no perfil do jogo (aba Jogos do Clipador). +- `clipper.md`: `POST /v1/games/{id}/refine` documenta `section` (`Literal`, 422 se inválido), `history` (máx. 20; + IA vê 8 turnos de 400 caracteres) e a resposta `{games, reply}`; `notes[].section?`; `REFINE_SCHEMA`, + `PROFILE_SECTIONS`, nova assinatura de `refine_game` e `Intel.refine` → `(profile, reply)`; painel com chat por + seção (padrão de "Confirmar na web" difere da API); evidência com IA simulada e lacuna da IA real. +- `panel.md`: redesenho do card do jogo em `clipper-games.tsx` (selo de iniciais, cartões por seção, `AiChat`, + selo "novo", chips de gírias, Fontes/Memória recolhidas). + +## 1.14.0 — 16/11/2026 + +Editor de cortes do Clipador (`/clipper/edit/`) e render único pelo projeto de edição. +- `clipper.md`: banco detalha v4 `edits` e v7 `origin`/`ai_project_json` + regra "nunca alterar migração aplicada"; + pasta `edit-/` (proxy, TTS); "Onde mexer" ganha `editor.py`, `editor_render.py`, `editor_api.py`, + `layout_chain` e a página do editor, e marca `media.render_vertical` como fora do render de cortes; timeout de + 5 min do proxy; nova seção "Editor de cortes" (caminho do render, projeto da IA, origem/rejudge, tempo, validação, + rotas) apontando para o README e `doc/clip-editor-research.md`; evidência e lacunas do editor. +- `panel.md`: seção "Editor de cortes" (tela cheia sem mudar o layout raiz, disposição, componentes `clip-editor*`, + autosave com `rev`, atalhos) e botão "Editar"/"Continuar edição" em `clipper-queue.tsx`. +- `gotchas.md`: item 57 aponta para `editor_render.py`; novos itens 74 (palavra de duração zero), 75 (capa vazia + com mjpeg/faixa "tv"; `-g` curto em teste), 76 (gancho longo), 77 (instância de teste sobre cópia do banco: + `keep_hours = 0`, sem monitor/varredura) e 78 (emoji monocromático no libass). +- `SKILL.md`: `description` e linha do Clipador em "Onde mexer" citam o editor de cortes. + +## 1.13.0 — 16/11/2026 + +Perfil do jogo editável no Clipador (aba Jogos). +- `clipper.md`: banco corrigido para `user_version` 7 (v4 `edits`, v5 `face_track`, v6 `games.notes_json`/`edited_at`, + v7 `edits.origin`/`ai_project_json`); "Onde mexer" cita `clean_profile`/`save_profile`/`refine`/`delete_note` e + `REFINE_SYSTEM`/`refine_game`; nova seção "Perfil do jogo" (rotas `PUT /v1/games/{id}`, `POST …/refine`, + `DELETE …/notes/{index}`, campos novos de `GET /v1/games`, pedido guardado × edição à mão); timeout de 8 min do + proxy vale para `research|refine`; evidência e lacunas. +- `panel.md`: `clipper-games.tsx` com Editar, Pedir à IA e pedidos guardados. +- `SKILL.md`: `description` cita o perfil do jogo editável. + +## 1.12.0 — 17/11/2026 + +Fase 2 do Clipador. +- `SKILL.md`: `description` cita emotes, varredura da IA, juízes analista/editor, contexto do jogo, webcam e layout do + corte; linha do Clipador em "Onde mexer" cita o timeout por rota do proxy. +- `clipper.md`: banco v3 (colunas e tabelas `games`/`emotes`); "Onde mexer" com `emotes.py`, `intel.py`, `layout.py`, + `clipper-cut-settings.tsx`, `clipper-games.tsx`; novas seções "Como os momentos nascem" (mínimo proporcional, chat + fraco, varredura, aprendizado dos emotes), "Juízes" (analista + editor, `analystModel`, `backtrackS`, `-i`/`--search` + do Codex) e "Configuração do corte" (camadas, modos, rotas, timeouts do proxy); evidência da fase 2 + (`pnpm test:clipper` → 46 passed) e lacunas (UI nova contra o serviço novo, juiz `claude`). +- `gotchas.md`: item 59 aponta para o mínimo proporcional; novos itens 68 (chat pequeno sem corte), 69 (título preso à + transcrição), 70 (crédito sobre o rosto no `cam_top`), 71 (cor ASS `&H00BBGGRR&` × `&HBBGGRR&`), 72 (download de + emotes fora da thread do chat), 73 (reiniciar o Clipador após código novo). +- `panel.md`: seção da página `/clipper` (modal do corte, aba Jogos e emotes, cartão com análise e recuo do início). +- `tools.md`: evidência do Clipador atualizada (46 passed, sem dependência nova); papel das CLIs nos juízes; APIs + públicas de emotes 7TV/BTTV/FFZ (chamada real não registrada). + +## 1.11.0 — 16/11/2026 + +- `SKILL.md`: + - `description` cita Azure Speech, filtros de voz e clonagem de voz (Chatterbox, com consentimento); + - estrutura e portas: worker de clonagem na 4511 (`voice/.venv-clone`); + - "Onde mexer": arquivos do serviço de voz (`catalog.py`, `config.py`, `errors.py`, `voice/clone/worker.py`) e + do painel (`voice-cards.tsx`, `voice-clone-form.tsx`, `AzureForm`); + - "Voz e legenda" reescrita e enxugada: `setup.bat -Clone`, aba Catálogo com sub-abas, busca e filtros, + catálogo 62 → 76 vozes (14 Azure ocultas sem chave), Azure pelo painel/`voice/.env`, voz clonada + (`kind: "clone"`, consentimento, `503 clone_unavailable`, sem `speed`, marca d'água). Detalhes ficam no `voice/README.md`. +- `tools.md`: evidência `pnpm test:voice` → 133 passed; nova subseção "Clonagem de voz" (Python 3.12.13, + chatterbox-tts 0.1.7, torch/torchaudio 2.6.0+cu124, numpy 1.26.4, transformers 5.2.0, verificados no venv) + com os tempos do teste na GPU; Azure continua em candidatas como "código pronto, sem chave real". +- `gotchas.md`: item 44 ampliado (aspas, gravar o script em arquivo); item 53 cita `azure`/`clone` e o + reinício do worker; novos itens 62 (`w-full` fixo em `Select`/`Input` e `cx()` sem merge), 63 (`.tsx` CRLF), + 64 (Xet travando o download, pesos não fixados), 65 (venv separado), 66 (timeout em fala clonada longa), + 67 (`speed` ignorado e marca d'água PerTh). + +## 1.10.1 — 16/11/2026 + +- `SKILL.md`: logo após "Documentos do projeto", um ponteiro para a skill `content-pipeline` + (metodologia de 8 etapas: o *quê* e o portão de cada etapa). Esta skill continua sendo o *como* + técnico. O conteúdo da `content-pipeline` não foi duplicado. + +## 1.10.0 — 16/11/2026 + +- Novo `references/clipper.md`: Clipador (`clipper/`, 127.0.0.1:4520), banco `data/clipper/clipper.db` + (v2), pastas de blocos e cortes, tabela "Onde mexer", juiz pela CLI sem chave de API (Codex + `gpt-6-luna` padrão, Claude ou off; `PUT /v1/judge`), regras, evidência da live real e lacunas. + O arquivo aponta para `clipper/README.md` em vez de duplicá-lo. +- `SKILL.md`: + - `description` cita o Clipador; + - `clipper/README.md` entra nos documentos de consulta; + - estrutura ganhou a linha do Clipador, portas 4500/4510/4520 e banco do painel v3; + - "Onde mexer" ganhou a linha do Clipador e o passo 6b do setup; + - subida/testes incluem `pnpm test:clipper` e o aviso quando o Clipador não está instalado ou a porta está ocupada; + - a invariante de escopo agora diz que a publicação real em qualquer rede segue fora, que é a próxima fase pedida pelo usuário e que "Aprovar" só marca o corte; + - a seção "Manutenção" foi enxugada. +- `gotchas.md`: + - nova seção "Clipador", itens 57–61: `-ss` antes do `-i` com o filtro `ass`, `.upper()` quebrando a tag `\c`, falsos positivos com o chat calmo, pico escolhido antes do filtro de assentado, e hora do chat por `wall_end`; + - item 28 agora inclui o juiz do Clipador (`codex.js`); + - item 51 cita a migração v3. +- `tools.md`: + - nova seção do Clipador com versões verificadas: Python 3.12.13, FastAPI 0.159.1, uvicorn 0.54.0, httpx 0.28.1, websockets 17.4, Streamlink 8.6.3, pytest 9.1.1 e FFmpeg com libass; + - candidatas novas: publicação dos cortes (próxima fase) e chat do YouTube. +- `panel.md`: banco v3 (`account_channels`) e card/rotas "Canais de live". + +## 1.9.0 — 16/11/2026 + +- "Voz e legenda": catálogo 15 → 62 vozes, motores novos `kokoro` (offline, CPU; feminina pt-BR + offline `kokoro-pf-dora`) e `google` (gTTS, online, só normal/lenta); campos do catálogo + `kokoroVoice`/`kokoroLang`/`googleLang`/`googleTld`; `ONLINE_ENGINES`; rótulo + offline/online nos selects do painel (`voiceOptionLabel()`); regra de URL do lock ampliada + para release versionado no GitHub. `description` cita os quatro motores. +- `tools.md`: kokoro-onnx 0.6.1, phonemizer 3.6.0, espeakng-loader 0.2.4, gTTS 2.5.4; teste das + 54 vozes Kokoro (45 aprovadas) e tempos de síntese; `pnpm test:voice` → 127 passed; candidatas + Azure Speech e SAPI do Windows; vozes famosas do TikTok/CapCut marcadas "não copiar". +- `gotchas.md`: item 53 ampliado (motor novo exige reiniciar); itens 54 (int8 do Kokoro não roda), + 55 (avisos "constant folding" do fp16), 56 (cache do sha256 na recarga do catálogo). + +## 1.8.0 — 16/11/2026 + +- "Voz e legenda": catálogo recarrega sozinho (`_refresh_voices_if_changed` em + `voice/app/main.py`, chamado em `GET /v1/voices`, `GET /v1/voices/{id}` e + `POST /v1/synthesize`); catálogo com defeito mantém as vozes atuais. Substitui a instrução da + 1.6.0 de chamar `POST /v1/voices/reload` após editar o catálogo (a rota segue para forçar). +- `gotchas.md`: item 53 (uvicorn sem `--reload` no `scripts/dev.ts`: código novo exige reiniciar). +- `tools.md`: evidência `pnpm test:voice` → 124 passed. + +## 1.7.0 — 16/11/2026 + +- Novo `references/panel.md`: banco v2 (backup em `data/backups/`, `foreign_key_check`), + árvore de vertentes (`branch_count` 1–4, `file_key`, `status`, `branches_status`), votação A–D, + `prepareBranches` + fila em `onAgentRunClosed`, contas (redes `mock`) e dashboard com métricas + simuladas; evidência e lacunas. +- `SKILL.md`: estrutura com `` e `.choices.json`; limitação do overlay (só A/B); + painel é do usuário; linha "Onde mexer" das vertentes/contas/dashboard; `description` ampliado. +- `tools.md`: `@xyflow/react` 13.0.1. +- `gotchas.md`: itens 48–52 (clique no xyflow, rolagem do canvas, `grid-cols-1`, conexão em + `globalThis`, `.mts` + `file:///`). +- Pedido como 1.6.0, mas essa versão já tinha sido usada por outra rodada (catálogo de vozes). + +## 1.6.0 — 16/11/2026 + +- "Voz e legenda": catálogo base com 15 vozes (Piper offline faber/cadu/jeff; Edge pt-BR, pt-PT e + `multi-*`), ponteiro para a tabela de `voice/README.md`; voz nova no catálogo entra com + `POST /v1/voices/reload`, sem reiniciar. +- `tools.md`: papéis de edge-tts/piper atualizados, evidência do catálogo de 15 vozes, `edresson` + fora; RVC pt-BR no Hugging Face sem licença clara → nada em `user-voices.json`. +- `gotchas.md`: itens 45–47 (Edge `NoAudioReceived`, acentos no teste manual do Piper, + `faster_whisper.decode_audio` com o PyAV do venv — só teste avulso). + +## 1.5.0 — 16/11/2026 + +- Página Vozes do painel (`/voices`): seção "Voz e legenda" (ouvir, voz de personagem com + origem/licença, legenda + `.srt`, configurações que gravam `voice/.env` e reiniciam o serviço); + `description` cita `.srt` e a página. +- "Onde mexer": linhas da página Vozes (`panel/src/lib/voice.ts`, `api/voice/*`, `voice-*`), + formato de história (`STORY_FORMATS` + `StoryKind`, `DescribedSelect`) e logo/ícones + (`logo.tsx` + `app/icon.svg` juntos, `shrink-0`). +- `VOICE_DEVICE=auto` agora escolhe CPU com GPU ocupada na subida; `422 rvc_failed`. +- `tools.md`: 122 testes, medição da legenda na CPU, modelos RVC candidatos sem licença. +- `gotchas.md`: item 31 reescrito (auto + nova medição); itens 40–44 (órfão na 4510, `.pth` + não-RVC, ícone que some, grade da barra lateral, heredoc que perde `\\`); números estáveis. + +## 1.4.1 — 16/11/2026 + +- `gotchas.md`: itens 37–39 do `setup.ps1` (`Select-Object -First 1` no `nvidia-smi` escondia a + GPU, variante explícita do torch no `uv`, `ErrorActionPreference` e stderr do uv). +- `tools.md`: torch `2.11.0+cu128` com CUDA verificado, `VoiceConverter` em `cuda:0`, + pré-requisitos do Applio baixados, setup repetível (2x saída 0); RVC ponta a ponta segue não verificado. + +## 1.4.0 — 16/11/2026 + +- Serviço de voz (`voice/`, 127.0.0.1:4510): seção "Voz e legenda" no `SKILL.md` apontando para + `voice/README.md`; linhas novas em "Várias histórias" e "Onde mexer" (serviço, catálogo/lock, + `setup.bat`/`start.bat`); `description` cobre narração, RVC, transcrição e instalação/subida. +- Escopo: painel/API/banco saíram de "fora do escopo" (já existem); Applio próprio em + `voice/vendor/applio`, Applio pessoal do usuário continua intocável. +- `tools.md`: seção do serviço de voz com versões verificadas (uv 0.11.26, Python 3.12.13, + edge-tts 7.3.1, piper-tts 1.8.0, faster-whisper 1.2.1, ctranslate2 4.8.3, Applio 3.7.0, + torch 2.11.0), evidência `pnpm test:voice` 117 passed; integração com o render como candidata. +- `gotchas.md`: itens 30–36 (cuBLAS na 1ª inferência, GPU disputada, Edge 403, lock do Piper, + LRU no Windows, `\\` no `package.json`, BOM do `setup.ps1`). + +## 1.3.0 — 16/11/2026 + +- Codex CLI 0.169.0 integrado ao painel (flags e eventos verificados); `AGENTS.md` na raiz. +- Novo agente `cenaforge-dashboard-designer` (opus, a pedido do usuário: design exige mais capacidade) para a interface do painel. +- `gotchas.md`: itens 27–29 (Codex fora de Git, shims do npm, ruído do stderr). + +## 1.2.1 — 16/11/2026 + +- Convenção de portas: faixa 4500–4599; painel movido de 4310 para 4500. + +## 1.2.0 — 16/11/2026 + +- Estrutura para várias histórias: `stories//`, `config/-epNN.json`, + assets por história e biblioteca `assets/library/`. +- Painel Next.js (`panel/`, `pnpm panel`, porta 4310): histórias, episódios, render com player, + votação A/B, assets e agentes Claude/Codex pela CLI. Linha na tabela "Onde mexer". +- `tools.md`: Next.js, `node:sqlite`, Claude Code CLI 2.1.314; Codex como candidato não testado. +- `gotchas.md`: itens 22–26 (porta, `.cmd`, Next 16.4, `.mts`, stdin do `claude -p`). + +## 1.1.1 — 16/11/2026 + +- `godot/scripts/` organizado em `core/` (main, scene_config, timeline_controller), + `builders/` (street_builder, rider_builder, facade_painter) e `view/` (camera_controller, + overlay_controller); caminhos da tabela "Onde mexer" atualizados. +- Pasta `stories/` criada com guia de estrutura (usada pelo `cenaforge-story-writer`). + +## 1.1.0 — 16/11/2026 + +- Economia de tokens: `references/token-economy.md` (modelo por tarefa, regras de leitura barata). +- Scripts Python (biblioteca padrão) em `scripts/`: `runs_summary.py`, `inspect_strip.py`, + `new_scene.py`, `check_skill.py`, `clean_runs.py`, mais `_common.py`. Testados nos casos + normal e de erro. +- Agentes novos: `cenaforge-story-writer` (sonnet; enredo, diálogos, overlay em `stories/`) e + `cenaforge-token-auditor` (sonnet; encontra repetição e cria scripts). + +## 1.0.1 — 16/11/2026 + +Correções vindas da primeira auditoria do `cenaforge-skill-updater` (rodada sem edição): +- "Onde mexer": listas fechadas do contrato (`LIGHTING_PRESETS`, `RIDER_ASSETS`, + `BACKGROUND_MODES`) apontadas em `scene_config.gd`. +- Receita: opções do `render` e `pnpm verify`; tempo da prévia corrigido para 42–44 s. +- Validação: comando da tira generalizado para qualquer FPS/duração, gravando em `inspect/`; + aviso de que os quadros de `inspect/` são fixos até 11 s. +- `tools.md`: origem real das configurações do renderizador; proporção do tempo de render corrigida. +- `gotchas.md`: cabeçalho diz quais itens têm registro no TEST_RESULT; seção inclui TypeScript. + +## 1.0.0 — 16/11/2026 + +- Criação da skill a partir da prova de conceito validada (ver `doc/TEST_RESULT.md`). +- Pipeline JSON → Godot 4.7.2 (Mobile) → PNG → FFmpeg 7.1.1 (libx264) → FFprobe. +- Receita de vídeo, mapa "onde mexer", invariantes, checklist de validação. +- `references/tools.md`: inventário com versões verificadas e critérios para ferramentas novas. +- `references/gotchas.md`: 21 armadilhas observadas no teste. diff --git a/.claude/skills/cenaforge/SKILL.md b/.claude/skills/cenaforge/SKILL.md new file mode 100644 index 0000000..89dfe7c --- /dev/null +++ b/.claude/skills/cenaforge/SKILL.md @@ -0,0 +1,228 @@ +--- +name: cenaforge +description: Produz e altera vídeos narrativos do projeto CenaForge — cena 3D (rua) ou do documentário (2D: título, contador, mapa do litoral de SP, `kind: "doc2d"`; 3D da biblioteca de cenas `godot/library/`, ex.: ilha com farol de dia/entardecer/noite, náufragos no costão, `kind: "doc3d"`; peças `godot/kits/`: pessoa articulada com poses e barco; cena dentro de outra) descrita por JSON, animada por tempo de cena na Godot, gravada pelo Movie Maker e convertida em MP4 pelo FFmpeg. Use sempre que o pedido envolver criar, renderizar ou ajustar um vídeo, episódio ou cena (câmera, movimento, cenário, personagem, moto, luz, texto e opções A/B, áudio, resolução), validar um MP4, gerar narração (TTS: Edge, Piper, Kokoro, Google, Azure Speech) ou escolher/filtrar voz, clonar voz a partir de uma gravação (Chatterbox, com consentimento), vozes de personagem (RVC/Applio) ou transcrição com tempos para legenda (.srt) pelo serviço de voz local ou pela página Vozes do painel, histórias interativas com vertentes e votação A–D, lineares ou documentais (vídeo único sobre fatos reais, com fontes) e onde ficam as regras de roteiro (doc/roteiro/), leitor de roteiro do painel (trechos, narração × duração alvo, fontes), criar cena 3D nova na biblioteca (`template.gd` + `manifest.json`, guia `doc/godot/cenas.md`, tarefa "Cena no Godot" do agente), montagem do vídeo documental em MP4 no painel ("Gerar vídeo automático" num clique: plano por regras, fotos reais do Wikimedia Commons, narração e cenas 2D/3D da Godot; "Gerar de novo" por trecho e "Refazer tudo do zero"; estilo "Tudo em 3D" com cartão de foto real por cima e cartões de informação em sequência; ou manual: áudio por trecho com números por extenso, visual por trecho — foto com fundo desfocado, animação 2D, cena 3D da biblioteca, clipe ou cartela —, texto na tela, legenda e créditos, pelo FFmpeg), excluir história no painel (vai para data/trash/), escolha de agente e modelo (Claude/Codex) no painel, mensagem ou correção ao agente durante a execução (Corrigir agora / Enviar ao terminar), termos episódio × vídeo na interface, contas e dashboard (métricas simuladas) do painel, Clipador (cortes automáticos de live da Twitch/Kick/YouTube, verticais 9:16 ou horizontais 16:9 para YouTube, com duração configurável e mínimo garantido, qualidade de gravação configurável até 2K: chat e emotes, heurística, varredura da IA, juízes analista e editor pela CLI, contexto do jogo e perfil do jogo editável/refinável pela IA, webcam achada sem IA e layout do corte, rastreio de reação do rosto do streamer (YuNet, MediaPipe, expressões que reforçam o corte), legenda com hashtags do canal, do jogo e do momento, editor de cortes em tela cheia no padrão de editor de vídeo, com timeline de uma trilha por camada e projeto de edição feito pela IA (trechos com layout próprio e trecho mudo, câmera inteira e editável na Fonte, legenda animada editável arrastando, gancho em tarja animada, fontes empacotadas, textos, zoom, reenquadramento do jogo com keyframes, camadas inseridas (recorte da tela em destaque), chat da live na tela, narração, música, capa também no início, export pelo FFmpeg), retomada de live que caiu, cortes duplicados descartados (o rejeitado ou apagado não volta), render que falha, fila de aprovação com apagar corte (um, selecionados ou a aba inteira), relógio da gravação e cadência do resumo no cartão da sessão, prévia do editor igual ao render (legenda e recorte), "não sai corte" (live fria × regras) e fontes ligadas aos canais de publicação), publicação automática em YouTube, TikTok e Instagram (serviço Publicador, canais de publicação, conectar rede pela API oficial ou sessão logada, aprovação manual ou automática, horários bons e limite por dia, botão "Publicar" no corte aprovado, inclusive sem fonte ligada, fila "Publicações", Configurações, job que falhou, pede login ou pede "Confira na rede", "Já saiu: informar o link" quando o vídeo foi ao ar mas o job falhou), chamar a API do painel por script (cabeçalhos `Origin` e JSON; criar história com agente por `POST /api/stories`), agente que parou no limite de uso ou morreu ao reiniciar o painel, instalar/subir o projeto (setup.bat, start.bat, pnpm dev), ou trocar/adicionar ferramentas de 3D, voz ou render neste repositório — mesmo que o usuário não diga "skill" nem "CenaForge". +--- + +# CenaForge — vídeo a partir de cena descrita por JSON + +**Versão da skill: 1.42.0** (17/11/2026) — histórico em [CHANGELOG.md](CHANGELOG.md). +Mantida pelo subagente `cenaforge-skill-updater` (ver "Manutenção" no fim). + +## Regra zero + +O repositório é a fonte de verdade. Esta skill resume e aponta. Se algo aqui divergir do código, +o código vence — siga o código e acione a manutenção da skill. + +Documentos do projeto que você deve consultar quando o assunto for o deles: +- `README.md` → comandos, contrato JSON completo (seção "Configuração de cena"), estrutura. +- `doc/TEST_RESULT.md` → evidências, tempos medidos, problemas já resolvidos. +- `doc/PROMPT_TESTE_VIDEO_GODOT.md` → especificação original e visão futura (seção 15). +- `voice/README.md` → serviço de voz: instalação, vozes, contrato HTTP, GPU/CPU. +- `clipper/README.md` → Clipador (cortes de live): heurística, juiz, API, `.env`, limites. +- `doc/publicacao/PLANO.md` + `PESQUISA.md` → publicação nas redes (contratos, fatos datados); `publisher/README.md` + → instalar o Publicador e criar o app de cada rede. Resumo para agir: [references/publishing.md](references/publishing.md). + +Para planejar, produzir ou publicar uma peça (episódio ou corte de live), siga a metodologia de +8 etapas da skill **`content-pipeline`** (`.claude/skills/content-pipeline/SKILL.md`): ela diz +*o que* fazer e quando cada etapa está pronta; esta skill dá o *como* técnico de cada etapa. + +## Pipeline + +``` +config/.json + └─ pnpm render ─► output/runs/--/scene.json (perfil aplica a resolução) + ├─ Godot --headless --validate-only valida o contrato (sem GPU) + ├─ godot/override.cfg temporário fixa a resolução do filme + ├─ Godot --write-movie frame.png --fixed-fps N (janela + GPU; quadro N ⇒ t = N/fps) + ├─ confere PNGs (contínuos, quantidade, tamanho, não vazios) + ├─ FFmpeg -start_number → MP4 H.264 yuv420p (+ áudio AAC opcional) + ├─ FFprobe (codec, dimensões, FPS, quadros decodificados, duração ±1 quadro) + └─ inspect/ (quadros 0,5 s · 4 s · 8 s · 11 s extraídos do MP4) + report.json +``` + +**Cenas do documentário**, mesmo lançador e protocolo: `kind` `doc2d` ou `doc3d` faz o `render.ts` passar +`res://scenes/doc.tscn` (`godot/scripts/doc/doc_main.gd` serve as duas). +`{ id, kind, video: { width, height, fps, durationSeconds ≤ 120 }, template, params }` — `doc2d`: `template` +`title`|`counter`|`map` (params no cabeçalho de `godot/scripts/doc/doc2d_canvas.gd`); `doc3d`: `template` = pasta de +`godot/library/` (hoje `island` e `castaways`; cena inexistente → erro listando as disponíveis). `params.variant` +(inteiro) muda layout/câmera. Prévia: `pnpm render -- --config stories//godot/-tNN.json --profile preview` +(2D: 2,7–4,3 s; ilha: 9–14 s; náufragos: 5,8–15,6 s, por 4–5 s de cena). `template.gd` que não compila reprova na +validação (`SCENE_SCRIPT_INVALID`, código 2, `Parse Error` no `render.log`; gotchas 129). **Cena 3D nova = pasta nova +na biblioteca, seguindo `doc/godot/cenas.md`** (contrato, manifesto, determinismo, kits `godot/kits/`, cena dentro de +outra, teste olhando o `inspect/`); detalhes em [references/panel.md](references/panel.md#biblioteca-de-cenas-3d-godotlibrary). + +## Várias histórias (estrutura) + +| O quê | Onde | +|---|---| +| Roteiros | `stories//biblia.md`, `stories//.md` (`file_key` = `ep01`, `ep02-b`…) | +| Opções do episódio (A–D) | `stories//.choices.json` | +| Cena do episódio | `config/-.json` (ex.: `new_scene.py --id -ep02`) | +| Assets da história / biblioteca | `stories//assets///` · `assets/library///` (cada um com `asset.json`) | +| Estado (episódios, vertentes, votos, canais de publicação, fila de publicação, métricas, execuções) | `data/cenaforge.db` (esquema v7; backup antes de migrar em `data/backups/`), gerido pelo painel (`panel/`, http://127.0.0.1:4500) — detalhes em [references/panel.md](references/panel.md) | +| Serviço de voz | `voice/` (http://127.0.0.1:4510); clonagem em `voice/clone/worker.py` (127.0.0.1:4511, venv `voice/.venv-clone`); pesos e estado em `data/voice/` | +| Clipador (cortes de live) | `clipper/` (http://127.0.0.1:4520); banco e blocos em `data/clipper/`, cortes em `output/clipper//` — ver [references/clipper.md](references/clipper.md) | +| Publicador (envio às redes) | `publisher/` (http://127.0.0.1:4530); dados em `data/publisher/` — ver [references/publishing.md](references/publishing.md) | +| Portas locais | faixa 4500–4599 (painel = 4500, voz = 4510, clonagem = 4511, Clipador = 4520, Publicador = 4530, navegador do modo sessão = 4540–4549) | + +Assets catalogados **ainda não são carregados pela Godot** (falta o nó adaptador de GLB). +Formatos (`stories.kind`): `interactive`, `linear` e `documentary` (vídeo único sobre fatos reais, fonte por fato, sem +A/B; vira MP4 pela [montagem documental](references/panel.md#montagem-documental) do painel, num clique). 1ª linha de +`stories//biblia.md`: `Formato: interativa | linear | documental`. **Regras de roteiro: fonte única em +`doc/roteiro/`** (Claude via `cenaforge-story-writer` e Codex) — mudar regra de texto é editar esses .md, não o código. +Interativa = 2–4 vertentes, mas o overlay só desenha `choiceA`/`choiceB`. Tabela, agentes e exclusão em +[references/panel.md](references/panel.md). O painel é do usuário: não inicie/encerre `pnpm panel`. + +## Receita: fazer ou ajustar um vídeo + +1. `pnpm run doctor` (não `pnpm doctor`: no pnpm 11 é o diagnóstico do próprio pnpm). +2. Copie `config/demo-street.json` para `config/.json` e edite **só o JSON** se a mudança + couber no contrato (textos, tempos, distância, cores, câmera, luz existente, seed, casas). +3. `pnpm render -- --config config/.json --profile preview` (42–44 s nesta máquina). + Opções: `--keep-frames` (mantém os PNGs), `--debug-frame-index` (desenha quadro/tempo na + imagem), `--warmup-frames N` (padrão 3). Reverificar um MP4: `pnpm verify -- --file ` + (lê as expectativas do `scene.json` da mesma pasta). +4. Leia o `report.json` da pasta da execução: `status` precisa ser `success` e todas as `checks` + com `ok: true`. +5. **Olhe as imagens** (`inspect/contact-sheet.png` e, se mexeu em movimento/câmera, uma tira de + 1 quadro/s — ver "Validação"). Ajuste e repita. +6. Só então `--profile final` (1080×1920, ~2 min 40 s). +7. Ao responder, informe: caminho do MP4 e da config, comando exato, verificações que passaram, + o que foi inspecionado visualmente e o que **não** foi (ex.: vídeo não assistido em player). + +## Onde mexer para cada tipo de mudança + +| Mudança | Arquivo(s) | Também atualizar | +|---|---|---| +| Texto, tempos, cor, câmera, preset de luz existente, seed | `config/*.json` | nada | +| Campo novo no JSON | `godot/scripts/core/scene_config.gd` (validar + normalizar) | tabela do README, exemplos em `config/`, `godot/tests/run_tests.gd` | +| Perfil de movimento | `godot/scripts/core/timeline_controller.gd` | testes de continuidade/determinismo | +| Enquadramento / preset de câmera | `godot/scripts/view/camera_controller.gd`, `CAMERA_PRESETS` em `scene_config.gd` | README | +| Cenário (rua, casas, postes, morro) | `godot/scripts/builders/street_builder.gd` | modo de fundo novo: `BACKGROUND_MODES` em `scene_config.gd` | +| Preset de luz | dicionário `LIGHTING` em `street_builder.gd` + lista `LIGHTING_PRESETS` em `scene_config.gd` | README | +| Moto e entregador | `godot/scripts/builders/rider_builder.gd` (frente em −Z, `WHEEL_RADIUS`) | asset novo: `RIDER_ASSETS` em `scene_config.gd` | +| Texto final / opções A/B | `godot/scripts/view/overlay_controller.gd` | — | +| Fachadas distantes | `godot/scripts/builders/facade_painter.gd` → `pnpm prepare-assets` | — | +| Cena 2D do documentário (modelo, desenho, lugar do mapa) | contrato `godot/scripts/doc/doc_config.gd` (`TEMPLATES_2D`; `doc3d` validado contra `godot/library/`); desenho e `PRESETS` (costa, `places`) `godot/scripts/doc/doc2d_canvas.gd`; protocolo `godot/scripts/doc/doc_main.gd` (cena `godot/scenes/doc.tscn`) | lugar novo: `MAP_PLACES` em `panel/src/lib/montage-godot.ts` **igual** a `PRESETS.places`; modelo novo: `DOC2D_TEMPLATES` e `planScene` no mesmo arquivo + `SceneEditor` em `montage-editor.tsx` | +| Cena 3D do documentário (nova ou ajuste) | `godot/library//template.gd` (`extends Node3D`: `setup(cfg, viewport_size)`, `apply(t)`, `state_signature()`) + `manifest.json`; peças `.gd` da cena na pasta; peças gerais em `godot/kits/` (`person.gd`, `boat.gd`, fora do painel); outra cena como cenário (`embedded: true`); referências `godot/library/island/` e `castaways/` | nada no painel nem em `godot/scripts/` (lista, formulário e escolha por keywords saem do manifesto); guia `doc/godot/cenas.md` | +| Render, conversão, verificação | `scripts/lib/render.ts` (ramo `doc2d`/`doc3d`: cena `doc.tscn`, sem checagem da moto, `MIN_AVERAGE_LUMA_DOC2D`), `frames.ts`, `verify.ts` | `scripts/tests/launcher.test.ts` | +| Áudio no MP4 (`audio.file`) | `scripts/lib/audio.ts` | testes do lançador | +| Serviço de voz (TTS, RVC, transcrição, Azure, clonagem) | `voice/app/` (`engine.py`, `catalog.py`, `config.py`, `errors.py`, `rvc.py`, `stt.py`, `main.py`) · worker `voice/clone/worker.py` | `voice/tests/`, `voice/README.md` | +| Vozes padrão / pesos baixados | `voice/voices/catalog.json` / `voice/models.lock.json` (URL fixada em commit + sha256) | `voice/README.md` | +| Instalação / subida | `setup.bat` → `scripts/setup.ps1` (UTF-8 com BOM; passo 6b = Clipador, 6b2 = Publicador) · `start.bat` → `scripts/dev.ts` | `README.md` | +| Publicação nas redes (Publicador, despachante, canais de publicação, fila, Configurações) | `publisher/app/` · `panel/src/lib/` (`publisher.ts`, `publishing.ts`, `publishing-rules.ts`, `dispatcher.ts`, `settings.ts`) · `panel/src/instrumentation.ts` · botão "Publicar" do corte `components/clip-publish.tsx` — tabela em [references/publishing.md](references/publishing.md) | `publisher/tests/`, `panel/src/lib/publishing-*.test.ts`, `doc/publicacao/PLANO.md` se mudar o contrato | +| Localizar executáveis / encoders | `scripts/lib/tools.ts` | [references/tools.md](references/tools.md) | +| Painel: páginas, API, votação, agentes (prompt por provedor, lista de modelos `models()`, mensagem durante a execução `sendFollowUp`) | `panel/src/app/`, `panel/src/lib/` (`agents.ts`, `prompts.ts`, `decisions.ts`, `assets.ts`, `renders.ts`); console em `components/agent-console.tsx` | `panel/README.md`; `AGENTS.md` se mudar regra do Codex | +| Painel: página Vozes (`/voices`) | servidor `panel/src/lib/voice.ts` + `panel/src/app/api/voice/*`; cliente `panel/src/components/voice-*.ts(x)` (`voice-client.ts` tipos e `uploadWithProgress`; `voice-cards.tsx` catálogo e filtros; `voice-clone-form.tsx`; `AzureForm` em `voice-studio.tsx`) | `voice/README.md` se mudar o contrato; largura de `Select`/`Input`: gotchas item 62 | +| Regra de roteiro (idioma, overlay, ficção, documental, formato de `biblia.md`/`epNN.md`) | `doc/roteiro/comum.md`, `ficcao.md`, `documental.md` | nada no código; `.claude/agents/cenaforge-story-writer.md` só aponta para lá | +| Painel: vertentes, votação A–D, contas, dashboard, excluir história (`deleteStory`), migração do banco | `branches.ts`, `decisions.ts`, `flow.ts`, `accounts.ts`, `metrics.ts`, `stories.ts`, `db.ts` em `panel/src/lib/` — ver [references/panel.md](references/panel.md) | `panel/README.md` | +| Clipador: captura e qualidade de gravação (`capture.py`), retomada de live, chat/emotes, heurística, duplicados, varredura, juízes, jogo, formato (vertical/horizontal), duração mínima (`fit_window`), layout/webcam, rastreio de reação (rosto), legenda, gancho/tarja e fontes (`assets/fonts/`), reenquadramento e camadas inseridas (`reframe.py`), render, apagar cortes (`clip_delete.py`, tabela `deleted_clips`), editor de cortes, página `/clipper`, canais nas contas | `clipper/app/` · `panel/src/lib/clipper.ts` (regex `ALLOWED`, métodos `METHODS` + timeout por rota) · `panel/src/components/clipper-*.tsx` e `clip-editor*.ts(x)` — tabela em [references/clipper.md](references/clipper.md) | `clipper/tests/`, `clipper/README.md`; peso novo em `clipper/models.lock.json` (URL imutável + sha256) | +| Hashtags da legenda do corte (canal, jogo, momento) | `clipper/app/hashtags.py` (+ `judge.py`, `intel.py`, `worker.py`; painel `clipper-games.tsx`) — ver [references/clipper.md](references/clipper.md) | `clipper/tests/test_hashtags.py` | +| Painel: leitor de roteiro (trechos, narração, fontes; página `/stories/[storyId]/episodes/[number]/roteiro`) | parser puro `panel/src/lib/script-doc.ts` (`parseScript`, `WORDS_PER_SECOND`) + `panel/src/components/script-reader.tsx` — ver [references/panel.md](references/panel.md) | formato do roteiro em `doc/roteiro/` (cabeçalho da tabela de trechos) | +| Painel: montagem documental (um clique ou manual; estilo `mixed`/`3d`; áudio, visual e cartão de foto por trecho → MP4) | estado/banco/modo automático/"Gerar de novo" `panel/src/lib/montage.ts`; FFmpeg **sem banco** `montage-ffmpeg.ts` (cartão, textos em sequência); plano do trecho (`planShot`, `planShot3d`) e render Godot **sem banco** `montage-godot.ts`; biblioteca `scene-library.ts`; fotos `image-search.ts`; fala por extenso `speech-text.ts`; UI `components/montage-editor.tsx`; rotas `app/api/episodes/[id]/montage/` — ver [references/panel.md](references/panel.md#montagem-documental) | `doc/roteiro/comum.md` e `documental.md` se mudar regra de narração/trecho | +| Painel: formato de história novo | item em `STORY_FORMATS` (`panel/src/components/story-formats.ts`) + `StoryKind`/`STORY_KINDS` (`panel/src/lib/types.ts`) + migração do CHECK de `stories.kind` (`db.ts`) + `GUIDE_BY_KIND`/`FORMAT_LABEL` em `prompts.ts` (+ guia novo em `doc/roteiro/` se as regras forem outras) + termo da unidade em `unitTerms` (`story-formats.ts`) | select com descrição: `DescribedSelect` em `forms.tsx`; layout do Fluxo em `story-flow.tsx` | +| Painel: pedir confirmação / mostrar aviso (**nunca** `confirm()`/`alert()` nativos) | `askConfirm`/`showAlert`/`confirmSubmit` de `panel/src/components/confirm-dialog.tsx` (host único já em `app/layout.tsx`) — ver [references/panel.md](references/panel.md#confirmação-e-aviso-componentsconfirm-dialogtsx) | — | +| Painel: modal com conteúdo ou passo a passo | `Dialog` + `Steps` de `panel/src/components/dialog.tsx` (padrão para todo modal novo) | — | +| Painel: logo / ícones | `panel/src/components/logo.tsx` **e** `panel/src/app/icon.svg` juntos (grade de 32); ícones em `icons.tsx` com `shrink-0` | — | +| Ferramenta nova (gerador 3D, motor de voz…) | ver [references/tools.md](references/tools.md) | esta skill, via manutenção | + +## Invariantes — não quebrar + +- **Estado visual = função pura de `t`.** Em render, `t = quadro / fps`; nunca use `delta` nem + relógio do sistema para posição, câmera ou overlay. `evaluate_at_time(t)` é a única fonte. +- **Determinismo:** aleatoriedade só pelo `RandomNumberGenerator` com a `seed` da config. A mesma + config gera o mesmo `stateDigest` (prévia e final iguais). Se o digest mudar sem você ter + mexido em movimento/câmera/overlay, algo saiu do controle. +- **Convenção da cena:** Y é altura, a moto anda em −Z, a câmera fica atrás em +Z. Modelo + importado entra por nó adaptador, não mudando a convenção. +- **Sem `class_name`** nos scripts: o projeto roda sem importação do editor. Use + `const X := preload("res://...")`. +- **Caminhos relativos partem da raiz do repositório** (Godot e lançador). Em `--write-movie`, use + sempre caminho absoluto. +- **Subprocesso sem shell**, argumentos em lista; código ≠ 0, timeout ou cancelamento é falha. +- **JSON nunca vira código**; campos desconhecidos são rejeitados. +- **Identificadores em inglês; comentários, mensagens e textos de UI em português.** +- **Publicação:** nunca marque `published` sem ID/URL remota; nada sai sem aprovação (humana ou automática ligada + pelo usuário); modo sessão só com o usuário logando à mão — sem stealth, captcha ou senha automatizada. Agente não + dispara envio real sem pedido do usuário: para testar, use as suítes (sem rede). Regras em [references/publishing.md](references/publishing.md). +- **API do painel** (`/api/**`, guarda em `panel/src/proxy.ts`): só Host local; POST/PUT/PATCH/DELETE por script + mandam `Origin: http://127.0.0.1:4500` e `Content-Type: application/json` (sem eles: 403/415 — gotchas, item 125). +- Fora do escopo atual: Meshy. O Applio do serviço de voz é uma cópia própria em `voice/vendor/applio`; o Applio + pessoal do usuário não se instala nem se modifica. + +## Voz e legenda + +Fonte: `voice/README.md` (vozes, campos do catálogo por motor, Azure, clonagem, contrato HTTP, +GPU/CPU). Não duplique aqui. Resumo para agir: + +- Instalar: `setup.bat` (opções `-NoRvc`, `-Cpu`, `-Clone`). Subir: `start.bat` ou `pnpm dev` (painel 4500 + + voz 4510 + clonagem 4511 se `voice/.venv-clone` existir + Clipador 4520 + Publicador 4530); só a voz: `pnpm voice`. + Testes: `pnpm test:voice` (pytest, motores falsos), `pnpm test:clipper` e `pnpm test:publisher`. Porta ocupada ou + parte não instalada = aviso e o resto sobe. +- Painel → **Vozes** (`/voices`): Catálogo (sub-abas por motor, busca, filtros, ouvir, voz de personagem `.pth` + + `.index` com origem e licença, voz clonada, testar `.srt`) e Serviço (dispositivo, Whisper, RVC, Azure). Configurações + gravam `voice/.env` e o `scripts/dev.ts` reinicia voz e clonagem sozinho. +- Toda rota, exceto `GET /health`, exige `X-Service-Key` (`VOICE_SERVICE_KEY` em `voice/.env`; o + worker de clonagem usa a mesma). Nunca copie chaves (serviço, Azure) para a skill nem para logs. +- Catálogo `voice/voices/catalog.json`: 76 vozes (12 Edge, 3 Piper, 45 Kokoro, 2 Google, 14 Azure; + contagens e motores em `voice/README.md` e [references/tools.md](references/tools.md)). Padrão `pt-br-antonio` (Edge). + Offline: Piper e Kokoro (pt-BR nativas `kokoro-pf-dora` fem., `kokoro-pm-alex`, `kokoro-pm-santa`). Online + (`502 engine_unavailable` sem internet): Edge, Google e Azure — **sem `VOICE_AZURE_KEY` as vozes Azure somem**; + chave pelo painel (`PUT /api/voice/azure`, nunca volta ao cliente) ou `voice/.env`. +- Voz nova no `catalog.json` (peso no `models.lock.json` com URL imutável + sha256) aparece sozinha + (`_refresh_voices_if_changed` em `voice/app/main.py`; `POST /v1/voices/reload` força). Mudança de + **código** em `voice/app/` ou motor novo exige reiniciar o `start.bat` (gotchas, item 53). +- Vozes do usuário: `data/voice/user-voices.json`. Personagem = voz base + RVC (sem Applio: + `501 rvc_disabled`; `.pth` que não é RVC: `422 rvc_failed`). +- **Voz clonada** (`kind: "clone"`, Chatterbox; detalhes em `voice/README.md`): gravação de 10–30 s, **consentimento + obrigatório** (`consent: true`); worker fora → `503 clone_unavailable`; ignora `speed`; texto longo em partes + (gotchas, item 66). Nunca imite pessoa real sem autorização. +- Narração para vídeo: `POST /v1/synthesize` com `params.format: "wav"`; legenda: `POST /v1/transcribe` com + `X-Detail: words` (palavras com `start`/`end`). +- **O render da Godot não chama o serviço** (a montagem documental chama: um áudio por trecho, e a cena Godot dura a + fala + pausa). Na cena da rua, gere o WAV e aponte `audio.file` (com `audio.enabled: true`). +- Fumaça (serviço no ar): `voice/.venv/Scripts/python voice/scripts/smoke.py --detail words`. `VOICE_DEVICE=auto` + só olha a GPU **na subida**: jogo aberto depois → troque o dispositivo em Vozes (gotchas, "Serviço de voz"). + +## Validação antes de dizer "pronto" + +1. `pnpm test` (lançador + Godot headless) e `pnpm typecheck`. +2. Render de prévia com `status: success`. +3. Inspeção visual lendo os PNGs de `inspect/`. Critérios: nada preto; câmera fora de geometria; + personagem apoiado na moto; perspectiva dos objetos próximos muda; rodas giram; fundo sem + rotação nem borda de plano aparente; texto sem corte e legível; luz consistente. Cena 3D do documentário: + checklist de `doc/godot/cenas.md` (assunto no meio da tela vertical, horizonte sem emenda, `variant` 0/1/2 diferentes). +4. Movimento/câmera alterados → tira de 1 quadro por segundo: + ```sh + ffmpeg -i -vf "select='not(mod(n\,))',scale=180:-1,tile=x" -frames:v 1 -fps_mode vfr /inspect/strip.png + ``` + colunas × linhas ≥ duração em segundos (7x2 serve até 14 s). Os quadros de `inspect/` são + fixos em 0,5 · 4 · 8 · 11 s (`INSPECTION_TIMES` em `render.ts`; tempos ≥ duração são pulados, então cena 2D + curta só tem 0,5 e 4 s); acima de 12 s, ou para ver o fim de uma cena 2D, use a tira. +5. Diga separadamente: código escrito, testes, MP4 gerado, inspeção visual feita/pendente. + +## Economia de tokens + +Use os scripts de `.claude/skills/cenaforge/scripts/` (`runs_summary.py`, `inspect_strip.py`, `new_scene.py`, +`check_skill.py`, `clean_runs.py`, `frame_check.py`, `check_script.py`). Cena: `frame_check.py --last` e abra no +máximo UMA imagem por render; roteiro: `check_script.py stories/`. Enredo, diálogos e textos A/B → subagente **`cenaforge-story-writer`** (segue +`doc/roteiro/`). Quem faz o quê: [references/token-economy.md](references/token-economy.md); repetitivo ou caro → +**`cenaforge-token-auditor`**. + +## Armadilhas já conhecidas + +Leia [references/gotchas.md](references/gotchas.md) antes de mexer em render, resolução, tempo, GDScript, pnpm, painel, +serviço de voz, Clipador ou publicação. Resumo: 1º quadro da Godot sai incompleto (aquecimento de 3 quadros); `delta` não é 1/fps; +resolução fixada na inicialização (`override.cfg`); `--write-movie` relativo falha em silêncio com código 0; regex +em `node -e`/heredoc no bash perde as barras invertidas (item 44: edite pelo Edit); reiniciar o `pnpm panel` mata o +agente em execução e o limite de uso do Claude/Codex para a tarefa no meio — continue no outro provedor (itens 131–132); Claude do painel com OAuth expirado e gasto alto de tokens dos agentes (133–135); modo sessão "navegador abriu mas não respondeu" com a porta viva (Chrome 157 sem `DevToolsActivePort`, 137); "no column named origin" ao publicar corte com o `pnpm dev` ligado desde antes da v7 (138: migra sozinho na 1ª requisição depois da recarga do `db.ts`); envio de corte > 50 MB no modo sessão recusado com "Cannot transfer files larger than 50Mb" (139: `is_local=True` no `connect_over_cdp`; a mensagem ao usuário é a genérica "navegador travou"); TikTok publicou mas o job falhou sem o link (140: `find_video_url` recarrega a lista por ~3 min; use "Já saiu: informar o link"); job novo cancelado por regra antiga porque o laço do despachante guarda o `tick` velho no HMR (141); TikTok em modo sessão com "Locator.click: Timeout" na legenda por aviso "Entendi" por cima (142: `click_through`/`dismiss_tips`, só fechar avisos); **correção que "não pegou" = serviço Python rodando código antigo (sem `--reload`): compare o +início do processo com o `LastWriteTime` do arquivo antes de validar (143)**; legenda com `#RobRun`/`#ROBRUN` ou perfil +do jogo sem `hashtags` (144); Instagram em modo sessão com "não achei o botão" (o botão agora é "Postar" e os botões do +fluxo ficam presos ao diálogo, 145) e rótulo de IA coberto pela lista de hashtags (sem `force=True`, 146; valide seletor +com `prepare`, sem publicar); reel do Instagram saindo 1:1 (formato "Original" em `keep_original_shape`, 147); corte nunca leva +rótulo de IA (148); vídeo apagado na rede: ação "Apaguei na rede" (149); script `python -I` ignora `PYTHONIOENCODING` (150). + +## Manutenção desta skill + +Depois de **qualquer** melhoria que mude como o projeto funciona, acione o subagente **`cenaforge-skill-updater`** +com: o que mudou e por quê, arquivos tocados e evidência (comando + resultado). Não edite à mão no meio de outra tarefa. diff --git a/.claude/skills/cenaforge/references/clipper.md b/.claude/skills/cenaforge/references/clipper.md new file mode 100644 index 0000000..32b649a --- /dev/null +++ b/.claude/skills/cenaforge/references/clipper.md @@ -0,0 +1,510 @@ +# Clipador (`clipper/`) — cortes automáticos de live + +Fonte completa: **`clipper/README.md`**. Ele cobre a arquitetura, as regras da heurística, o juiz, a API, +o `.env` e os limites. Este arquivo só diz onde mexer e o que não pode quebrar. Não copie o README para cá. + +## O que é + +Serviço FastAPI local (Python 3.12, `clipper/.venv`) em `127.0.0.1:4520`. Ele grava uma live (Twitch, YouTube +ou Kick) ou um VOD, lê o chat, transcreve pelo serviço de voz e pede o veredito a uma IA pela CLI. Depois +renderiza cortes verticais (1080×1920, padrão) ou horizontais (1920×1080, YouTube). Toda rota, exceto `GET /health`, exige `X-Service-Key` (`CLIPPER_SERVICE_KEY` de +`clipper/.env`; nunca copie a chave). + +| O quê | Onde | +|---|---| +| Banco do Clipador | `data/clipper/clipper.db` (`PRAGMA user_version` 10, `SCHEMA` em `clipper/app/db.py`: v1 tabelas, v2 `settings`, v3 jogo/varredura/emotes/configuração do corte — colunas novas em `sessions`, `channels.settings_json`, `chat.emotes`, `clips.learned`, tabelas `games` e `emotes`; v4 `edits` (`clip_id`, `project_json`, `rev`, `cover`, `exported_at`, `created_at`, `updated_at`); v5 `face_track`; v6 `games.notes_json`/`games.edited_at`; v7 `edits.origin` (`ai`/`user`) + `edits.ai_project_json`; v8 `clips.aspect` (`vertical`/`horizontal`, padrão `vertical`, gravado no render); v9 `sessions.capture_json` (o que a captura gravou de fato; sessões antigas `NULL`); v10 tabela `deleted_clips` (marca do corte apagado, `ON DELETE CASCADE` com a sessão)). Migra ao subir o serviço. **Nunca altere uma migração já aplicada** (o banco real estava em v4 quando a v7 nasceu): coluna nova = `ALTER` numa versão nova | +| Blocos gravados (`.ts` de 30 s + `segments.csv`) e frames | `data/clipper/sessions//` (frames em `frames/`) | +| Pesos do rastreio de reação (YuNet, MediaPipe, OpenSeeFace) | `data/clipper/models/`, fixados (URL imutável + sha256) em `clipper/models.lock.json` | +| Cortes prontos | `output/clipper//clip-.mp4` + `clip-.jpg` | +| Arquivos do editor (proxy, TTS) | `output/clipper//edit-/` (narração em `tts-.wav`) | +| Fontes empacotadas (ASS e prévia do painel) | `assets/fonts/` **plana** (Luckiest Guy Apache-2.0; Bangers, Anton, Bebas Neue, Poppins ExtraBold OFL-1.1; licença ao lado de cada `.ttf`), fixadas em `assets/fonts/fonts.lock.json` (URL presa a commit do google/fonts + sha256 + `family` = nome dentro do arquivo). Fonte nova: arquivo na pasta + entrada no lock (gotchas, item 105) | +| Vínculo canal → conta (painel) | tabela `account_channels` em `data/cenaforge.db` (migração **v3** do painel, `panel/src/lib/db.ts`; sem chave estrangeira para o canal) | + +## Onde mexer + +| Mudança | Arquivo(s) | Também atualizar | +|---|---|---| +| Captura (Streamlink → bomba Python → `ffmpeg -f segment`), linha do tempo, hora do chat, metadados (`title`/`category`) | `clipper/app/worker.py`, `sources.py` | `clipper/tests/` | +| Qualidade de gravação (`capture.quality`, argumentos do Streamlink, `OPTIONS` com GB/h, `record_run` → `sessions.capture_json`) | `clipper/app/capture.py`; validação `CAPTURE_QUALITIES` em `layout.py`; gravação do 1º bloco em `worker.py` | `clipper/tests/test_capture_quality.py` | +| Busca de quadro dentro de bloco `.ts` (`seek_args`, `grab_frame`) e emenda de resolução/codec (`uniform_segments`) | `clipper/app/media.py`; `clipper/app/editor_render.py`; `face.grab_bgr` e tamanho do quadro por bloco (`_frame_size`) em `face.py` | gotchas, itens 107–108 | +| Retomada de live (`Engine.live_check`, `keep_live`, `RESUME_DELAYS_S`, `resume_interrupted`), render que falha (`recover_orphan_renders`, `ORPHAN_RENDER_S` 300, `MAX_RENDER_ATTEMPTS` 3), cortes duplicados (`SAME_PEAK_S` 10, `SAME_MOMENT_OVERLAP` 0,6, `KEPT_STATUSES`/`VETO_STATUSES`, `discard_pending_duplicates`) | `clipper/app/worker.py` | `clipper/tests/test_resume.py`, `clipper/tests/test_render_and_duplicates.py` | +| Apagar cortes (`delete_clip`, `delete_many`, `select_ids`, `MAX_BATCH` 500, recusas `BUSY`/`PUBLISHED`/`CHANGED`, marca `marks`/`mark_spans`, arquivos só dentro das pastas do Clipador) | `clipper/app/clip_delete.py`; rotas em `main.py` (`ClipsDeleteIn`); marca lida em `worker.py` (veto depois do juiz) e na varredura (`intel.py`) | `clipper/tests/test_clip_delete.py`; `METHODS` em `panel/src/lib/clipper.ts`; seção "Apagar cortes" abaixo | +| Chat (IRC anônimo da Twitch com `CAP REQ :twitch.tv/tags` → emotes nativos e `room-id`; Pusher da Kick, emotes `[emote:id:NOME]`) | `clipper/app/chat.py` | — | +| Heurística: pesos, base de 3 min, mínimo proporcional (`_required_messages`), reações (`min_reactions`), chat fraco (`sparse_rate` 0,5 msg/s), momentos do chat/áudio/rosto (`_chat_moments`/`_audio_moments`/`_face_moments`; `face_*` em `Params`), `pick_peaks`, `fit_window` (duração de todo corte automático) | `Params` e funções em `clipper/app/scoring.py`; alvo `min_target` em `layout.py` | `clipper/tests/test_scoring.py` (regressões de falso positivo, chat fraco e rosto), `test_duration_banner_fonts.py` | +| Rastreio de reação — E/S: backends (MediaPipe; plano B OpenSeeFace), download sob demanda com sha256, recorte FFmpeg 6 qps, laço `face` | `clipper/app/face.py` (`for_scoring`, `must_wait`, `view`, `reset`); laço `_face_loop` e uso de `must_wait` na decisão do corte em `worker.py`; bancada `clipper/tools/face_bench.py` | `clipper/tests/test_face.py`, `clipper/models.lock.json`, `doc/FACE_BAKEOFF.md` | +| Rastreio de reação — lógica pura: sinal por segundo contra o neutro do streamer, rótulos, `reaction_moments`, `summarize` (linha do analista), `locate_cam` (câmera pelo rosto) | `ReactionParams` e funções em `clipper/app/reaction.py` | `clipper/tests/test_reaction.py` | +| Emotes: catálogo 7TV/BTTV/FFZ (canal + global, TTL 1 h, fonte que falha é ignorada), emojis, peso aprendido (`LEARN_UP`/`LEARN_DOWN` 0,3/0,15) | `clipper/app/emotes.py`; ingestão e aprendizado em `clipper/app/intel.py` (`ingest_chat`, `learn_from_clip`) | `clipper/tests/test_intel.py` | +| Contexto do jogo (categoria a cada `GAME_CHECK_S` 600, `screen_game`, perfil pela web; `clean_profile`, `save_profile`, `refine`, `delete_note`), varredura (`SCAN_*`), webcam (`detect_cam`: YuNet local primeiro, IA só se não achar ou `use_ai`; `CAM_RETRY_S` 300), opções `OPTION_DEFAULTS` (inclui `faceTrack`) | `clipper/app/intel.py` | README do Clipador | +| Juízes (analista + editor), prompts, glossário `CHAT_GLOSSARY`, linha "Rosto do streamer: …" do analista, schemas, chamada da CLI, pesquisa e refino do jogo (`PROFILE_SYSTEM`/`research_game`, `REFINE_SYSTEM`/`refine_game`), câmera | `clipper/app/judge.py`; montagem dos 6 frames do analista (8 se o trecho passa de 80 s) em `worker.py` | README do Clipador | +| Hashtags da legenda (`to_tag`, `fold`, `split_hashtags`, `compose`, `build_caption`; `MAX_TAGS` 8, `GAME_TAGS` 3, `MOMENT_TAGS` 4) | `clipper/app/hashtags.py`; uso em `judge_clip` de `worker.py`; campo `hashtags` em `judge.py` (`VERDICT_SCHEMA`, `PROFILE_SCHEMA`, `Verdict.hashtags`) e `PROFILE_LISTS`/`clean_profile`/`Intel.session_game` em `intel.py` — ver "Hashtags da legenda" abaixo | `clipper/tests/test_hashtags.py` | +| Configuração do corte: camadas padrão ← canal ← sessão ← projeto (`DEFAULTS`, `merge`, `validate`), `format.aspect` (`ASPECTS`, `FRAME_SIZES`, `CANVAS_SIZES`, `aspect()`), `MODES` (5 modos, inclui `cam_only`), `resolved_mode` (queda para `blur` sem câmera; `full` no horizontal), retângulos, legenda, crédito, `duration` (`min_target`), `hook` (`HOOK_STYLES`, `HOOK_ANIMS`, `HOOK_FONT`), `capture`; fontes empacotadas (`PACKAGED_FONTS`, `font_files`, `ass_filter` = `ass=` com `fontsdir` só se o ASS usar uma delas); cadeia de layout reutilizável `layout_chain(settings, src, dst, tail, suffix, mode)` (usada por `video_filter` e pelo editor) | `clipper/app/layout.py`; rotas de settings em `main.py` (devolvem `aspects`, `frames`, `fontFiles`, `hookStyles`, `hookAnims` e `captureQualities`) | `clipper/tests/test_format_and_captions.py` (o vertical precisa continuar batendo com `clipper/tests/data/vertical_golden_sha256.json`); modo novo também em `LayoutMode`/`MODE_LABEL` de `panel/src/components/clipper-client.ts` e `resolvedMode` de `clip-editor-model.ts`; grupo novo também em `CutSettings` (`Aspect`, `aspectOf`, `withFormat` para serviço antigo) | +| Projeto de edição: modelo, tempo sessão↔saída, `normalize_cuts`, `validate_project`, `auto_project` (projeto da IA), `pick_hook` (texto do gancho), `CAPTION_PRESETS`, `SUGGEST_SCHEMA`/`clean_suggestion` | `clipper/app/editor.py` | `clipper/tests/test_editor.py`, `clipper/tests/test_editor_layers.py`; tipos espelhados em `panel/src/components/clip-editor-model.ts` | +| Render do corte (ASS animado, gancho e tarja `banner`, textos, barra, chat na tela `chat_events`, filtergraph, trecho mudo, áudio, proxy, forma de onda, capa e capa no início) | `clipper/app/editor_render.py` (`render_project`, `build_filter`, `build_project_ass`); cores ASS via `layout.ass_color`/`ass_inline_color` | [gotchas.md](gotchas.md) itens 57, 71, 74–78, 104–105 | +| Reenquadramento do jogo (`reframe.keys`, `perspective_filter`) e camadas inseridas (`kind: "inset"`, decoração numpy/OpenCV), `EASES`, `MAX_KEYS` 60, `MAX_INSETS` 12 | `clipper/app/reframe.py`; validação em `editor.py`; grafo em `editor_render.py` | `clipper/tests/test_reframe_insets.py`; interpolação espelhada em `clip-editor-model.ts` (`easeAt`, `interpolate`, `reframeAt`) — as duas precisam dar o mesmo valor; gotchas, item 106 | +| Rotas do editor, `ensure_edit`, `render_clip_edit`, `chat_for` (mensagens da sessão para o chat na tela) | `clipper/app/editor_api.py`; chamado por `Engine.render_clip` em `worker.py` | `ALLOWED` e timeout em `panel/src/lib/clipper.ts` | +| Legenda (tempo saneado: `clean_words`, `group_words`, `caption_blocks`; `build_ass`) e crédito — usada pelo render do editor e pelo worker, nos dois formatos | `clipper/app/subtitles.py` (`MIN_WORD_S` 0,06, `MIN_STEP_S` 0,04). `media.render_vertical` ainda existe em `media.py`, mas **não** é mais usado pelo render de cortes | `clipper/tests/test_format_and_captions.py`; [gotchas.md](gotchas.md) itens 57–58, 70, 90 | +| Rotas HTTP | `clipper/app/main.py` (editor: `editor_api.py`) | `ALLOWED` em `panel/src/lib/clipper.ts` (o proxy recusa caminho fora da regex) e o timeout por rota no mesmo arquivo | +| Variáveis do `.env` | `clipper/app/config.py` + `clipper/.env.example` | tabela do README do Clipador | +| Página `/clipper` | `panel/src/app/clipper/page.tsx`, `panel/src/components/clipper-*.tsx` (`clipper-cut-settings.tsx` modal do corte em 5 abas, com Gancho e "Qualidade da gravação"; `clipper-games.tsx` aba Jogos e emotes (editar perfil, pedir à IA, pedidos guardados); `clipper-queue.tsx` cartão com a análise, reação do rosto (`FaceSignal`, `FACE_LABEL`), recuo do início `START_STEPS`, botão "Editar"/"Continuar edição", "Apagar" e seleção discreta (`SelectionPill`); `clipper-judge.tsx` interruptor "Rastrear a reação do streamer"; `clipper-sessions.tsx` cartão da sessão (`sessionHealth`, selo de quem achou a câmera, relógio `RecordingClock`, cadência `SummaryCadence`) e cabeçalho em `clipper-studio.tsx`), cliente `clipper-client.ts` | [panel.md](panel.md) | +| Página do editor `/clipper/edit/[clipId]` | `panel/src/app/clipper/edit/[clipId]/page.tsx` + `panel/src/components/clip-editor*.ts(x)` (papel de cada arquivo em [panel.md](panel.md#editor-de-cortes)); tokens `--color-nle-*` e bloco `.nle` em `panel/src/app/globals.css` | [panel.md](panel.md#editor-de-cortes) | +| Ponte e proxy do painel | `panel/src/lib/clipper.ts` + `panel/src/app/api/clipper/[...path]/route.ts` | — | +| Fontes (canais de live) nos canais de publicação | `linkChannel`/`endChannel`/`accountsForChannel` em `panel/src/lib/accounts.ts`; rotas `panel/src/app/api/accounts/[id]/channels/`; card "Fontes de corte" em `account-manager.tsx`. Na UI "Canais" virou **"Fontes"**; código e rotas seguem `channels` | [panel.md](panel.md) | +| Publicação dos cortes | despachante do painel lê `GET /v1/clips` com `channel=` (fontes, separadas por vírgula), `status=ready,approved` e `ids=`; aprova (`PATCH status=approved`) e marca `published` | [publishing.md](publishing.md) | + +## Como os momentos nascem (resumo; regras completas no README) + +- `source` do corte: `chat`, `audio`, `face` (rosto forte com apoio), `ai` (varredura) ou `manual`. +- **Chat:** mínimo nos 8 s do pico = 3× a mediana recente, entre 4 (`min_peak_floor`) e 12 (`min_peak_messages`), e + ≥ 2 reações (texto ou emote) — ou o dobro do mínimo em mensagens. Emote soma bônus + peso aprendido do canal. +- **Áudio:** sempre sem chat; também com chat fraco (< `sparse_rate` 0,5 msg/s). +- **Varredura** (`scanEnabled`, `scanIntervalS` 180, 60–900): a IA vê até 7 frames + fala + chat + perfil do jogo e + propõe 0–2 momentos; proposta com nota < 4 (`SCAN_MIN_PROPOSAL`) não vai aos juízes. Cada janela grava em + `sessions.memory_json` `proposals` (quantas a IA propôs) e `created` (quantas viraram candidato) e loga + "varredura lo–hi s: N proposta(s), M candidato(s)": é por aí que se sabe se ela não propôs ou se foi barrada. +- **Aprendizado dos emotes:** aprovar/rejeitar no painel = ±0,3/0,15 nos emotes de −10 s a +6 s do pico, uma vez por + corte (`clips.learned`); a decisão da IA conta com `factor=0.5`. Peso limitado a −1…3. + +## Juízes (decisão do usuário: pela CLI, sem chave de API) + +- Provedores `codex` (padrão `gpt-6-luna`; lista de `~/.codex/models_cache.json`), `claude` (`haiku`/`sonnet`/`opus`) + ou `off` (só a heurística). +- **ANALISTA** vê 6 frames (8 se o trecho passa de 80 s) + fala + chat + glossário e devolve `situation`, `what_happened`, `screen`, `speech`, + `chat_meaning`, `confidence` (0–1) e início/fim da ação. **EDITOR** vê só texto + a análise e escreve título, + legenda, nota e corte. Os dois podem recuar até `duration.backtrackS` (padrão 120 s) antes do candidato. +- `PUT /v1/judge`: provedor, `model` (editor), `analystModel` (vazio = o mesmo), `minScore`, `scanEnabled`, + `scanIntervalS`, `vision`, `camDetect`, `faceTrack`. Fica na tabela `settings`, sem reiniciar; o `.env` só dá o valor inicial. +- Codex: cada imagem com seu `-i`, todas antes do `-` final; `--search` é opção **global** (antes de `exec`). +- Custo fixo: cada chamada é um processo novo (2 por candidato). `codex_lean_overrides(search, config_file=None)` em + `judge.py` enxuga o Codex; o Claude leva `--setting-sources project,local`. Números e limites em + [token-economy.md](token-economy.md); teste: `test_codex_lean_overrides`. Vale após reiniciar o Clipador (gotcha 136). +- Não adicione chave de API ao juiz sem pedido do usuário. Corte manual é renderizado mesmo com nota baixa. + +## Hashtags da legenda (`hashtags.py`) + +Pedido do dono (17/11/2026): a IA põe as # certas, do jogo e da missão. A legenda do corte = texto + hashtags + crédito, +montada por `build_caption(text, tags, credit)` (partes separadas por linha em branco; o crédito é "🎥 Créditos: link"). + +- **Quem escolhe o quê:** o sistema fixa o **canal** (nome do streamer) e as do **jogo** (até 3 de `profile.hashtags`; + sem perfil ou sem a seção, o nome do jogo). A IA escolhe só as do **momento** (2–4 no campo `hashtags` do veredito: + missão, atividade, evento, modo, lugar, item ou personagem, de preferência com termos do perfil; sem genéricas e sem + repetir canal ou jogo). `JUDGE_SYSTEM` manda a `caption` sem hashtags; `split_hashtags` tira as que vierem no texto + e as junta às do momento. +- `compose(streamer, game, profile, moment)`: canal → jogo → até 4 do momento, sem repetidas (`fold`: sem #, acento e + maiúscula), até 8. `to_tag`: "ROB RUN" → `#ROBRUN`, "perseguição policial" → `#PerseguiçãoPolicial`; sem letra → `None`. +- `Verdict.hashtags` é tupla (padrão `()`); `_clean` aceita resposta sem `hashtags`. `_MOMENT` (varredura) **não** tem o + campo. Sem juiz ou com o juiz falhando, ainda saem as tags do canal e do jogo. +- Perfil do jogo: `PROFILE_SCHEMA` ganhou `hashtags` (3–6 que o público usa no TikTok, Shorts e Reels BR, a principal + primeiro); `PROFILE_SECTIONS` ganhou "Hashtags"; `clean_profile` normaliza com `to_tag`/`fold`. `game_context` também + passa as `mechanics` como termos para as tags do momento. `Intel.session_game(session)` devolve (nome, perfil) com o + mesmo critério do contexto. +- Painel: seção "Hashtags" (violeta, chips, editável, com chat) em `SECTIONS` e `ProfileView` de `clipper-games.tsx`; + `GameProfile.hashtags?` em `clipper-client.ts`. Armadilha de perfil sem a seção e de cortes antigos: gotchas, item 144. +- API: `GameRefineIn.section` aceita `"hashtags"` (chat da seção) e `GameProfileIn.hashtags` (lista, máx. 20) existe; + sem esse campo, salvar o perfil à mão apagaria as hashtags. Campo novo no perfil = acrescentar nos dois modelos de + `main.py`. Teste: `test_api_accepts_hashtags_in_profile_edit_and_section_chat`. +- Só vale depois de reiniciar o Clipador (gotchas, item 143). Limite: tags do momento dependem da CLI real; não testado + com IA real. + +## Configuração do corte + +- `GET/PUT /v1/channels/{id}/settings` (padrão do streamer) e `/v1/sessions/{id}/settings` (`settings_json`, + sobrescreve campo a campo). Modos `auto|blur|cam_top|game_only|cam_only`; `cam`/`game` = retângulos 0–1 do quadro + original. `cam_only` = câmera do streamer na tela inteira; `cam_top` e `cam_only` sem câmera marcada caem em `blur`. +- `format.aspect`: `vertical` (padrão, 1080×1920) ou `horizontal` (1920×1080, YouTube). No horizontal: quadro original + inteiro (ou `layout.game` recortado para preencher); `cam_only` continua valendo; `auto`/`blur`/`cam_top`/`game_only` + viram quadro inteiro (`resolved_mode` = `full`). ASS num quadro lógico 2560×1440 → tamanhos em px do JSON saem a + 75 %; legenda automática a 85 % da altura; crédito no canto direito. Tabela de tamanhos no README do Clipador. +- `duration`: padrão `{minS: 60, maxS: 90, backtrackS: 120}`; limites `minS` 5–120, `maxS` 15–180, `backtrackS` 0–120 e + `minS` < `maxS` (senão `LayoutError`). Para Shorts de terceiros, baixe o canal para ≤ 60 s. **Todo corte automático + sai com ≥ `minS` + 1 s e ≤ `maxS`** (`layout.min_target` = `minS` + 1,1 s, por `scoring.fit_window`): heurística, + varredura, juízes, `auto_project` (depois de silêncios e aparos), remoção de silêncio e "IA sugere". Faltando + material, o corte cresce para trás (no começo da gravação, para a frente); gravação menor que o mínimo não inventa + vídeo. "Cortar agora" e a edição à mão continuam livres. Não reintroduza ajuste de início/fim fora de `fit_window` + (gotchas, item 103). +- `hook` (estilo do gancho que o projeto da IA põe na abertura): `{style: plain|banner, bg, color, font, + anim: pop|fade|none|slide, seconds 1–8}`; padrão `banner`, `#00FF00`, `#FFFFFF`, Luckiest Guy, `slide`, 3 s. Tudo em + ASS, sem filtro extra (entrada `slide` em duas camadas: gotchas, item 104). +- Fontes (`caption.font`, `hook.font`, `font` dos textos): as do Windows (Arial Black, Arial, Impact, Verdana, Segoe UI + Black, Trebuchet MS) e as empacotadas de `assets/fonts/` (sha256 conferido ao carregar). Nome = família de dentro do + arquivo ("Poppins ExtraBold"). +- `capture.quality`: `best` (padrão) | `1440p` | `1080p` | `720p` | `480p` (teto), por canal e por sessão (não por + corte); vale na **próxima** gravação ou retomada. `CLIPPER_QUALITY` não é mais lida. Detalhes em "Qualidade de + gravação" abaixo. +- `GET …/settings` devolve `own`, `effective`, `defaults` (com `format`, `duration` e `hook`), `modes`, `fonts`, + `fontFiles` (`{família: "assets/fonts/…ttf"}`), `hookStyles`, `hookAnims`, `aspects`, `frames` + (`{vertical, horizontal: {width, height, canvasWidth, canvasHeight}}`) e `captureQualities` + (`[{id, label, maxHeight, gbPerHour, gbPerHourMax, hint}]`). O formato do arquivo renderizado fica em `clips.aspect` e + sai no JSON do corte (antes do 1º render, `vertical`). +- Webcam: `POST /v1/sessions/{id}/detect-cam` (YuNet local em 12 quadros, sem IA; a IA olha 3 frames só se o local + não achar rosto e `vision` estiver ligada, ou com `?ai=true`) ou automática nos 2 primeiros blocos, se `camDetect`. + `cam_json.source` = `yunet` | `ai` | `manual`. Prévia sem salvar (no formato efetivo): `POST …/preview`; quadro: `GET …/frame?t=`. +- Jogo da sessão: `PUT /v1/sessions/{id}/game` trava a troca automática. Emotes do canal: + `GET /v1/emotes?channel=twitch-`. +- Timeouts do proxy do painel: 8 min para `games/*/(research|refine)`, 5 min para + `clips/*/(proxy|preview-render|retranscribe|tts|suggest|waveform)`, 3 min para `detect-cam|preview|check`, 30 s para + `sessions/*/face(/reset)`, 2 min o resto. + +## Qualidade de gravação (`capture.py`) + +Fonte completa (tabelas de nomes de stream e de custo): seção "Qualidade de gravação" de `clipper/README.md`. + +- Streamlink: `best` (ignora `audio_only` e `*_portrait`); teto = `--stream-sorting-excludes >{teto}60` com + `best,worst-unfiltered` (sem nada abaixo do teto, pega a menor variante: nunca falha pela qualidade). Twitch com + `best`/`1440p`: `--twitch-supported-codecs h264,h265` (o 2K vem em HEVC). AV1 não é pedido (FFmpeg local sem + libdav1d). Sem opção de 30/60 qps (o topo é quase sempre 60 qps; o corte sai em 30 qps). +- Gravado de fato: `ffprobe` do 1º bloco de cada execução → `sessions.capture_json` → `capture` em + `GET /v1/sessions/{id}` (`quality`, `width`, `height`, `fps`, `codec`, `kbps`, `gbPerHour`, `fromIdx`, `runs`, + `mixed`); `null` = sessão antiga (≤ 720p). Painel: "gravando em L×A · fps" no cartão da sessão. +- Medido (17/11/2026, trecho real do skipnho): disco/hora 720p60 1,5 GB, 1080p60 3,6 GB; 1440p60 4,7–4,9 GB/h só com + blocos **gerados** do 1080p (nenhuma live 2K no ar). Render de 60 s com NVENC 6,2–6,7 s em qualquer resolução. A + câmera recortada no vertical sai mais nítida em 1080p que em 720p; 2K ampliado não ganha nada. +- O que existe nas plataformas (17/11/2026): Twitch quase sempre até `1080p60` (+ `*_portrait` em 9 de 143 canais); + Kick até `1080p60`; YouTube pelo Streamlink para em 1080p, até em live "4K". +- Retomada pode trocar de qualidade: o render e o proxy uniformizam o trecho que atravessa a emenda (gotchas, item 108). + +## Retomada, render que falha e cortes duplicados (`worker.py`) + +Regras completas em "Armadilhas já resolvidas" do README do Clipador. + +- **Retomada:** `Engine.live_check` devolve `live` / `offline` ("No playable streams…") / `unknown` (timeout, erro, + JSON inválido). `keep_live` tenta de novo com esperas `RESUME_DELAYS_S` (0, 10, 20, 40, 60, 90, 120 s ≈ 5,7 min) + antes de processar; enquanto tenta, a sessão fica `interrupted`. Vale na subida e para a captura que cai no meio da + live. Só processa depois de esgotar as tentativas ou de ver `offline` 2 vezes seguidas; 3 retomadas seguidas sem + bloco novo desistem. `POST /v1/sessions/{id}/resume` vale para qualquer live que não esteja gravando. +- **Render:** qualquer exceção no render marca o corte `error` com a mensagem e a fila segue. `rendering` órfão há + mais de 5 min volta para `pending`; na 3ª vez vira `error`. +- **Duplicados:** o candidato guarda a janela original (`reasons.candidateStartS/EndS`) e não nasce se o pico estiver a + ≤ 10 s de outro corte ou sobrepuser o trecho final ou a janela original de qualquer corte (inclusive `discarded`). + O corte apagado conta como existente (marca em `deleted_clips`, ver "Apagar cortes"). + Depois do juiz, o trecho final é conferido contra `VETO_STATUSES` (= `KEPT_STATUSES` pendente/renderizando/pronto/ + aprovado/publicado **+ `rejected`**) e contra os apagados que estavam num desses estados: "mesmo momento" (pico a + ≤ 10 s ou ≥ 60 % do trecho mais curto coberto) vira `discarded` com "Duplicado do corte N (mesmo momento | que você + rejeitou | que você apagou)" (`judge.duplicateOf`). O descartado pela IA **não** veta o trecho final. "Cortar agora" + (manual) só ganha `judge.warning`. Antes de cada render, `discard_pending_duplicates` usa o **mesmo veto**: tira da + fila o pendente/renderizando igual a um corte pronto, aprovado, publicado ou rejeitado, a um apagado que estava num + desses estados ou a um pendente mais antigo, com o mesmo motivo "Duplicado do corte N (…)". Descartado pela IA não + veta; manual, exportado do editor e o que está renderizando agora nunca saem. Duplicados já prontos não são + mexidos: rejeite ou apague à mão. + +## Apagar cortes (`clip_delete.py`) + +Fonte completa: seção "Apagar cortes" e tabela "API" de `clipper/README.md`. + +| Rota | Faz | +|---|---| +| `DELETE /v1/clips/{id}[?confirmPublished=true]` | 200 `{id, sessionId, status, removedFiles, left: [{file, reason}]}`; 404 `not_found`; 409 `{error, code}` com `busy_candidate`, `busy_rendering`, `published` ou `changed` | +| `POST /v1/clips/delete` `{ids: [≤ 500]}` **ou** `{statuses, sessionId?}`, `confirmPublished?` | 200 `{requested, remaining, deleted, failed: [{id, code, reason}]}`; 400 sem os dois, com os dois ou `sessionId` com `ids`; 422 acima de 500 ou estado inválido | + +- Recusa `candidate`, `rendering` e o `pending` que o motor já pegou (`engine._rendering`, sob o mesmo `engine.lock` + do render). `published` só com `confirmPublished`. Cada corte do lote segue as mesmas regras; recusado vai em `failed`. +- Some: linha em `clips`, `edits`, `clip-.*`/`clip--*` em `output/clipper//`, a pasta `edit-/` e os + quadros do juiz `frames/clip-*.jpg`. Os blocos `.ts` ficam (são da sessão). Só apaga dentro de + `CLIPPER_OUTPUT_DIR`/`CLIPPER_DATA_DIR`, com caminho resolvido; link ou junção some só o link; o que não pôde vai em + `left` com o motivo. +- **O momento apagado não volta:** a marca em `deleted_clips` (pico, trecho final, janela original, estado) entra no + anti-duplicado do candidato (`find_new_clips`), na varredura (`mark_spans`), no veto depois do juiz e na limpeza da + fila antes do render (`discard_pending_duplicates`), nos dois só se o estado era de `VETO_STATUSES`. Não apague a marca para "liberar" o momento sem pedido. +- Proxy do painel: `METHODS` em `panel/src/lib/clipper.ts` aceita só POST em `clips/delete` e só GET/PATCH/DELETE em + `clips/{id}` (outro método = 405). O painel manda os **ids que está mostrando**, nunca `statuses`: corte que chega + depois da confirmação não é apagado junto. UI em [panel.md](panel.md#página-clipper-clipador). + +## Rastreio de reação (rosto do streamer) + +Fonte completa: seção "Rastreio de reação" de `clipper/README.md`; plano e licenças em `doc/PLANO_RASTREIO_REACAO.md`; +medições em `doc/FACE_BAKEOFF.md`. Roda no PC, sem IA. Opção `faceTrack` (padrão ligada; `PUT /v1/judge`). + +- **Stack (licenças livres para publicar):** YuNet `face_detection_yunet_2026may.onnx` (MIT, `cv2.FaceDetectorYN` do + OpenCV 5) acha a câmera; MediaPipe Face Landmarker (Apache-2.0, 478 pontos + 52 blendshapes) mede expressões; + OpenSeeFace `.onnx` (BSD-2) é o plano B (só posição, sem expressões). **Não use** SCRFD/InsightFace, YOLO-Face, + LibreFace, OpenFace 3.0 nem Py-Feat: licença incompatível com publicação. +- **Fluxo:** `face.py` (E/S) recorta a câmera +10 % pelo FFmpeg (~384 px, 6 qps, `rgb24` por pipe) → MediaPipe em + modo VIDEO, um landmarker por bloco → tabela `face_track` (status `done`/`no_cam`/`error`), `cx`/`cy`/`size` no + **quadro inteiro**. `reaction.py` (lógica pura, sem cv2/mediapipe) faz o resto. Câmera trocada → série refeita. +- **Câmera pelo rosto** (`locate_cam`): grupo de rostos estável em ≥ 50 % dos quadros **e** confiança média do grupo + ≥ `ReactionParams.min_cam_score` (0,7). Webcam real dá 0,92–0,94; desenho de rosto em live sem câmera dá 0,61–0,66 + (gotchas, item 92). Não baixe esse piso sem medir. +- **Sinal:** z robusto de cada canal contra o neutro dos últimos 180 s do próprio streamer; rótulos `risada`, `grito`, + `susto`, `choque`, `raiva`, `confuso`. Ajuste por `ReactionParams` (pisos por canal, pesos, limiares). +- **Cortes:** rosto **reforça, não manda.** `reasons.face` + bônus ≤ 0,6 em momentos do chat/áudio; fonte `face` só + com z ≥ 6 **e** apoio (áudio suavizado ≥ 1,5 ou ≥ 2 mensagens de reação). A decisão do corte espera o rosto do + trecho (no máximo 2 blocos atrás da transcrição). O analista recebe a linha "Rosto do streamer: …" — exceto + quando a série da sessão é do plano B OpenSeeFace (sem blendshapes): aí `FaceService.summary` não manda linha. +- **Modelos:** `setup.ps1` passo 6b baixa e confere o sha256; o serviço baixa sob demanda se faltar. Falha de modelo + não marca blocos: nova tentativa em 5 min. Modelo novo = entrada em `clipper/models.lock.json` com URL imutável + + sha256 + licença. +- **Dependências** (`clipper/requirements.txt`): `mediapipe`, `opencv-contrib-python`, `numpy`, `onnxruntime` — + versões em [tools.md](tools.md). Nunca instale `opencv-python-headless` junto (gotchas, item 80). +- **Rotas:** `GET /v1/sessions/{id}/face?from=&to=` (série, `signal`, picos, câmera, progresso) e + `POST …/face/reset`. Ambas na regex `ALLOWED` do painel. +- **Bancada** (lê o banco só para leitura, saída em `output/face-bench/`): + `clipper\.venv\Scripts\python.exe clipper\tools\face_bench.py --session 3`. Armadilhas: [gotchas.md](gotchas.md) itens 79–84 e 92–95. +- **Instância de teste isolada** (receita em "Variáveis" de `clipper/README.md`): `CLIPPER_PORT=4521`, + `CLIPPER_DATA_DIR=output//data`, `CLIPPER_OUTPUT_DIR=output//clips` no ambiente (padrões: + `data/clipper` e `output/clipper`; as duas precisam ficar **dentro** do repo, senão `ConfigError` em + `clipper/app/config.py`), juiz `off`, e o `sqlite_sequence` de `sessions` do banco novo em 90000 antes da 1ª sessão + (gotchas, item 93). Cuidados com cópia do banco real: item 77. + +## Editor de cortes (`/clipper/edit/`) + +Fonte completa: seção "Editor de cortes" de `clipper/README.md` (campos do projeto, render, medições, limitações). +Pesquisa de referência (OpenCut, effectcraft, Descript, Submagic etc.; nenhum código copiado): +`doc/clip-editor-research.md`. + +- **Um caminho só de render:** `Engine.render_clip` (`worker.py`) → `editor_api.ensure_edit` (gera o projeto da IA se + o corte não tem) → `editor_api.render_clip_edit` → `editor_render.render_project` (FFmpeg). Não reintroduza + render que contorne o projeto de edição. +- **Formato:** o projeto pode trocar o formato só daquele corte em `settings.format` (mesma validação de + `layout.validate`); projeto antigo sem `format` segue canal/sessão. Export, `preview-render` e capa saem no formato do + corte (1080×1920 ou 1920×1080). O Programa do painel segue o formato do corte (tamanhos de `frames`; em 16:9 no + horizontal). +- **Projeto da IA** (`editor.auto_project`): trecho `action_start_s − 0,8 s … reaction_end_s + 0,8 s`, encaixado em + palavras e depois em `fit_window` (≥ `minS` + 1 s, ≤ `maxS`; o início só adianta se o mínimo continuar); tira vãos + ≥ 2 s sem fala, quietos (< −38 dBFS) e a mais de ±3 s do pico; legenda + Whisper preset `pop` (tempo saneado por `subtitles.py`); gancho por `pick_hook` (regra abaixo) no estilo do grupo + `hook`; zoom 1,25× no `peak_s` (no rosto em `cam_top`); capa no pico; `meta.origin = "ai"` com data, modelo e passos. + **A IA não propõe reenquadramento nem camadas inseridas** (o analista não devolve região da tela). +- **Gancho (`editor.pick_hook`):** o `hook` do analista só vale se tiver ≤ 8 palavras, ≤ 48 caracteres e nenhum tempo + da gravação (3+ dígitos seguidos de "s"); senão vale o título do editor. Em qualquer caso a menção ao tempo + ("Aos 5085s, …") é removida, a 1ª letra vira maiúscula e o texto para em palavra inteira até 60 caracteres. +- **Origem:** `edits.ai_project_json` guarda o projeto da IA ("Projeto da IA" no editor volta a ele). PUT do editor + marca `origin = 'user'`. Rejudge (corte volta a `pending`) apaga **só** edit de origem `ai`; o do usuário fica. +- **Tempo:** `cuts`, palavras, textos, zoom, narração e capa em tempo da sessão; só o gancho em tempo de saída. +- **Validação forte** em `validate_project` (3–180 s, limites de quantidade, texto escapado no ASS, áudio só de + `assets/` ou dos TTS do editor, nada vira shell). Campo novo no projeto = validação com valor padrão (projeto + antigo continua abrindo) + teste em `clipper/tests/` + tipo em `clip-editor-model.ts`. +- `clip_view` devolve `edit: {updatedAt, exportedAt, cover, origin}` (o painel decide "Editar"/"Continuar edição"). + +Campos das camadas (tabela completa do projeto em "Tempo e modelo do projeto" do README): + +| Campo | Regra | +|---|---| +| `cuts[].mode` | layout só daquele trecho: um de `MODES` ou `null` (= o do corte) | +| `cuts[].muted` | trecho sem o áudio da live (`volume=0` no trecho; narração e música continuam). `normalize_cuts` só junta trechos encostados com o mesmo `mode` **e** o mesmo `muted` | +| `overlays[].x` (gancho e texto) | posição horizontal 0,05–0,95; ausente = 0,5. `y` 0,04–0,96. No zoom, `x`/`y` (0–1) são o foco | +| `overlays[]` `hook`/`text`: `style`, `bg`, `color`, `font`, `anim` | opcionais. `style` `plain` (padrão) ou `banner` (tarja na largura toda, centrada em `y`, maiúsculas em até 2 linhas; a fonte diminui em vez de cortar palavra); `font` = uma de `fonts`; `anim` ganhou `slide`. Sem esses campos, renderiza idêntico ao de antes | +| `overlays[]` `kind: "inset"` | camada inserida: `start`/`end` (sessão), `src` `{x, y, w, h}` (recorte 0–1 do quadro original), `x`/`y` (centro na saída), `size` 0,1–1 da largura, `border` (`#RRGGBB`/null), `borderW` 0–40 (6), `radius` 0–200 (18), `shadow` (true), `anim` `pop`\|`fade`\|`slide`\|`none`, `keys` opcionais `[{t, x, y, size, ease}]`. Até 12. Ordem do array = empilhamento: acima do vídeo e do zoom, abaixo do ASS (legenda, gancho, textos, chat). **Não entra na capa** | +| `reframe` | `{keys: [{t, cx, cy, w, ease: smooth\|linear\|hold}]}`, até 60, `t` em tempo da sessão, `cx`/`cy`/`w` (0,05–1) absolutos no quadro original; a altura sai da área do jogo do layout do trecho (nunca distorce). Com keys, `layout.game` é ignorado; não vale em `cam_only`; no `blur`, `game_only` e horizontal ocupa a tela toda. A capa usa a janela parada do instante dela | +| `chat` | chat da live na tela: `enabled` (padrão `false`), `x` 0–0,9 (borda esquerda), `y` 0,1–0,98 (base do bloco), `width` 0,25–0,96, `lines` 1–10, `size` 18–64, `showUser`. `chat_events` redesenha o bloco a cada mensagem; ele some 9 s depois da última (`CHAT_HOLD_S`) | +| `cover.atStart` | a capa também cobre os 2 primeiros quadros do MP4 (0 s). Exige `cover.enabled`; `render_clip_edit` gera a capa antes do vídeo e a passa como `cover_file`. `preview-render` também põe a capa quando `fromS` = 0 | + +**Editar com a mão** (arrastar e aparar palavra, deslizar e dividir trecho, mover texto/legenda/chat no monitor, +marcar a câmera só daquele corte): tabela "Mexer com a mão" do README; componentes e atalhos em +[panel.md](panel.md#editor-de-cortes). + +Limites do editor (lista completa em "Limitações" do README): +- **Uma trilha de vídeo só, sem B-roll.** A timeline é o tempo da sessão: um pedaço não vai para outra camada nem + toca fora da ordem da gravação. Não prometa reordenar trechos. +- A prévia do Programa é um canvas; a exata é `preview-render` (no formato do corte). Legenda e recorte de câmera/jogo + já saem como no render: blocos por `cleanWords`/`groupWords`/`captionBlocks` (porte de `subtitles.py`, constantes em + `CAPTION_TIMING` de `clip-editor-model.ts`) e recorte por `ffmpegCropFill` (arredondamento par do FFmpeg, tamanho da + gravação de `session.capture`). **Mudou constante ou regra em `subtitles.py`, ou a cadeia `layout_chain`, mude o + porte junto.** Tarja a ~2 px do render (informado). +- Reenquadramento no 9:16 com câmera em cima: a área do jogo é 1080×1268 (proporção ~0,85), então um inventário 16:10 + não cabe inteiro; a janela mostra no máximo 0,48 da largura. No 16:9 cabe. +- Custo medido (corte 61, 60 s, NVENC): sem nada 6,1–6,2 s; com reenquadramento 7,1–9,5 s; com reenquadramento + + 2 camadas 15,8–20,5 s. +- Campo novo (`cam_only`, `muted`, `chat`, `cover.atStart`, texto com `x`, `style`/`font` do gancho, `reframe`, `inset`) + só vale no serviço reiniciado (gotchas, item 73). + +Rotas (todas com `X-Service-Key`; todas na regex `ALLOWED`): + +| Rota | Faz | +|---|---| +| `GET/PUT/DELETE /v1/clips/{id}/edit` | projeto; PUT manda `rev` e recebe 409 se outro salvou antes | +| `POST …/proxy` `{lo,hi}` · `GET …/waveform?lo=&hi=` | prévia 480p (`-g 15`) e forma de onda (50 picos/s) da janela | +| `POST …/preview-render` `{fromS, durationS ≤ 10, project?}` | prévia real de poucos segundos | +| `POST …/export` | volta para a fila de render → `ready` | +| `POST …/retranscribe` `{startS, endS}` (≤ 90 s) | Whisper de novo no trecho | +| `POST …/tts` `{text, voice, speed}` | narração pelo serviço de voz (4510) | +| `POST …/suggest` | IA (`Judge.ask`) sugere gancho, título, início/fim, trechos mortos e zooms | + +Teste local do editor sem tocar no serviço do usuário: instância na faixa 4500–4599 (ex.: 4521) sobre **cópia** do +banco, com as regras do item 77 de [gotchas.md](gotchas.md). Teste de UI no painel do usuário sobre um corte real: +intercepte as escritas (item 86) e ache as camadas do canvas pelo cursor (item 85). + +## Perfil do jogo (aba Jogos) + +Toda rota abaixo devolve a lista inteira (mesma forma de `GET /v1/games`). + +| Rota | Faz | +|---|---| +| `GET /v1/games` | perfis com `status`, `model`, `researchedAt`, `editedAt`, `notes` (`[{text, at, section?}]`) e `profile` | +| `POST /v1/games/{id}/research` | refaz o perfil do zero pela web (`RESEARCH_TIMEOUT_S` 420); os pedidos guardados entram no prompt | +| `PUT /v1/games/{id}` | grava o perfil editado à mão: `name`, `summary`, `genre`, `mechanics`, `clip_worthy`, `avoid`, `jargon`, `news`, `hashtags`, `sources` | +| `POST /v1/games/{id}/refine` | `{instruction, search, section, history}` → `{games, reply}`. `instruction` 3–1500 caracteres; `search` padrão `true` (`false` = sem web, `TIMEOUT_S` 240); `section` `""` \| `summary` \| `clip_worthy` \| `avoid` \| `mechanics` \| `news` \| `jargon` \| `hashtags` \| `sources` (`Literal` em `GameRefineIn` de `main.py`, inválido dá 422); `history` `[{role: "user"\|"ai", text ≤1500}]`, máx. 20. A IA devolve o perfil inteiro + `reply` (1–2 frases do que mudou); guarda o pedido (com `section`) e marca `edited_at` | +| `DELETE /v1/games/{id}/notes/{index}` | esquece um pedido guardado (o perfil atual fica como está) | + +- `clean_profile` (`intel.py`) normaliza tudo que entra: apara, tira vazios e duplicados, no máximo 20 itens por lista. + São guardados os últimos 30 pedidos. +- **Pedido guardado sobrevive a "Pesquisar de novo"** (`research_game(name, title, notes)`; `PROFILE_SYSTEM` manda + priorizar os pedidos sobre a pesquisa). **Edição à mão não sobrevive.** Por isso o painel pede confirmação + quando há `editedAt`. Para algo durar, prefira o pedido à IA. +- Refino (`judge.py`): `refine_game(name, profile, instruction, search, section, history)` usa `REFINE_SCHEMA` + (= `PROFILE_SCHEMA` + `reply`) e `PROFILE_SECTIONS` (chave → título). A IA vê só os últimos 8 turnos do + `history`, 400 caracteres cada. `REFINE_SYSTEM` manda mexer só na seção em foco e transformar pedido genérico + em item concreto ("reação do streamer conta" → "Streamer grita, xinga ou ri alto logo depois de uma morte ou fuga"). + `Intel.refine(...)` (`intel.py`) devolve `(profile, reply)`. +- Painel (`clipper-games.tsx`): o cabeçalho tem selo de iniciais e os botões "Conversar com a IA" (perfil inteiro), + "Editar" (uma linha por item) e "Pesquisar de novo". Cada seção é um cartão com "Pedir à IA", que abre o chat + daquela seção (`AiChat`: Enter envia, Shift+Enter quebra linha, chave "Confirmar na web" **desligada** por + padrão no painel, embora a API use `search=true` por padrão). Item recém-acrescentado aparece com selo "novo". + "Memória da IA" lista os pedidos guardados (com a seção) e tem X. A conversa só existe enquanto o chat está + aberto. O que fica salvo é o pedido. Tipo `Game` em `panel/src/components/clipper-client.ts` + (`editedAt?`, `notes?[].section?`). Detalhes visuais em [panel.md](panel.md). + +## Regras + +- **Aprovar publica** nas redes dos canais de publicação ligados à fonte (pelo despachante do painel; aprovar vale + para todas as redes). O painel marca o corte `published` quando todos os jobs dele saíram. Exportar no editor + volta o corte para `pending` e cancela os jobs ainda não enviados (voltam quando o corte fica pronto de novo). + Regras em [publishing.md](publishing.md). Corte aprovado **sem fonte ligada** (ou em outra rede) sai pelo botão + **"Publicar"** do cartão (`clip-publish.tsx`; em `published` vira "Publicar em outra rede"): ver publishing.md. +- **Direitos autorais.** Todo corte leva o crédito do canal. Marque `authorized` nos canais que autorizaram. +- Mudança de código em `clipper/app/` só entra no ar depois de reiniciar o serviço. O `scripts/dev.ts` sobe o + uvicorn sem `--reload` (gotchas, itens 53 e 73). O painel é do usuário, então peça a ele que reinicie — e só com a + suíte verde: reinício no meio de uma edição carrega código intermediário (gotchas, item 87). Agente que edita o + serviço trabalha numa cópia e aplica em `clipper/app/` por **edição pontual**, nunca sobrescrevendo o arquivo + inteiro: vários agentes e outras sessões mexem em `clipper/` ao mesmo tempo. +- Nada de rede (APIs de emotes, CLI) na thread do chat: use `EmoteCatalog.cached()` e baixe em thread à parte + (gotchas, item 72). +- Subprocesso sem shell. A CLI do Codex é chamada pelo `codex.js` (gotchas, item 28). + +## Testes e evidência + +Os testes não chamam a CLI de IA: `FakeJudge.ask` (`clipper/tests/test_sources_and_api.py`) sempre falha, e o serviço +segue pelo caminho de "IA fora". Juiz falso novo precisa cobrir `ask` também. + +Hashtags da legenda (17/11/2026): `pnpm test:clipper` → **278 passed** (reexecutado nesta manutenção; bate com o +informado). Testes novos em `clipper/tests/test_hashtags.py`. O perfil do ROB RUN no banco ainda não tem `hashtags` +(informado; não conferido no banco). + +Apagar cortes, veto do rejeitado, varredura contada e prévia igual ao render (17/11/2026): +- `pnpm test:clipper` → **270 passed** (medido na 1.29.1; o coordenador informou 269 — o disco já tinha outro teste + novo; na 1.29.0 eram 268). Testes novos: `test_clip_delete.py` (14); em `test_render_and_duplicates.py`, veto do + rejeitado, contagem da varredura e `test_queue_cleanup_uses_the_same_veto_as_the_judge` (limpeza da fila). +- `npx tsc --noEmit -p panel` → exit 0, sem erro (medido nesta manutenção; o lote informou erros de outra sessão em + `montage-editor.tsx`/`lib/montage*.ts`, já resolvidos quando rodei). +- Banco real `data/clipper/clipper.db` em `user_version` 10 (lido só para leitura nesta manutenção). +- Informado: diagnóstico "não sai corte" da sessão 3 (README, "Armadilhas já resolvidas"; gotchas, item 114); + legenda do painel em 22 conferências contra o Python; teste de ponta a ponta no corte 61 (projeto montado no editor, + capturado do PUT interceptado, render por `editor_render.render_project`) com enquadramento, inserção e legenda + iguais em 2/3,5/5/6,5/8 s; observador só leitura depois da retomada (01:30–01:46): corte 68 pronto e aprovado, + 69 e 70 descartados, 71 pronto em 8 s. + +Duração mínima, tarja do gancho, fontes, reenquadramento, camadas e qualidade de gravação (17/11/2026): +- `pnpm test:clipper` → **251 passed** (medido nesta manutenção; bate com o informado). Testes novos: + `test_duration_banner_fonts.py` (19), `test_reframe_insets.py` (10), `test_capture_quality.py` (17). +- `npx tsc --noEmit -p panel` → exit 0 (medido nesta manutenção; uma 1ª rodada deu erro em `confirm-dialog.tsx`, + de outro trabalho que ainda estava sendo escrito, e passou depois que ele terminou). +- Informado: medições de render, disco e nitidez acima e no README; prévia da tarja a ≤ ~2 px do render; interpolação + do painel × `reframe.py` em 41 conferências. + +Formato horizontal, legenda com fala rápida, retomada, render que falha e duplicados (17/11/2026): +- `pnpm test:clipper` → **170 passed** e `npx tsc --noEmit -p panel` → exit 0, ambos medidos nesta manutenção (o lote + informou 169; o disco já tinha mudanças de outro lote em andamento). Testes novos: `test_format_and_captions.py`, + `test_resume.py`, `test_render_and_duplicates.py`; o vertical bate com o SHA de referência + (`tests/data/vertical_golden_sha256.json`). +- Informado: render horizontal real 1920×1080 conferido no ffprobe; legenda medida numa cópia do banco (3 projetos, + sessão 3 do skipnho): 63 de 286 eventos sobrepostos antes, 0 de 299 depois (README, "Tempo da legenda"). +- Informado: capturas por CDP com as escritas interceptadas — modal "Configuração do corte" em 1920×1080 e 1366×768; + aba Sessões sem mudança de posição/altura entre atualizações automáticas. + +Redesenho do editor e camadas novas (16/11/2026): +- `pnpm test:clipper` → 136 passed na época e `npx tsc --noEmit -p panel` → exit 0. + `clipper/tests/test_editor_layers.py` (6 testes): projeto antigo ganha os padrões, `cam_only` enche a tela, + `mode`/`muted` sobrevivem sem juntar, texto com `x` e bloco de chat no ASS, capa no início, e um render real pelo + FFmpeg com as camadas novas. +- Informado pelo coordenador, Chrome sem janela por CDP em `/clipper/edit/25` do painel, com as escritas + interceptadas (nada gravado): palavra aparada pela direita 34→21 px e pela esquerda 21→12 px com a outra borda + parada; mover −6 px com a largura igual; clique simples não move; Ctrl+Shift+clique divide (1→2 trechos) e Ctrl+Z + desfaz; marcar a câmera mudou a área de "21% × 24% em 2%, 43%" para "25% × 35% em 5%, 45%"; câmera inteira e chat + na tela aparecem na prévia. + +Rastreio de reação (16–17/11/2026): +- `cd clipper; .venv\Scripts\python -m pytest` → 120 passed na época (2 execuções seguidas); + `npx tsc --noEmit -p panel` limpo (informado). Versões instaladas no `clipper/.venv` conferidas (ver tools.md); + os 4 pesos já estão em `data/clipper/models/`. +- `doc/FACE_BAKEOFF.md` (cópia do banco, sessão 3 do skipnho): MediaPipe achou rosto em 97,8–100 % dos quadros dos 6 + trechos, 5–7 ms/quadro; bloco de 30 s em 1,47 s de média (p95 2,05 s); 144/144 blocos `done`, rosto em 85,1 % dos quadros; + após calibração 114 picos, 0 no trecho calmo, 0 cortes novos de fonte `face`, 14 dos 21 momentos do chat com + `reasons.face`. **O rosto não separou aprovados de descartados** nos cortes 10–13 — por isso é só reforço. + +Rastreio de reação ao vivo (16–17/11/2026; seção "Testes de 17/11 — ao vivo" de `doc/FACE_BAKEOFF.md`): +- `cd clipper; .venv\Scripts\python -m pytest` → 170 passed e `npx tsc --noEmit -p panel` → exit 0 (conferidos + nesta manutenção). +- Download real dos 4 modelos para pasta vazia (0,28–0,91 s cada), sha256 conferido, nenhum `.part`; sha256 errado e + URL 404 → `FaceUnavailable` com `.part` apagado; arquivo corrompido → baixado de novo. +- Plano B OpenSeeFace com pesos reais × MediaPipe (sessão 3, blocos 54/66/80): rosto 96,7–100 % × 94,4–100 %; + 12,3–13,9 × 9,8–13,2 ms/quadro (FFmpeg + modelo ÷ 180); `size` do OSF ~18 % menor; OSF dá sinal 0 (sem picos, sem erro). +- Serviço real, instância 4521, twitch.tv/skipnho (sessão 90001, 722 s, 25 blocos, juiz `off`): câmera `yunet` em + 12/12 quadros, confiança 0,864; 25/25 `done`, atraso de 0–1 bloco; 1,71 s/bloco (p95 2,20 s) com gravação + + transcrição + chat juntos; fim do bloco → rosto gravado 1,4–9,4 s; CPU média 16,8 % de um núcleo, pico 90 % na + reconstrução após reset; rosto em 99,8 % dos segundos; `GET …/face` 200; `POST …/face/reset` 200 (ocioso) / 202 + (bloco em andamento), refez 19 blocos em ~45 s; 2 cortes do chat, um com `reasons.face` grito z 12,7 (o outro, + decidido durante a reconstrução, sem rosto, como desenhado). Queda do `start.bat` no meio → sessão retomada sozinha. +- twitch.tv/lofigirl (sem câmera, sessão 90002): falso positivo achado e corrigido (gotchas, item 92); refeito → + `hasWebcam: false`, 8 blocos `no_cam`. +- Painel em 127.0.0.1:4500/clipper sem erro de console; selo, interruptor e chip de reação vistos só com respostas GET + alteradas no navegador (o serviço do usuário rodava o código antigo). + +Editor de cortes, 1ª versão (16/11/2026): +- `pnpm test:clipper` → 120 passed na época. +- Informado pelo coordenador, instância de teste em 127.0.0.1:4521 sobre cópia do banco (sessão 3 do skipnho, já + derrubada e cópia apagada): tempos na tabela "Medido" do README; export do corte 9 editado (início −20 s, 2 trechos + removidos, legenda `pop` com palavra trocada e ênfase, gancho com caixa, zoom 1,5×, barra) = 55,6 s H.264 + 1080×1920 30 fps + AAC em ~9 s; corte 10 rejulgado pela IA real → projeto da IA → MP4 33,8 s em 24 s; quadros + inspecionados; editor em tela cheia no Chrome sem janela sem rolagem nem erro de console; `pnpm typecheck` e + `npx tsc --noEmit -p panel` limpos. + +Chat por seção do perfil (16/11/2026, informado pelo coordenador, IA simulada em banco temporário): `refine` +com `section=clip_worthy` acrescentou o item, devolveu `reply`, recebeu 2 turnos de histórico e salvou a nota com +`section`; seção inválida recusada pelo pydantic; `tsc --noEmit` do painel limpo; `import app.main` ok; captura +de `localhost:4500/clipper?tab=jogos` com o chat aberto em "O que rende corte". **IA real não testada** (serviço +não reiniciado). + +Perfil editável do jogo (informado pelo coordenador, banco temporário): migração até `user_version` 7, +`save_profile` deduplicou lista, `refine` guardou o pedido e marcou `edited_at`, a pesquisa recebeu as notas, +`delete_note` limpou; `tsc --noEmit` do painel limpo; `import app.main` ok. O serviço no ar precisa ser reiniciado +para migrar (o banco real estava em v4). + +Fase 2 (17/11/2026): +- `pnpm test:clipper` → 46 passed (sem rede, juiz falso); `pnpm typecheck` e `npx tsc --noEmit -p panel` limpos. + Conferido nesta manutenção. +- Informado pelo coordenador, numa cópia do banco da live do skipnho (chat de ~0,15 msg/s): + - jogo ROB RUN pela categoria e perfil pesquisado (~15–35 s por jogo); + - webcam achada no canto inferior esquerdo (~5 s); render `cam_top` de 59 s inspecionado; + - varredura de 2 janelas sem falso positivo (~7 s por janela com `gpt-6-luna`); + - corte do lag: título "O lag jogou ele em três lugares ao mesmo tempo", `lag_ou_bug`, confiança 0,93, início + recuado 35 s, ~18 s nos dois juízes. + +Fase 1 (16/11/2026, `twitch.tv/alanzoka`, sessão 2): 21 blocos (617,97 s), 490 mensagens, 4 cortes do chat aprovados +pelo `codex:gpt-6-luna` (notas 7,4–8,5) e 1 manual (nota 3,0) renderizado; `clip-4.mp4` H.264 1080×1920 + AAC. + +Não verificado: +- hashtags: juiz e pesquisa de jogo com a CLI real (o campo `hashtags` do veredito e do perfil); UI da seção "Hashtags" + contra o serviço reiniciado; +- apagar: rota no serviço real do usuário; arquivo em uso no Windows (deve voltar em `left`); pedido do editor em + andamento gravando em `edit-/` depois de apagar; relógio da sessão com movimento reduzido, aba escondida e + larguras de 1024/1280; a faixa do topo em `clipper-studio.tsx` ainda mostra o `durationS` real (sem o relógio); +- duração, gancho, reenquadramento, camadas e captura: live 2K real e HEVC real da Twitch pela captura; gravação longa + em 1080p ou 2K com o serviço real; juiz e varredura reais com as durações novas; render real de um projeto feito no + editor com reenquadramento e camadas comparado com a prévia (pendente, depois do reinício do serviço); camadas na + capa (não entram por desenho); +- formato e retomada: juízes, varredura e "IA sugere" com a CLI real depois da mudança de prompts; retomada automática + contra live real; horizontal com NVENC e com fonte que não é 16:9; corte horizontal de ponta a ponta numa live; + gravação real do `format` pelo modal (as escritas foram interceptadas); +- editor: música e efeitos com arquivo real (não há áudio em `assets/`; só o filtergraph em teste unitário); + arrastes com mouse humano (só por CDP, e nem todos: deslizar o corpo do clipe, arrastar texto/zoom/narração na + timeline, mover texto/gancho/legenda/chat no Programa, "Editar"/"Ocultar" da transcrição, "Salvar projeto" e + minimizar painéis não têm medição registrada); export real pelo serviço do usuário (4520) de um projeto com + `cam_only`, `muted`, `chat` ou `cover.atStart` — as escritas do teste de UI foram interceptadas, e o serviço + precisa ser reiniciado para o código novo e a migração v7 (gotchas, item 73); +- rastreio de reação: câmera em tela cheia, escura ou minúscula; GPU; live > 15 min (`LIVE_WINDOW_S` 900 s não foi + ultrapassada); a linha "Rosto do streamer" chegando ao juiz analista ao vivo (juiz `off` no teste); interação real + com o interruptor `faceTrack` contra o serviço novo (só com respostas simuladas no navegador); câmera que muda de + lugar no meio da live. O serviço do usuário só pega a correção do `min_cam_score` depois de reiniciar o `start.bat`; +- editar/refinar perfil pela UI contra o serviço reiniciado; `refine` com IA real (com e sem `search`); +- a UI nova (modal do corte, aba Jogos e emotes) contra o serviço novo no ar — o serviço do usuário ainda roda o + código antigo; +- juiz com a CLI do Claude (analista, editor, varredura, câmera e pesquisa); +- chat da Kick e lives do YouTube ponta a ponta; VOD; render com NVENC. diff --git a/.claude/skills/cenaforge/references/gotchas.md b/.claude/skills/cenaforge/references/gotchas.md new file mode 100644 index 0000000..29dd41d --- /dev/null +++ b/.claude/skills/cenaforge/references/gotchas.md @@ -0,0 +1,701 @@ +# Armadilhas conhecidas + +Cada item: **sintoma → causa → correção → onde está tratado**. Observadas na implementação da +prova de conceito com Godot 4.7.2 / FFmpeg 7.1.1 / pnpm 11.22 (16/11/2026). Registro formal em +`doc/TEST_RESULT.md`: itens 1–5, 7, 13–15, 17 e 18; itens 30–33 estão em `voice/README.md` +("GPU e CPU"); itens 57–61 estão em `clipper/README.md` ("Armadilhas já resolvidas"); itens 74–76, 87–90 e 103–108 também estão lá e o 78 na seção "Limitações" do editor; itens 79, 81–84 e 92–95 estão em `doc/FACE_BAKEOFF.md` (o 93 também em "Variáveis" de `clipper/README.md`) (o 80, no comentário de `clipper/requirements.txt`); itens 118–128 (publicação) seguem `doc/publicacao/` e o código; itens 129–132 foram informados em 17/11/2026 e conferidos no código (`doc_main.gd`, `doc/godot/cenas.md`) e no banco (`agent_runs` 5, 7 e 8); itens 62–67, 77, 85–86, 91, 99–102, 109–112 e as ampliações do 52, do 44, 77, 86 e 87 foram informados em 16–17/11/2026 (não estão em `doc/TEST_RESULT.md`); os demais vieram de erros de compilação ou instalação durante a implementação. +Ao descobrir uma nova, registre aqui via `cenaforge-skill-updater`. Os números são estáveis +(outros textos os citam): item novo entra na seção do assunto com o próximo número livre. + +## Render (Godot Movie Maker) + +1. **Primeiro quadro diferente** (azulado, sombra diagonal errada). + Causa: sombras e radiância do céu ainda não prontas no 1º quadro. + Correção: 3 quadros de aquecimento em t = 0, descartados com `-start_number 3`. + Onde: `--warmup-frames` em `main.gd`; `render.ts` passa `-start_number`. + +2. **`delta` não é 1/fps** mesmo com `--fixed-fps` (0,025; 0,0333; 0,0417…). + Correção: tempo da cena = contador de quadros / fps. Nunca use `delta` em render. + Onde: `_process_render` em `main.gd`. + +3. **Resolução do filme travada na inicialização.** `--resolution` e `content_scale_size` em + runtime não mudam o arquivo; janela de 1080×1920 não cabe numa tela de 1080 px. + Correção: `godot/override.cfg` temporário com o viewport do perfil e janela menor + (stretch `viewport`, aspect `keep`). A cena aborta (código 3) se o viewport ≠ config. + Onde: `render.ts` escreve/remove o arquivo; checagem em `main.gd`. + Consequência: render manual sem o lançador só sai em 540×960. + +4. **`--write-movie` relativo grava em `godot/`, e falha em silêncio.** Com a pasta + inexistente, nenhum PNG é gravado e a Godot sai com código 0 dizendo "Done recording". + Correção: caminho absoluto; o lançador confere os PNGs; `main.gd` aborta se a pasta não existe. + Lição: log de sucesso não prova nada — confira arquivos. + +5. **Quantidade de quadros.** Chamar `quit()` no `_process` do último quadro ainda grava esse + quadro: total de PNGs = aquecimento + fps × duração, índices contínuos a partir de 0, + padrão `frame%08d.png`, mais `frame.wav` (silencioso, descartado). + +6. **Modo `--headless` não renderiza 3D válido.** Use só para validação, testes e preparação + de assets. O render abre uma janela e precisa de backend gráfico. + +7. **Custo do render é a codificação PNG** (~105 ms/quadro em 540×960, ~404 ms em 1080×1920), + não a GPU. Não prometa tempo sem medir. + +110. **Cena do documentário (`doc2d`/`doc3d`) reprovada como "quadro preto" ou "moto não termina no ponto".** Causa: as + checagens do lançador eram da rua — o fundo escuro do documentário (#0d0d10) tem luma ≈ 13, abaixo do piso 20 + (`MIN_AVERAGE_LUMA`), e não há moto. Correção: com `kind` `doc2d` ou `doc3d`, `render.ts` pula a checagem da moto e usa + `MIN_AVERAGE_LUMA_DOC2D` = 4. Fundo novo mais escuro que isso → ajuste o piso, não desligue a checagem. +129. **Render de cena `doc3d` não termina e enche a pasta de PNGs** (17/11/2026: 39 mil quadros, "apply em Nil" em laço). + Causa: `template.gd` com erro de compilação; o protocolo seguia sem a cena. Correção: `doc_main.gd` carrega o script + na validação e, se `can_instantiate()` falha, sai com `SCENE_SCRIPT_INVALID` (código 2, `EXIT_INVALID_CONFIG`); os + `Parse Error` com a linha ficam no `render.log` do run. No render, cena sem `setup`/`apply` também sai com + `SCENE_SCRIPT_INVALID`. Se um render antigo travar assim: encerre a Godot **e** o lançador e apague + `output/.render.lock`. Erros de GDScript mais comuns: itens 9 e 130. + +## GDScript (Godot 4.7) e TypeScript do lançador + +8. **`class_name` depende do cache do editor.** O projeto roda sem importação prévia; use + `const X := preload(...)`. +9. **`var x := dicionario.campo + 1.0`** não compila (tipo não inferível a partir de Variant). Idem + `var x := dict.get("k")`, `var p := nodes[i]` e retorno de método de kit chamado por variável tipada como `Node3D`. + Declare o tipo (`var x: float = ...`) ou use `=`. +10. **Comparar valor não-objeto com `null`**: prefira `typeof(v) == TYPE_NIL`. +11. **`quit()` é adiado para o fim do quadro**: depois de chamar, marque um sinalizador + (`_halted`) para o `_process` seguinte não rodar com estado incompleto. +12. **Dentro de comentário de bloco TypeScript, `*/`** (ex.: `godot-*/`) encerra o comentário. +130. **"shadows a native class"**: constante com nome de classe do Godot (`const Sky := preload(...)`, `Camera3D`, + `Environment`) não compila. Use outro nome (`SkyRig` em `godot/library/castaways/template.gd`). Guia: "Testar" em + `doc/godot/cenas.md`. + +## Composição visual + +13. Título longo quebra linha: o rótulo cresce para cima (alinhado embaixo) para não invadir as + opções. Reserve ~18% inferior livre para a interface da plataforma. +14. No fim do plano, câmera baixa (~1,1 m) com leve inclinação para baixo põe o entregador na + metade superior e mantém o horizonte; câmera alta deixa o texto cobrindo o personagem. +15. Borda do plano do morro vira linha reta no céu: a cumeeira de volumes irregulares resolve. +16. Câmera lateral perto dos postes (x = meia pista + 0,5 m): mantenha ≥ 1 m de folga no offset. +17. Rodas: a ~4 m/s giram ~26°/quadro; acima de 30°/quadro a simetria de 60° dos raios pode + causar efeito estroboscópico. +111. **Espuma do mar desenhada por elipse não acompanha a costa** (anel regular em volta de uma ilha irregular). + Causa: a elipse no shader do mar ignora o contorno real do terreno. Correção: removida; a cor turquesa perto da + costa já marca a transição. Espuma futura precisa seguir a altura do terreno, não uma forma fixa. Onde: + `_build_ocean` em `godot/library/island/template.gd`. + +## Ferramentas + +18. **`pnpm doctor`** é comando nativo do pnpm 11 → use `pnpm run doctor`. +19. **pnpm 11 bloqueia scripts de instalação** não aprovados (erro `ERR_PNPM_IGNORED_BUILDS`). + O `esbuild` está recusado em `pnpm-workspace.yaml` (`allowBuilds: esbuild: false`) e funciona assim. +20. **pnpm repassa o `--`** para o script; o parser do lançador ignora um `--` solto. +21. Executável principal da Godot (não o `_console.exe`) escreve stdout em pipe normalmente; + use-o para poder encerrar a árvore com `taskkill /T`. +44. **Heredoc ou `node -e "..."` no Bash do agente quebra com barra invertida e aspas** (`\\` vira `\`; escapes como + `\b` de regex se perdem; às vezes o script inteiro falha). Em 17/11/2026 um `node -e` com regex quebrou o build do + painel duas vezes. Texto com barra invertida (caminhos Windows, `package.json`, regex) ou + script com aspas aninhadas: edite com Edit/Write, ou grave o script num arquivo (scratchpad) com + Write e execute o arquivo, nunca inline. + +## Painel + +22. **Portas:** o CenaForge usa a faixa **4500–4599** (painel = 4500). A 3100 já é de outro + aplicativo nesta máquina. `EADDRINUSE` = porta ocupada: escolha outra da faixa, nunca + encerre o processo alheio. +23. **Node não executa `.cmd`/`.bat` sem shell** (ex.: `pnpm.cmd`). O painel chama o lançador + como `node node_modules/tsx/dist/cli.mjs scripts/cli.ts render …` e procura só `.exe`. +24. **Next.js 16.4** vem com `cacheComponents` ligado; o painel desliga (dados sempre dinâmicos) + e chama `connection()` antes de ler o SQLite. `params` de página/rota é `Promise`. +25. **Script `.ts` dentro de `panel/`** roda como CommonJS (sem `"type": "module"`): para + `await` no topo, use `.mts`. +26. **`claude -p` reclama de stdin** se a entrada não for fechada: o painel usa `stdio: ["ignore", …]`. +27. **Codex fora de repositório Git** recusa rodar sem `--skip-git-repo-check`. `codex exec resume` + não aceita `--sandbox` nem `-C`: use `-c sandbox_mode="workspace-write"` e o cwd do processo. +28. **Shims do npm no Windows** (`codex`, `codex.cmd`, `codex.ps1`): o sem extensão é script de + shell e o `.cmd` exige shell. O painel (`agents.ts`) e o juiz do Clipador (`clipper/app/judge.py`) + executam `node /bin/codex.js`. +29. **Ruído das CLIs no stderr.** Codex: configuração pessoal do usuário (`~/.codex/config.toml`, + servidor MCP fora do ar) e "Codex is ignoring N unrecognized configuration setting"; Claude Code: + `[claude-code:unrecognized_model]` para id fora da lista interna dele (ex.: `claude-fable-5-2`), mas + o modelo roda normalmente. O painel filtra esses padrões (`STDERR_NOISE` em `panel/src/lib/agents.ts`); + os avisos de configuração do Codex chegam como item `error`, exibidos como nota. +42. **Ícone some no menu recolhido:** SVG dentro de flex encolhe a 0 px ao lado de texto + `nowrap`. Correção: `shrink-0` nos ícones (`panel/src/components/icons.tsx`). +43. **Grade na barra lateral cresce até a largura do texto.** Correção: `flex-col` + `min-w-0` + (`panel/src/components/sidebar-nav.tsx`). +48. **Nó do `@xyflow/react` 13 não responde a clique** sem `onNodeClick` no canvas. + Correção: o clique sobe até o nó e é tratado no `onNodeClick` (`components/story-flow.tsx`). +49. **Foco dentro do canvas rola o contêiner** e desalinha a árvore. Correção: `onScrollCapture` + desfaz a rolagem e `setCenter` traz o nó focado para a vista (`story-flow.tsx`). +50. **Grade sem `grid-cols-1` estoura no celular** (colunas implícitas crescem até o conteúdo). + Correção: declarar `grid-cols-1` na base e as colunas extras só nos breakpoints. +51. **Mudança de esquema não aparece no painel em dev** (ex.: v4 → criar história documental falha no + CHECK de `stories.kind`). Causa: a conexão do SQLite fica em `globalThis.__cenaforgeDb` + (`panel/src/lib/db.ts`) e a migração só rodava ao abrir o banco. Hoje a marca `checkedThisModule` faz a 1ª + chamada de `db()` depois da recarga do código migrar o banco aberto (item 138); se o `db.ts` não foi recarregado, + faça uma requisição ao painel ou peça ao usuário que reinicie o `pnpm panel` (é dele: não reinicie você). Conferir: + `PRAGMA user_version` do `data/cenaforge.db` = `MIGRATIONS.length`. +52. **`tsx` com `await` no topo** exige arquivo `.mts`, e o import de módulo local precisa de URL + `file:///` (caminho Windows cru com `C:\` ou `f:/` não é URL e falha no loader ESM). Node puro não resolve + import `.ts` sem extensão: rode pelo tsx da raiz, `node node_modules/tsx/dist/cli.mjs