A jornada câmera → agente → foto → 3D → humano animado

Varredura da costura, não dos projetos. Outros tópicos avaliam cada repositório; aqui a obra avaliada é a linha de montagem inteira, e as notas são da JORNADA como peça única. Medida pela régua em REGUA.md. Escrita em 01/10/2026, sobre o trabalho de 30/09. Leitura só: nada foi alterado em nenhum repositório avaliado.

O desenho: jornada.svg — abra primeiro. Ele é o instrumento; este texto é a legenda.

1. A metáfora em uma frase

A jornada é uma linha de montagem de oficina onde um corpo humano é lido de um vídeo, peças são moldadas a partir de fotos, e as duas coisas se encontram numa bancada onde o humano é vestido osso por osso.

A metáfora é real, operante e física — e não é de ninguém. Cada estação a tem por conta própria, e nenhum documento da casa enuncia a linha inteira. O arquivo que mais perto chega é asset-pipeline-dashboard/docs/processos/montar-humano.md, que descreve o processo de montar um humano mas não a jornada que o alimenta: ele começa em "o founder manda fotos" e não menciona o vídeo, o mocap nem o pacote de humano como entradas da mesma obra.

Dentro de cada estação a metáfora é das mais fortes da casa:

• video-mocap é uma esteira de leitura do corpo, e cada estágio é uma pasta de verdade: captura/, juizo/, maos/, rosto/, limpeza/, pacote/, porta/, teto/. O desfecho de cada quadro é vocabulário do projeto — BOM / REPARADO / LACUNA (README.md:30-34).
• asset-pipeline-dashboard é o acervo: esteira.js, oficina.js, lixeira.js, ceu.js, corpo-canonico.js, peca-de-humano.js, galeria-publica.js, routes/porta.js. Cada módulo declara o objeto físico na primeira linha útil.
• tool-snippets é a bancada com moradores: t.js é "o cola", as ferramentas são "moradores" (README.md:21), e f/ é ferramentas.
• almost-humanoid é o contrato do corpo e o tocador, com vocabulário físico na camada que atravessa fronteira (canonical-bones.js, envelope/pecas.js, ragdoll.js, stride.js).
• ez3d é a exceção: tem vocabulário de domínio em português (acervo.js, descricao.js, pedidoLeves.js, maquina.js) e nenhuma metáfora central. Não há molde, não há câmara, não há bancada. O gesto físico que define o projeto — fotografar um objeto e ganhar a forma dele — não tem nome em lugar nenhum do código.

A consequência da metáfora não ter dono: as emendas desta jornada não são defeitos de nenhum dos projetos. Cada um fez a sua parte bem, em sua própria oficina, e a linha que as liga não é propriedade de ninguém — nenhum repositório tem um documento, um teste ou um módulo cuja matéria seja a jornada. Isso explica quase todos os achados abaixo: os contratos são bons, as fronteiras são limpas, e o que falha é sempre a costura, que não tem autor.

2. Notas

Notas da jornada como obra, não de cada projeto.

Soma: 24 / 30.

O medidor de cinco segundos, código próprio (vendor e node_modules fora):

Jornada inteira: 11 arquivos com nome de abstração em 821 de código próprio. É o número mais baixo que a casa produziu, e sustenta a nota 3 em fisicalidade.

A camada que puxou o resultado para baixo é a B — o alcance. Os critérios 3 e 4 somam 4 de 6 possíveis, e a razão é a mesma nos dois: a metáfora e o vocabulário são fortes dentro de cada estação e governam pouco entre elas. A camada D confirma: o desenho fechou, mas só com fios vermelhos exatamente nas emendas.

Uma nota sobre como estas notas foram fechadas. Rodei um avaliador adversarial contra a primeira versão desta tabela, com instrução de contestar. Ele derrubou três notas minhas, com evidência que eu conferi e aceitei: linguagem ubíqua (eu dei 1 e não vi três gates de vocabulário que existem e rodam), coesão (eu dei 2 contando como gaveta cinco diretórios que o .gitignore exclui — artefato de bancada não é arquitetura) e contradições (eu dei 1 sem contar quantas têm precedência escrita). Três afirmações minhas eram factualmente falsas e estão corrigidas na seção

1. A soma subiu de 21 para 24, e a correção é do avaliador, não do terreno.

3. O desenho

jornada.svg — a linha de montagem em quatro faixas (a entrada, as duas esteiras, o acervo, a saída), com as sete emendas marcadas em vermelho.

Regras seguidas: cada caixa é um objeto do mundo; cada fio é uma ligação que existe no código, rotulada com o que passa (o vídeo, a foto, o pacote, a malha, as peças, o humano, o item); fio vermelho tracejado é ligação que o desenho precisou e o código não tem; fio cinza pontilhado é dependência documental (lida, não importada).

4. Onde o desenho não fechou

Esta é a seção mais valiosa, e aqui a arquitetura confessa três coisas.

Peça sem corpo — uma, e é a mais importante da jornada.

A própria linha de montagem não tem corpo. Não existe repositório, módulo, documento ou teste cuja matéria seja a jornada inteira. Ela existe como fato operacional — foi exercida o dia 30/09 inteiro — e não existe como peça. Não desenhei caixa cinza para ela porque ela não é uma caixa: é o chão em que as outras estão, e esse chão não está em lugar nenhum. Todas as sete emendas são consequência disso.

Ligações que o código não tem — três, e estão no desenho em vermelho.

1. Do anexo à esteira. O vídeo que o founder manda chega ao agente como URL, e a foto como caminho local — agnts/supercli/src/format-history.js:88, com a razão escrita (vídeo pesa até 200 MB e o agente raramente precisa dos bytes). A ferramenta que remenda isso existe e é boa: video-mocap/fila/do-topico.mjs baixa o vídeo do tópico e o deposita na entrada. Mas nada a chama: os únicos chamadores no repositório são um teste e o README. O gatilho é o julgamento do agente. (Ressalva honesta: fila/ está formalmente aposentada — ver seção 5 —, então esta ferramenta é de mão por decisão, não por esquecimento. O fio continua vermelho porque a capacidade que ela cobre, "vídeo largado na conversa entra na linha", não migrou para a esteira.)
2. Da peça ao acervo, com escala. O desenho precisa de um fio levando a escala real do objeto fotografado, e ele não existe: o motor de reconstrução normaliza toda peça para caixa de lado 1 antes do ez3d ver o arquivo, e não há campo de escala original em nenhum dos dois repositórios.
3. Do humano de volta ao editor. O editor de montagem está construído e o contrato está provado dos dois lados, e eles não se tocam: tool-snippets/site/base/acervo.js:78 exporta sessaoDeEdicao e nenhum arquivo a chama.

Peça invisível — uma, e é do orquestrador vivo.

O agendador da esteira. O produto promete o gesto "grava uns segundos no celular, larga, e de manhã está pronto", e a janela 01:00–07:00 está codificada. Mas quem acorda à 01:00 não está em lugar nenhum da jornada. A própria esteira o invoca sem o ter — video-mocap/esteira/esteira.mjs:443: "UMA RODADA sobre todos os trabalhos da raiz. É o que um agendador chama." Grepei cron, systemd, timer, agendador em esteira/, entrada/, did.json e server.js: não existe.

O agravante é que havia um e ele foi removido com boa razão: entrada/da-porta.mjs:13-22 conta que a porta tinha um timer de cinco minutos dentro do próprio processo do servidor, e que esse timer era um segundo orquestrador com lista de etapas própria. Tirá-lo foi acertado; o substituto ficou fora do repositório. O desenho da jornada tem uma seta que entra na esteira vindo de fora da folha.

Uma segunda, menor: o runner de provas pesadas (heavy run --gate) que video-mocap/x/PROVAS.md usa é peça de infraestrutura da casa que o desenho das provas precisa e que não vive em repositório nenhum da jornada.

5. Contradições

Internas (dentro de uma estação)

Nenhuma relevante. É notável e merece ser dito: as contradições desta jornada são todas de fronteira. Cada estação é internamente coerente.

Com os vizinhos

As silenciosas — três. São as que custam.

(a) Dois implementadores do contrato do humano, e o dono não é quem monta. Tipo 1.

• almost-humanoid/docs/CCP-MANIFEST-1.4.md:146-148: "O validador mora aqui […] É o que 'o dono do contrato de humano é o almost-humanoid' quer dizer na prática: o acervo importa a regra daqui em vez de reimplementá-la."
• asset-pipeline-dashboard/scripts/monta-boneco-de-massinha.js:91-94: importa fs, os, path, ../src/oficina. Zero import do almost-humanoid. A leitura do manifesto é reimplementada em src/humano.js e a validação de forma em src/peca-de-humano.js.

Quem deveria ganhar: o almost-humanoid, porque ele já declarou a posse e já escreveu o validador. Mas a promessa não é cumprível hoje por um motivo estrutural que ninguém nomeou: o almost-humanoid é "private": true e não declara exports; só o subpacote packages/player é importável, e o contrato (src/envelope/) está fora dele — confirmado: packages/player/src/proporcao-runtime.js não importa src/envelope/ uma única vez. O contrato não tem porta de saída. É isso que precisa nascer primeiro.

Já custou uma vez: pecas.ossos, escrito pelo acervo, era recusado pelo próprio contrato da casa com PECAS_FIELD_UNKNOWN — "o manifest publicado do boneco de massinha era recusado pelo próprio contrato da casa" (CCP-MANIFEST-1.5.md:278-284).

(b) Um campo de contrato que ninguém escreve e ninguém lê — e ele é o meta, não a procedência. Tipo 2.

• almost-humanoid/src/envelope/manifest.js:420-425 e :447 — anim.library[].meta criado e validado.
• video-mocap/pacote/montar.mjs:309-318 — a entrada da biblioteca escreve name, clip, fps, duration, pack, category, rootMotion. Sem meta. A procedência por clipe segue na extensão privada extensions.LUDID_video_mocap (montar.mjs:369-372), que o almost-humanoid não conhece (zero ocorrências em src/, packages/, tools/).

O relato que pediu isso foi fechado quando a spec criou o campo (CONTRATO.md:385), e a costura não mexeu em nenhuma das pontas. Quem deveria ganhar: o campo oficial, e a dívida já está declarada em CONTRATO.md:360-363.

Correção de uma afirmação que eu fiz e estava errada. Eu havia escrito que o procedencia.json é "lido por ninguém". Não é, e em duas camadas. Existem dois arquivos diferentes com esse nome na jornada: o do ez3d, que o acervo ingere como peça dado do item (acervo/src/ferramentas.js:85-89 — "é o que permite auditar de onde um modelo veio sem ter que voltar ao banco do EZ3D"; a rota em src/routes/ferramentas.js:131-144, provado em test/integracao-ez3d-sync.js:177); e o do video-mocap, que é lido dentro do próprio projeto por teto/medir.py:80, para saber se um refino já foi aplicado antes de medir. Esse leitor nasceu de um incidente que vale citar, porque é o oposto de dívida: medir um pacote já refinado e chamar o resultado de cru produziu um número publicado falso (1,93 cm contra os 2,85 reais), e medir.py:66-77 registra isso — "Medida que engana é pior que medida ausente." O que de fato não atravessa a fronteira é a procedência por clipe rumo ao anim.library[].meta, que é a contradição acima.

(c) Um sinônimo inventado na emenda, que não vem de ninguém. Tipo 5.

• asset-pipeline-dashboard/src/humano.js:314 — (entrada.encaixe || entrada.fit), e adiante e.pos ?? e.position, e.quat ?? e.rotation, e.escala ?? e.scale.
• Nenhum produtor da casa escreve fit, position, rotation ou scale nesse lugar — procurei em almost-humanoid, video-mocap, ez3d, tool-snippets e no próprio acervo. Nenhuma versão do CCP os define.

Quem deveria ganhar: o português, que é o contrato. O alias em inglês é tolerância defensiva contra um emissor que não existe, e tem custo medido: o tool-snippets lê só a forma portuguesa (site/bancada/bancada.js:97), então um humano escrito na forma fit seria lido pelo acervo e invisível para o editor.

As declaradas — com razão escrita e precedência. São oito, e é por elas que o critério 10 fica em 2 e não em 1.

E duas que não são contradição, e merecem registro invertido.

O gate do osso que cede. A regra "um clipe não pode animar a translação de um osso que a proporção move" é executável em três lugares com severidade decrescente, e a graduação é argumentada: acervo/scripts/monta-boneco-de-massinha.js:637-641 lança e aborta a montagem; almost-humanoid/src/envelope/proporcao.js:545-552 lança PROPORCAO_OSSO_ANIMADO com escopo maior; packages/player/src/proporcao-runtime.js:609-634 apenas avisa, porque "o player recebeu um glb que já está no ar, e derrubar o humano inteiro por um conflito entre dois campos dele deixaria o host sem nada na tela" (:598-602). Severidade que decresce conforme o dado se afasta de quem pode consertá-lo é o melhor padrão de fronteira da casa, e é o modelo das ações abaixo.

O gate cruzado de contrato, que existe e eu afirmei que não existia. acervo/test/contrato-em-dia.js lê o schema canônico de outro repositório do disco — e, quando o disco não o tem, da URL publicada no $id da própria cópia, explicitamente porque "na VM e em qualquer CI o teste PULAVA — passava verde sem ter conferido nada, que e o pior estado possivel pra uma sentinela". Compara caminho e valor campo a campo, nomeia o caminho exato do que divergiu e sai com código 1. Roda no corredor (test/corredor.js:81). Nasceu de um incidente datado de 27/08/2026, em que três campos divergiram em silêncio. Esse gate é o molde pronto para a ação 5.

6. Ações propostas

Ordenadas por nota que movem por hora gasta. As três primeiras constroem gate; é deliberado.

O que deliberadamente não propus: ligar o editor de montagem (emenda 7). Não é dívida arquitetural — é trabalho de produto em curso, e o próprio editor declara que está esperando escolha de layout, com uma frase que merece ser política da casa: "Uma ferramenta que parece pronta e não salva é pior que uma que avisa" (tool-snippets/site/f/editor-de-humano/index.html:19-20). Também não propus agendar do-topico.mjs: é decisão de operação, não de arquitetura.

7. O que eu não consegui avaliar

• A porta do agnts por dentro. O repositório agnts está numa pasta compartilhada com outra sessão em voo nesta máquina. Li format-history.js e composer.js (leitura é liberada e segura), mas não rodei nada contra ele nem conferi o estado da árvore — o que está em format-history.js:88 eu dou como certo por ser leitura direta, e não afirmo nada sobre o resto.
• A jornada em execução. Avaliei o código e os registros, não rodei a linha de ponta a ponta. As afirmações sobre o que acontece em produção vêm do que o código e os docs dizem, inclusive os números medidos por quem os escreveu.
• almost-mocap e almost3d. Aparecem no mapa de dialetos de osso (são dois dos cinco) mas não estão na jornada: almost-mocap está 4 meses sem commit e almost3d não tem costura com nenhuma estação. Entraram no relatório só como contagem; não os avaliei como peças da linha.
• O lado do clag. A jornada toca o clag como consumidor final do pacote (vendor/clag/ no almost-humanoid, o protocolo de componente), e isso é assunto de outra varredura. Não o abri.