primocode 8.9.1 → 8.10.1

package/studio/arquivos/traco-estatico-traco-25872.json

@@ -0,0 +1,113 @@
+{
+  "id": "traco-estatico-traco-25872",
+  "ferramenta": "traco",
+  "titulo": "estatico-traco",
+  "doc": {
+    "tema": "meia-noite",
+    "largura": 1920,
+    "altura": 1080,
+    "cenas": [
+      {
+        "layout": "livre",
+        "fundo": "pontos",
+        "elementos": [
+          {
+            "id": "ped",
+            "tipo": "no",
+            "texto": "Pedido aberto",
+            "x": 120,
+            "y": 480,
+            "l": 320,
+            "a": 140,
+            "destaque": true,
+            "anim": "nenhuma"
+          },
+          {
+            "id": "val",
+            "tipo": "no",
+            "texto": "Validação\nfiscal",
+            "x": 620,
+            "y": 480,
+            "l": 320,
+            "a": 140,
+            "anim": "nenhuma"
+          },
+          {
+            "id": "ger",
+            "tipo": "no",
+            "texto": "Aprovação\ngerência",
+            "x": 1120,
+            "y": 300,
+            "l": 320,
+            "a": 140,
+            "anim": "nenhuma"
+          },
+          {
+            "id": "dir",
+            "tipo": "no",
+            "texto": "Aprovação\ndiretoria",
+            "x": 1120,
+            "y": 660,
+            "l": 320,
+            "a": 140,
+            "anim": "nenhuma"
+          },
+          {
+            "id": "ok",
+            "tipo": "no",
+            "texto": "Compra\nemitida",
+            "x": 1560,
+            "y": 480,
+            "l": 280,
+            "a": 140,
+            "destaque": true,
+            "anim": "nenhuma"
+          },
+          {
+            "tipo": "conector",
+            "de": "ped",
+            "para": "val",
+            "anim": "nenhuma"
+          },
+          {
+            "tipo": "conector",
+            "de": "val",
+            "para": "ger",
+            "texto": "até R$ 20 mil",
+            "anim": "nenhuma"
+          },
+          {
+            "tipo": "conector",
+            "de": "val",
+            "para": "dir",
+            "texto": "acima de R$ 20 mil",
+            "anim": "nenhuma"
+          },
+          {
+            "tipo": "conector",
+            "de": "ger",
+            "para": "ok",
+            "anim": "nenhuma"
+          },
+          {
+            "tipo": "conector",
+            "de": "dir",
+            "para": "ok",
+            "anim": "nenhuma"
+          },
+          {
+            "tipo": "texto",
+            "x": 120,
+            "y": 120,
+            "l": 900,
+            "a": 120,
+            "texto": "Compras · fluxo vigente",
+            "papel": "chapeu",
+            "anim": "nenhuma"
+          }
+        ]
+      }
+    ]
+  },
+  "atualizado": "2026-08-16T15:08:28+00:00"
+}

package/studio/arquivos/traco-sweep-traco-0bcf4.json

@@ -0,0 +1,102 @@
+{
+  "id": "traco-sweep-traco-0bcf4",
+  "ferramenta": "traco",
+  "titulo": "sweep-traco",
+  "doc": {
+    "tema": "meia-noite",
+    "largura": 1920,
+    "altura": 1080,
+    "cenas": [
+      {
+        "layout": "livre",
+        "fundo": "pontos",
+        "elementos": [
+          {
+            "id": "ped",
+            "tipo": "no",
+            "texto": "Pedido aberto",
+            "x": 120,
+            "y": 480,
+            "l": 320,
+            "a": 140,
+            "destaque": true
+          },
+          {
+            "id": "val",
+            "tipo": "no",
+            "texto": "Validação\nfiscal",
+            "x": 620,
+            "y": 480,
+            "l": 320,
+            "a": 140
+          },
+          {
+            "id": "ger",
+            "tipo": "no",
+            "texto": "Aprovação\ngerência",
+            "x": 1120,
+            "y": 300,
+            "l": 320,
+            "a": 140
+          },
+          {
+            "id": "dir",
+            "tipo": "no",
+            "texto": "Aprovação\ndiretoria",
+            "x": 1120,
+            "y": 660,
+            "l": 320,
+            "a": 140
+          },
+          {
+            "id": "ok",
+            "tipo": "no",
+            "texto": "Compra\nemitida",
+            "x": 1560,
+            "y": 480,
+            "l": 280,
+            "a": 140,
+            "destaque": true
+          },
+          {
+            "tipo": "conector",
+            "de": "ped",
+            "para": "val"
+          },
+          {
+            "tipo": "conector",
+            "de": "val",
+            "para": "ger",
+            "texto": "até R$ 20 mil"
+          },
+          {
+            "tipo": "conector",
+            "de": "val",
+            "para": "dir",
+            "texto": "acima de R$ 20 mil"
+          },
+          {
+            "tipo": "conector",
+            "de": "ger",
+            "para": "ok"
+          },
+          {
+            "tipo": "conector",
+            "de": "dir",
+            "para": "ok"
+          },
+          {
+            "tipo": "texto",
+            "x": 120,
+            "y": 120,
+            "l": 900,
+            "a": 120,
+            "texto": "Compras · fluxo vigente",
+            "papel": "chapeu"
+          }
+        ]
+      }
+    ]
+  },
+  "atualizado": "2026-08-16T15:07:33+00:00"
+}

package/studio/ferramentas/corte.md

@@ -3,6 +3,68 @@
 No lugar de CapCut, Premiere e After Effects. Modelo `cena`, com `duracao` em cada
 cena, trilha sonora, transições e gravação em `.webm`.
 
+<!-- O EXEMPLO FICA NO COMEÇO DE PROPÓSITO: quando o plano de tokens é
+apertado, o agente recebe só os primeiros ~3500 caracteres desta spec. Um
+vídeo inteiro saiu PRETO porque o formato do documento estava depois do
+corte e o agente inventou a estrutura. Formato primeiro; detalhe depois. -->
+
+## Exemplo completo
+
+```json
+{
+  "ferramenta": "corte",
+  "titulo": "Reels — por que sua conta de luz subiu",
+  "doc": {
+    "tema": "brasa",
+    "largura": 1080, "altura": 1920,
+    "acabamento": "grao",
+    "trilha": { "tipo": "gerada", "estilo": "pulso", "volume": 0.7 },
+    "cenas": [
+      { "layout": "centro", "duracao": 3, "fundo": "aurora", "transicao": "flash",
+        "elementos": [
+          { "tipo": "texto", "papel": "titulo", "texto": "Sua conta subiu\nde novo.",
+            "tamanho": 124, "estilo": "gradiente", "anim": "desfoque" }]},
+
+      { "layout": "centro", "duracao": 3, "fundo": "vinheta", "transicao": "limpar",
+        "elementos": [
+          { "tipo": "texto", "papel": "titulo", "texto": "E não foi o seu chuveiro.",
+            "tamanho": 78, "estilo": "marcador", "anim": "palavra" }]},
+
+      { "layout": "centro", "duracao": 4, "transicao": "zoom", "acabamento": "vinheta",
+        "fundo": { "imagem": "/midia/torre.jpg", "escurecer": 0.5 },
+        "elementos": [
+          { "tipo": "numeros", "contar": true, "anim": "saltar", "tamanho": 180,
+            "itens": ["+38% | bandeira tarifária em 12 meses"] }]},
+
+      { "layout": "livre", "duracao": 4, "transicao": "deslizar",
+        "elementos": [
+          { "tipo": "imagem", "src": "/midia/campo.jpg", "x": 0, "y": 0,
+            "l": 1080, "a": 1920, "raio": 0, "movimento": "aproximar", "filtro": "contraste" },
+          { "tipo": "forma", "forma": "retangulo", "x": 0, "y": 1180, "l": 1080, "a": 740,
+            "preenchimento": "rgba(10,5,6,.72)" },
+          { "tipo": "texto", "x": 90, "y": 1320, "l": 900, "a": 420,
+            "texto": "O custo está\nna transmissão", "tamanho": 104, "peso": 750,
+            "estilo": "sombra", "anim": "cortina" }]},
+
+      { "layout": "centro", "duracao": 5, "fundo": "raios", "transicao": "subir",
+        "elementos": [
+          { "tipo": "lista", "revelar": true, "tamanho": 52, "intervalo": 0.9,
+            "itens": ["Linhas saturadas no Nordeste",
+                      "Usina gerando sem escoar",
+                      "A conta chega em quem consome"] }]},
+
+      { "layout": "centro", "duracao": 3, "fundo": "brilho", "transicao": "fade",
+        "acabamento": "luz",
+        "elementos": [
+          { "tipo": "texto", "papel": "titulo", "texto": "Segue para\nentender a próxima.",
+            "tamanho": 96, "estilo": "contorno-tom", "anim": "elastico" }]}
+    ]
+  }
+}
+```
+
+---
+
 ## Como pensar um vídeo curto
 
 Um Reels de 30 s são 7 a 9 cenas de 3 a 5 segundos. A regra é dura:
@@ -152,63 +214,6 @@ Em `lista`, `"revelar": true` distribui os itens dentro da duração da cena;
 
 ---
 
-## Exemplo completo
-
-```json
-{
-  "ferramenta": "corte",
-  "titulo": "Reels — por que sua conta de luz subiu",
-  "doc": {
-    "tema": "brasa",
-    "largura": 1080, "altura": 1920,
-    "acabamento": "grao",
-    "trilha": { "tipo": "gerada", "estilo": "pulso", "volume": 0.7 },
-    "cenas": [
-      { "layout": "centro", "duracao": 3, "fundo": "aurora", "transicao": "flash",
-        "elementos": [
-          { "tipo": "texto", "papel": "titulo", "texto": "Sua conta subiu\nde novo.",
-            "tamanho": 124, "estilo": "gradiente", "anim": "desfoque" }]},
-
-      { "layout": "centro", "duracao": 3, "fundo": "vinheta", "transicao": "limpar",
-        "elementos": [
-          { "tipo": "texto", "papel": "titulo", "texto": "E não foi o seu chuveiro.",
-            "tamanho": 78, "estilo": "marcador", "anim": "palavra" }]},
-
-      { "layout": "centro", "duracao": 4, "transicao": "zoom", "acabamento": "vinheta",
-        "fundo": { "imagem": "/midia/torre.jpg", "escurecer": 0.5 },
-        "elementos": [
-          { "tipo": "numeros", "contar": true, "anim": "saltar", "tamanho": 180,
-            "itens": ["+38% | bandeira tarifária em 12 meses"] }]},
-
-      { "layout": "livre", "duracao": 4, "transicao": "deslizar",
-        "elementos": [
-          { "tipo": "imagem", "src": "/midia/campo.jpg", "x": 0, "y": 0,
-            "l": 1080, "a": 1920, "raio": 0, "movimento": "aproximar", "filtro": "contraste" },
-          { "tipo": "forma", "forma": "retangulo", "x": 0, "y": 1180, "l": 1080, "a": 740,
-            "preenchimento": "rgba(10,5,6,.72)" },
-          { "tipo": "texto", "x": 90, "y": 1320, "l": 900, "a": 420,
-            "texto": "O custo está\nna transmissão", "tamanho": 104, "peso": 750,
-            "estilo": "sombra", "anim": "cortina" }]},
-
-      { "layout": "centro", "duracao": 5, "fundo": "raios", "transicao": "subir",
-        "elementos": [
-          { "tipo": "lista", "revelar": true, "tamanho": 52, "intervalo": 0.9,
-            "itens": ["Linhas saturadas no Nordeste",
-                      "Usina gerando sem escoar",
-                      "A conta chega em quem consome"] }]},
-
-      { "layout": "centro", "duracao": 3, "fundo": "brilho", "transicao": "fade",
-        "acabamento": "luz",
-        "elementos": [
-          { "tipo": "texto", "papel": "titulo", "texto": "Segue para\nentender a próxima.",
-            "tamanho": 96, "estilo": "contorno-tom", "anim": "elastico" }]}
-    ]
-  }
-}
-```
-
----
-
 ## No modo Abrir
 
 Toca sozinho ao carregar, com barra de transporte embaixo:

package/studio/server.py

@@ -9,6 +9,7 @@ Só biblioteca padrão do Python. Nada para instalar.
 """
 
 import base64
+import hashlib
 import functools
 import json
 import mimetypes
@@ -30,6 +31,19 @@ FERRAMENTAS = os.path.join(RAIZ, "ferramentas")
 MIDIA = os.path.join(RAIZ, "midia")
 PORTA = int(sys.argv[1]) if len(sys.argv) > 1 else 7777
 
+def _assinatura():
+    """SHA-1 do próprio arquivo, lido NA SUBIDA. Se o npm trocar o código no
+    disco depois, o processo no ar continua respondendo a assinatura antiga —
+    e é exatamente essa diferença que o CLI usa para saber que precisa
+    reiniciar o Studio em vez de servir a versão velha para sempre."""
+    try:
+        with open(os.path.abspath(__file__), "rb") as fh:
+            return hashlib.sha1(fh.read()).hexdigest()[:12]
+    except Exception:
+        return "?"
+
+ASSINATURA = _assinatura()
+
 # 60 MB por arquivo: cobre faixa longa em mp3 e foto de câmera sem susto
 LIMITE_MIDIA = 60 * 1024 * 1024
 
@@ -244,6 +258,17 @@ def criar(dados):
     if doc is not None and not isinstance(doc, dict):
         raise ValueError("doc precisa ser um objeto")
 
+    # ── O doc torto não pode virar arquivo ───────────────────────────────
+    # Quem cria é um agente de IA, e quando ele não viu a spec ele INVENTA a
+    # estrutura. Antes o arquivo era gravado assim mesmo: o player não achava
+    # cena nenhuma e o "vídeo" saía uma tela preta — o usuário viu exatamente
+    # isso. Recusar com o formato certo na mensagem transforma o erro mudo em
+    # correção na rodada seguinte.
+    if doc:
+        problema = validar_doc(POR_SLUG[ferramenta]["modelo"], doc)
+        if problema:
+            raise ValueError(problema)
+
     arq_id = ferramenta + "-" + slugify(titulo) + "-" + uuid.uuid4().hex[:5]
     return gravar({
         "id": arq_id,
@@ -253,6 +278,41 @@ def criar(dados):
     })
 
 
+def validar_doc(modelo, doc):
+    """None quando o doc serve; senão, a frase que ENSINA o formato certo.
+
+    A mensagem repete a estrutura mínima de propósito: ela volta para o agente
+    como resultado da tool, e é a única chance de ele se corrigir sem o
+    usuário ver um vídeo preto."""
+    if modelo == "cena":
+        cenas = doc.get("cenas")
+        if not isinstance(cenas, list) or not cenas:
+            return ('doc sem "cenas". O formato é: {"tema":"...", "cenas":[{"layout":"centro",'
+                    '"duracao":3,"elementos":[{"tipo":"texto","texto":"..."}]}]}. '
+                    'Leia studio_spec da ferramenta e refaça.')
+        for i, c in enumerate(cenas):
+            if not isinstance(c, dict):
+                return "cena %d não é um objeto" % (i + 1)
+            els = c.get("elementos")
+            if not isinstance(els, list) or not els:
+                return ('cena %d sem "elementos". Cada cena precisa de elementos:[...] — '
+                        'ex.: {"tipo":"texto","texto":"..."}. Leia studio_spec e refaça.' % (i + 1))
+            for j, e in enumerate(els):
+                if not isinstance(e, dict) or not e.get("tipo"):
+                    return 'elemento %d da cena %d sem "tipo" (texto, imagem, lista, numeros, forma...)' % (j + 1, i + 1)
+    elif modelo == "documento":
+        blocos = doc.get("blocos")
+        if not isinstance(blocos, list) or not blocos:
+            return ('doc sem "blocos". O formato é: {"tema":"papel","blocos":[{"tipo":"titulo",'
+                    '"texto":"..."},{"tipo":"paragrafo","texto":"..."}]}. Leia studio_spec e refaça.')
+    elif modelo == "planilha":
+        abas = doc.get("abas")
+        if not isinstance(abas, list) or not abas:
+            return ('doc sem "abas". O formato é: {"abas":[{"nome":"...","colunas":[...],'
+                    '"linhas":[[...]]}]}. Leia studio_spec e refaça.')
+    return None
+
+
 def exemplo(ferramenta):
     """Documento inicial de cada ferramenta — o mínimo que já fica bonito."""
     if ferramenta == "prosa":
@@ -460,6 +520,9 @@ class Handler(SimpleHTTPRequestHandler):
                     texto = fh.read()
             return self.txt(texto or json.dumps(info, ensure_ascii=False, indent=2))
 
+        if p == "/api/versao":
+            return self.js({"assinatura": ASSINATURA})
+
         if p == "/api/voz":
             return self.voz(urlparse(self.path).query)
         if p == "/api/voz/status":
@@ -706,6 +769,16 @@ class Handler(SimpleHTTPRequestHandler):
             corpo, status = guardar_midia(self.corpo())
             return self.js(corpo, status)
 
+        if rota == "/api/sair":
+            # Só o CLI chama, e só quando o código no disco mudou (update do
+            # npm). Sem isto o processo antigo ficava no ar servindo o bug que
+            # o update tinha acabado de corrigir. Responde antes de morrer,
+            # para quem pediu não ver erro de conexão.
+            self.js({"ok": True, "tchau": ASSINATURA})
+            import threading
+            threading.Thread(target=lambda: (time.sleep(0.3), os._exit(0)), daemon=True).start()
+            return
+
         if rota == "/api/arquivos":
             try:
                 a = criar(self.corpo())