primocode 7.17.0 → 8.0.0

package/bin/primocode.js

@@ -119,12 +119,11 @@ function completarSlash(line) {
 // Régua com os níveis, o marcador ▲ embaixo do escolhido, "Faster" à
 // esquerda e "Smarter" à direita. ←/→ move, Enter confirma, Esc cancela.
 
-function desenharEffort(idx) {
+// O layout sai em texto PLANO, com as marcas de onde pintar. Assim os dois
+// pintores (o normal e o do ultracode animado) desenham exatamente a mesma
+// régua — sem duas contas de posição para manter em sincronia.
+function layoutEffort(idx) {
     const cols = Math.max(52, Math.min(process.stdout.columns || 100, 104));
-    const regua = '▔'.repeat(cols);
-    const linhas = [];
-
-    // Cada nível ocupa uma coluna própria; o ultracode fica destacado no fim.
     const rotulos = effort.NOMES;
     const larguras = rotulos.map((n) => Math.max(n.length + 3, 9));
     const posicoes = [];
@@ -134,38 +133,130 @@ function desenharEffort(idx) {
         x += larguras[i];
     }
     const fimRegua = x;
-
-    linhas.push(c.dim(regua));
-    linhas.push('   ' + c.bold(c.white('Effort')));
-    linhas.push('');
-
-    // Faster ....▲.... Smarter — a trilha, com o marcador na posição atual.
     const marca = posicoes[idx];
+
     let trilha = '';
     for (let k = 23; k < fimRegua; k++) {
-        if (k === marca) trilha += c.brand('▲');
-        else if (k === fimRegua - 12) trilha += c.dim('┆');       // ultracode é um degrau à parte
-        else trilha += c.dim(k < marca ? '─' : '─');
+        if (k === marca) trilha += '▲';
+        else if (k === fimRegua - 12) trilha += '┆';   // ultracode é um degrau à parte
+        else trilha += '─';
     }
-    linhas.push('                       ' + c.muted('Faster') + ' '.repeat(Math.max(1, fimRegua - 23 - 6 - 7)) + c.muted('Smarter'));
-    linhas.push('                       ' + trilha);
 
-    // Os nomes, o escolhido aceso.
-    let linhaNomes = ' '.repeat(23);
+    let nomes = ' '.repeat(23);
+    let deNome = 0, ateNome = 0;
     for (let i = 0; i < rotulos.length; i++) {
         const nome = rotulos[i];
-        const espaco = larguras[i];
-        const pad = Math.floor((espaco - nome.length) / 2);
-        const texto = i === idx ? c.bold(c.brand(nome)) : c.muted(nome);
-        linhaNomes += ' '.repeat(pad) + texto + ' '.repeat(espaco - nome.length - pad);
+        const pad = Math.floor((larguras[i] - nome.length) / 2);
+        if (i === idx) { deNome = nomes.length + pad; ateNome = deNome + nome.length; }
+        nomes += ' '.repeat(pad) + nome + ' '.repeat(larguras[i] - nome.length - pad);
     }
-    linhas.push(linhaNomes);
 
     const nivel = effort.nivelDe(rotulos[idx]);
-    linhas.push('                       ' + c.dim(nivel.resumo));
-    linhas.push('');
-    linhas.push('   ' + c.muted('←/→ ajusta · Enter confirma · Esc cancela'));
-    return linhas.join('\n');
+    const vaoExtremos = Math.max(1, fimRegua - 23 - 6 - 7);
+
+    return {
+        cols,
+        marca,
+        destaque: { de: deNome, ate: ateNome },
+        linhas: [
+            { tipo: 'regua',    texto: '▔'.repeat(cols) },
+            { tipo: 'titulo',   texto: '   Effort' },
+            { tipo: 'vazio',    texto: '' },
+            { tipo: 'extremos', texto: ' '.repeat(23) + 'Faster' + ' '.repeat(vaoExtremos) + 'Smarter' },
+            { tipo: 'trilha',   texto: ' '.repeat(23) + trilha },
+            { tipo: 'nomes',    texto: nomes },
+            { tipo: 'resumo',   texto: ' '.repeat(23) + nivel.resumo },
+            { tipo: 'vazio',    texto: '' },
+            { tipo: 'ajuda',    texto: '   ←/→ ajusta · Enter confirma · Esc cancela' },
+        ],
+    };
+}
+
+// ── O brilho do ultracode ────────────────────────────────────────────────
+// No nível máximo o painel inteiro ganha um fundo roxo que ondula, como no
+// Claude Code. São faixas verticais de roxo em brilhos diferentes; a onda
+// anda para o lado a cada quadro, e o texto fica branco por cima.
+//
+// Roxos do cubo de 256 cores, ordenados pelo brilho REAL (luminância), do
+// mais escuro ao mais claro — a onda escolhe um deles por faixa. Fora da
+// lista ficaram os roxos escuros que puxam para o vinho (53-56): quebravam a
+// família violeta. Só 256 cores (não truecolor): funciona em qualquer
+// terminal, inclusive no Terminal.app do macOS.
+const ROXOS = [57, 92, 93, 63, 98, 99, 105, 141];
+
+function fundoRoxo(x, fase) {
+    // Duas ondas de períodos diferentes: o encontro delas dá o desenho
+    // irregular de faixas, em vez de listras repetidas e óbvias.
+    const faixa = Math.floor(x / 2);
+    const onda = Math.sin(faixa * 0.55 + fase) * 0.6 + Math.sin(faixa * 0.17 - fase * 0.7) * 0.4;
+    const i = Math.round((onda + 1) / 2 * (ROXOS.length - 1));
+    return ROXOS[Math.max(0, Math.min(ROXOS.length - 1, i))];
+}
+
+// Pinta a linha inteira (até a largura do painel) com a onda por baixo.
+// `destaque` é o trecho que fica branco e forte (o nível escolhido); o resto
+// da linha sai num lilás claro, para o escolhido saltar aos olhos.
+function pintarLinhaUltra(texto, largura, fase, opts = {}) {
+    const base = opts.base || 231;      // branco
+    const apagado = opts.apagado || base;
+    const destaque = opts.destaque;
+    let saida = '';
+    let corFundo = -1;
+    let corTexto = -1;
+    let forte = null;
+
+    for (let x = 0; x < largura; x++) {
+        const fundo = fundoRoxo(x, fase);
+        if (fundo !== corFundo) { saida += `\x1b[48;5;${fundo}m`; corFundo = fundo; }
+
+        const dentro = destaque && x >= destaque.de && x < destaque.ate;
+        const querForte = opts.negrito || dentro;
+        const querCor = dentro ? base : apagado;
+        if (querForte !== forte) { saida += querForte ? '\x1b[1m' : '\x1b[22m'; forte = querForte; }
+        if (querCor !== corTexto) { saida += `\x1b[38;5;${querCor}m`; corTexto = querCor; }
+
+        saida += texto[x] || ' ';
+    }
+    return saida + '\x1b[0m';
+}
+
+function desenharEffort(idx, fase) {
+    const L = layoutEffort(idx);
+    const ultra = effort.NOMES[idx] === 'ultracode';
+
+    if (ultra) {
+        // No ultracode o painel todo vira fundo animado. Cada linha é pintada
+        // com a MESMA onda, então as faixas ficam alinhadas de cima a baixo.
+        const LILAS = 189;   // lilás bem claro, para o que não é o escolhido
+        return L.linhas.map((l) => {
+            if (l.tipo === 'titulo') return pintarLinhaUltra(l.texto, L.cols, fase, { negrito: true });
+            if (l.tipo === 'nomes') return pintarLinhaUltra(l.texto, L.cols, fase, { destaque: L.destaque, apagado: LILAS });
+            if (l.tipo === 'resumo' || l.tipo === 'extremos') return pintarLinhaUltra(l.texto, L.cols, fase, { base: LILAS, apagado: LILAS });
+            return pintarLinhaUltra(l.texto, L.cols, fase, {});
+        }).join('\n');
+    }
+
+    return L.linhas.map((l) => {
+        const t = l.texto;
+        switch (l.tipo) {
+            case 'regua': return c.dim(t);
+            case 'titulo': return c.bold(c.white(t));
+            case 'extremos': return c.muted(t);
+            case 'trilha': {
+                // O marcador aceso, o resto da trilha recuada.
+                const antes = t.slice(0, L.marca);
+                const depois = t.slice(L.marca + 1);
+                return c.dim(antes) + c.brand('▲') + c.dim(depois);
+            }
+            case 'nomes': {
+                const { de, ate } = L.destaque;
+                return c.muted(t.slice(0, de)) + c.bold(c.brand(t.slice(de, ate))) + c.muted(t.slice(ate));
+            }
+            case 'resumo': return c.dim(t);
+            case 'ajuda': return c.muted(t);
+            default: return t;
+        }
+    }).join('\n');
 }
 
 // Desenha, escuta as setas, e devolve o nome escolhido (ou null se cancelou).
@@ -177,21 +268,38 @@ function sliderEffort(atual) {
         }
         let idx = effort.indiceDe(atual);
         const ALTURA = 9;   // linhas que o desenho ocupa — para redesenhar por cima
+        let fase = 0;
+        let anima = null;
 
         const pintar = (primeira) => {
             if (!primeira) process.stdout.write(`\x1b[${ALTURA}A\r`);
-            process.stdout.write(desenharEffort(idx).split('\n').map((l) => '\x1b[2K' + l).join('\n') + '\n');
+            process.stdout.write(desenharEffort(idx, fase).split('\n').map((l) => '\x1b[2K' + l).join('\n') + '\n');
         };
+
+        // O fundo do ultracode ondula; sair dele apaga a animação na hora, para
+        // não redesenhar sozinho um painel que já está parado.
+        const cuidarDaAnimacao = () => {
+            const ultra = effort.NOMES[idx] === 'ultracode';
+            if (ultra && !anima) {
+                anima = setInterval(() => { fase += 0.32; pintar(false); }, 90);
+                anima.unref();
+            } else if (!ultra && anima) {
+                clearInterval(anima); anima = null;
+            }
+        };
+
         pintar(true);
+        cuidarDaAnimacao();
 
         const aoTeclar = (ch, key) => {
             if (!key) return;
-            if (key.name === 'right' || key.name === 'l') { idx = Math.min(effort.NOMES.length - 1, idx + 1); pintar(false); return; }
-            if (key.name === 'left' || key.name === 'h') { idx = Math.max(0, idx - 1); pintar(false); return; }
+            if (key.name === 'right' || key.name === 'l') { idx = Math.min(effort.NOMES.length - 1, idx + 1); cuidarDaAnimacao(); pintar(false); return; }
+            if (key.name === 'left' || key.name === 'h') { idx = Math.max(0, idx - 1); cuidarDaAnimacao(); pintar(false); return; }
             if (key.name === 'return' || key.name === 'enter') { encerrar(effort.NOMES[idx]); return; }
             if (key.name === 'escape' || (key.ctrl && key.name === 'c')) { encerrar(null); return; }
         };
         const encerrar = (valor) => {
+            if (anima) { clearInterval(anima); anima = null; }
             process.stdin.removeListener('keypress', aoTeclar);
             sliderAtivo = false;
             resolve(valor);

package/lib/catalogo.js

@@ -53,6 +53,18 @@ const GRUPOS = [
             { tool: 'open_in_browser',    escreve: false, faz: 'abre no seu navegador normal, sem controlar' },
         ],
     },
+    {
+        nome: 'Estúdio',
+        resumo: 'a suíte de criação do PrimoCode — sobe sozinha, não precisa de app externo',
+        itens: [
+            { tool: 'studio_manual',    escreve: false, faz: 'lê o manual do estúdio e as seis ferramentas' },
+            { tool: 'studio_spec',      escreve: false, faz: 'lê a spec de uma ferramenta (prisma, tela, prosa…)' },
+            { tool: 'studio_criar',     escreve: false, faz: 'cria slides, arte, documento, planilha, vídeo ou diagrama' },
+            { tool: 'studio_ler',       escreve: false, faz: 'lê algo que já foi criado' },
+            { tool: 'studio_atualizar', escreve: false, faz: 'ajusta o que já existe, sem refazer do zero' },
+            { tool: 'studio_listar',    escreve: false, faz: 'lista o que já existe no estúdio' },
+        ],
+    },
     {
         nome: 'Computador',
         resumo: 'janelas, botões, mouse e teclado — age em qualquer programa e na área de trabalho',

package/lib/studio.js

@@ -0,0 +1,198 @@
+/**
+ * studio.js — o PrimoCode Studio, ligado ao agente.
+ *
+ * O Studio é a suíte de criação que vem junto com o PrimoCode (pasta studio/):
+ * Prisma (apresentações), Tela (design), Prosa (documentos), Grade (planilhas),
+ * Corte (vídeo) e Traço (diagramas). É um servidor Python de biblioteca padrão,
+ * sem nada para instalar.
+ *
+ * ── POR QUE ESTE MÓDULO EXISTE ───────────────────────────────────────────
+ * Medido em uso real: o agente sabia do Studio, tentou falar com ele em
+ * localhost:7777, tomou "conexão recusada" e DESISTIU — respondeu ao usuário
+ * que "o estúdio não está rodando na sua máquina". O usuário não tem que ligar
+ * ferramenta nenhuma: ele pediu um vídeo, quer o vídeo.
+ *
+ * Então aqui o Studio sobe SOZINHO, na primeira vez que o agente precisa dele.
+ * `garantirNoAr()` é chamado antes de toda tool studio_*, e o modelo nem sabe
+ * que houve um passo a mais.
+ *
+ * ── POR QUE ELE RODA DE ~/.primocode/studio, E NÃO DE DENTRO DO PACOTE ────
+ * O Studio grava o que cria (arquivos/ e midia/) ao lado do server.py. Com o
+ * pacote instalado global (`npm i -g`), essa pasta costuma ser de sistema e a
+ * escrita falharia — e, pior, um `npm update` apagaria o trabalho do usuário.
+ * Então o código é copiado para ~/.primocode/studio na primeira vez, e as
+ * criações ficam lá, a salvo de atualização do pacote.
+ */
+
+'use strict';
+
+const http = require('http');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { spawn, execSync } = require('child_process');
+
+const ORIGEM = path.join(__dirname, '..', 'studio');
+const CASA = path.join(os.homedir(), '.primocode', 'studio');
+const PORTA = Number(process.env.PRIMOCODE_STUDIO_PORT) || 7777;
+const BASE = `http://127.0.0.1:${PORTA}`;
+
+// Só o código do Studio é atualizado; `arquivos/` e `midia/` (o que o usuário
+// criou) nunca são tocados.
+const COPIAVEIS = new Set(['server.py', 'web', 'ferramentas', 'README.md', 'PRIMOCODE.md']);
+
+function pythonCmd() {
+    const candidatos = os.platform() === 'win32' ? ['python', 'py', 'python3'] : ['python3', 'python'];
+    for (const c of candidatos) {
+        try {
+            const v = execSync(`${c} --version`, { stdio: ['ignore', 'pipe', 'pipe'], timeout: 5000 }).toString();
+            if (/Python 3/.test(v)) return c;
+        } catch {}
+    }
+    return null;
+}
+
+// Cópia recursiva que só reescreve o que mudou — assim `npm update` traz o
+// Studio novo sem custo, e o que o usuário criou continua onde está.
+function copiar(de, para) {
+    const st = fs.statSync(de);
+    if (st.isDirectory()) {
+        fs.mkdirSync(para, { recursive: true });
+        for (const item of fs.readdirSync(de)) copiar(path.join(de, item), path.join(para, item));
+        return;
+    }
+    let precisa = true;
+    try {
+        const alvo = fs.statSync(para);
+        precisa = alvo.size !== st.size || alvo.mtimeMs < st.mtimeMs;
+    } catch {}
+    if (precisa) fs.copyFileSync(de, para);
+}
+
+function prepararCasa() {
+    if (!fs.existsSync(ORIGEM)) return { ok: false, error: 'A pasta studio/ não veio no pacote.' };
+    fs.mkdirSync(CASA, { recursive: true });
+    for (const item of COPIAVEIS) {
+        const de = path.join(ORIGEM, item);
+        if (fs.existsSync(de)) copiar(de, path.join(CASA, item));
+    }
+    return { ok: true, casa: CASA };
+}
+
+// ── HTTP ─────────────────────────────────────────────────────────────────
+function pedir(metodo, rota, corpo, timeout = 30000) {
+    return new Promise((resolve, reject) => {
+        const dados = corpo == null ? null : Buffer.from(JSON.stringify(corpo), 'utf8');
+        const req = http.request({
+            hostname: '127.0.0.1',
+            port: PORTA,
+            path: rota,
+            method: metodo,
+            timeout,
+            headers: dados ? { 'Content-Type': 'application/json', 'Content-Length': dados.length } : {},
+        }, (res) => {
+            let texto = '';
+            res.setEncoding('utf8');
+            res.on('data', (c) => { texto += c; });
+            res.on('end', () => {
+                if (res.statusCode >= 400) return reject(new Error(`HTTP ${res.statusCode}: ${texto.slice(0, 200)}`));
+                try { resolve(JSON.parse(texto)); }
+                catch { resolve({ texto }); }
+            });
+        });
+        req.on('timeout', () => { req.destroy(new Error('tempo esgotado falando com o Studio')); });
+        req.on('error', reject);
+        if (dados) req.write(dados);
+        req.end();
+    });
+}
+
+async function estaNoAr() {
+    try { await pedir('GET', '/api/ferramentas', null, 1500); return true; }
+    catch { return false; }
+}
+
+// ── Subir ────────────────────────────────────────────────────────────────
+// Uma subida por vez: sem esta trava, duas tools chamadas no mesmo turno
+// disparariam dois servidores na mesma porta e o segundo morreria com
+// "address in use" — barulho por nada.
+let subindo = null;
+
+async function garantirNoAr() {
+    if (await estaNoAr()) return { ok: true, url: BASE, jaEstava: true };
+    if (subindo) return subindo;
+
+    subindo = (async () => {
+        const casa = prepararCasa();
+        if (!casa.ok) return casa;
+
+        const py = pythonCmd();
+        if (!py) {
+            return {
+                ok: false,
+                error: 'O Studio precisa do Python 3, que não está instalado.',
+                comoResolver: os.platform() === 'darwin'
+                    ? 'Instale com: brew install python3 (ou baixe em python.org).'
+                    : 'Instale o Python 3 (python.org) e tente de novo.',
+            };
+        }
+
+        // Solto do processo do CLI: o Studio continua de pé quando a sessão
+        // fecha, que é o que o usuário espera de um app aberto.
+        const filho = spawn(py, ['server.py', String(PORTA)], {
+            cwd: CASA,
+            detached: true,
+            stdio: 'ignore',
+        });
+        filho.unref();
+
+        // Espera ficar de pé (~8s no pior caso). Máquina lenta continua sendo
+        // atendida; máquina rápida sai na primeira volta.
+        for (let i = 0; i < 40; i++) {
+            await new Promise((r) => setTimeout(r, 200));
+            if (await estaNoAr()) return { ok: true, url: BASE, subiuAgora: true };
+        }
+        return { ok: false, error: `O Studio não respondeu em ${BASE} depois de subir. Veja se a porta ${PORTA} está livre.` };
+    })();
+
+    try { return await subindo; }
+    finally { subindo = null; }
+}
+
+// ── O que o agente usa ───────────────────────────────────────────────────
+// Toda função garante o Studio no ar ANTES de falar com ele. É isto que faz o
+// "abre o Canva e faz um post" virar um post pronto, sem o usuário ligar nada.
+
+async function comStudio(fn) {
+    const no = await garantirNoAr();
+    if (!no.ok) return no;
+    return fn();
+}
+
+const manual = () => comStudio(async () => ({ ok: true, ...(await pedir('GET', '/api/manual')) }));
+const ferramentas = () => comStudio(async () => ({ ok: true, ferramentas: await pedir('GET', '/api/ferramentas') }));
+const spec = (slug) => comStudio(async () => ({ ok: true, spec: await pedir('GET', `/api/ferramentas/${encodeURIComponent(slug)}`) }));
+const listar = () => comStudio(async () => ({ ok: true, arquivos: await pedir('GET', '/api/arquivos') }));
+const ler = (id) => comStudio(async () => ({ ok: true, arquivo: await pedir('GET', `/api/arquivos/${encodeURIComponent(id)}`) }));
+
+const criar = ({ ferramenta, titulo, doc }) => comStudio(async () => {
+    if (!ferramenta) return { ok: false, error: 'Diga a ferramenta: prisma, tela, prosa, grade, corte ou traco.' };
+    if (!doc) return { ok: false, error: 'Falta o doc. Leia a spec com studio_spec antes de criar.' };
+    const r = await pedir('POST', '/api/arquivos', { ferramenta, titulo: titulo || 'Sem título', doc });
+    return { ok: true, ...r };
+});
+
+const atualizar = ({ id, titulo, doc }) => comStudio(async () => {
+    if (!id) return { ok: false, error: 'Falta o id do arquivo.' };
+    const corpo = {};
+    if (titulo != null) corpo.titulo = titulo;
+    if (doc != null) corpo.doc = doc;
+    const r = await pedir('PUT', `/api/arquivos/${encodeURIComponent(id)}`, corpo);
+    return { ok: true, ...r };
+});
+
+module.exports = {
+    BASE, PORTA, CASA,
+    garantirNoAr, estaNoAr, prepararCasa, pythonCmd,
+    manual, ferramentas, spec, listar, ler, criar, atualizar,
+};

package/lib/tools.js

@@ -14,6 +14,7 @@ const { exec } = require('child_process');
 const browser = require('./browser');
 const desktop = require('./desktop');
 const referencia = require('./referencia');
+const studio = require('./studio');
 
 const IGNORAR = new Set(['node_modules', '.git', 'dist', 'build', '.next', 'coverage', '.cache', 'vendor']);
 const MAX_ARQUIVOS_VARREDURA = 5000;
@@ -446,6 +447,20 @@ async function despachar(name, args, ctx) {
                 return desktop.scroll(args.dy != null ? args.dy : 300);
             case 'desktop_size':
                 return desktop.getScreenSize();
+            // ── PrimoCode Studio — a suíte de criação (sobe sozinha) ───────
+            case 'studio_manual':
+                return studio.manual();
+            case 'studio_spec':
+                return studio.spec(args.ferramenta || args.slug || '');
+            case 'studio_criar':
+                return studio.criar({ ferramenta: args.ferramenta, titulo: args.titulo, doc: args.doc });
+            case 'studio_ler':
+                return studio.ler(args.id);
+            case 'studio_atualizar':
+                return studio.atualizar({ id: args.id, titulo: args.titulo, doc: args.doc });
+            case 'studio_listar':
+                return studio.listar();
+
             case 'desktop_double_click':
                 return desktop.doubleClick(args.x, args.y);
             case 'desktop_open_app':

package/lib/ui.js

@@ -310,11 +310,13 @@ function actionHeader(name, args) {
         desktop_drag:'Desktop·drag', desktop_type:'Desktop·type', desktop_key:'Desktop·key',
         desktop_scroll:'Desktop·scroll', desktop_size:'Desktop·size',
         desktop_double_click:'Desktop·2click', desktop_open_app:'Desktop·app',
+        studio_manual:'Estúdio·manual', studio_spec:'Estúdio·spec', studio_criar:'Estúdio·criar',
+        studio_ler:'Estúdio·ler', studio_atualizar:'Estúdio·ajustar', studio_listar:'Estúdio·lista',
         desktop_windows:'Desktop·janelas', desktop_focus:'Desktop·foco',
         desktop_elements:'Desktop·elementos', desktop_click_element:'Desktop·click',
     };
     const label = nice[name] || name;
-    const argStr = args ? (args.consulta || args.path || args.pattern || args.command || args.target || args.url || args.selector || args.text || args.app || args.window || args.name || args.description || (args.todos ? `${args.todos.length} tarefas` : '') || (args.x != null ? `${args.x},${args.y}` : '') || args.key || JSON.stringify(args).slice(0,60)) : '';
+    const argStr = args ? (args.consulta || args.path || args.pattern || args.command || args.target || args.url || args.selector || args.text || args.app || args.window || args.name || args.ferramenta || args.titulo || args.description || (args.todos ? `${args.todos.length} tarefas` : '') || (args.x != null ? `${args.x},${args.y}` : '') || args.key || JSON.stringify(args).slice(0,60)) : '';
     return `  ${c.dim('⎿')} ${c.brand(label)}${argStr ? ' '+c.muted(argStr) : ''}`;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "primocode",
-  "version": "7.17.0",
+  "version": "8.0.0",
   "description": "PrimoCode — agente de engenharia com IA e cursor próprio. Modelos grátis. Cria arquivos, roda comandos, controla navegador e desktop: abre apps, clica em botões e ícones pelo nome, digita e usa atalhos.",
   "main": "bin/primocode.js",
   "bin": {
@@ -27,6 +27,7 @@
   "files": [
     "bin/",
     "lib/",
+    "studio/",
     "README.md"
   ]
 }

package/studio/PRIMOCODE.md

@@ -0,0 +1,58 @@
+# PRIMOCODE — instruções para agentes
+
+Se você é um agente de IA trabalhando neste repositório ou com este servidor,
+leia isto antes de agir.
+
+## O que é
+
+Um estúdio de criação local. Você **não** opera pela interface — você escreve o
+documento em JSON e envia por API. A interface existe para o humano refinar depois.
+
+## O que fazer quando o usuário pede uma peça
+
+1. Confira que o servidor responde:
+   `curl -s -o /dev/null -w '%{http_code}' http://localhost:7777/api/ferramentas`
+   Se não der `200`, suba com `python3 server.py` a partir desta pasta.
+
+2. Se o pedido citou um app externo (Canva, PowerPoint, Word, Excel, Photoshop,
+   CapCut, Figma, Miro…), responda primeiro, em uma linha:
+
+   > Posso abrir o(a) **[app pedido]**, mas para te entregar com mais qualidade
+   > vou usar minhas ferramentas nativas.
+
+   Não espere confirmação. Se o usuário insistir no app externo, abra e siga.
+
+3. Leia `curl -s http://localhost:7777/api/manual` — traz os três modelos de
+   documento, todos os layouts e um exemplo completo por ferramenta.
+
+4. Escolha a ferramenta:
+
+   | pedido | ferramenta |
+   |---|---|
+   | slides, deck, apresentação, pitch | `prisma` |
+   | post, capa, banner, thumbnail, arte | `tela` |
+   | documento, relatório, proposta, artigo | `prosa` |
+   | planilha, orçamento, controle, projeção | `grade` |
+   | vídeo, reels, animação, teaser | `corte` |
+   | fluxograma, diagrama, mapa mental, arquitetura | `traco` |
+
+5. `POST /api/arquivos` com `{ferramenta, titulo, doc}` e devolva a URL `ver`.
+
+6. Para ajustes posteriores, `GET` o arquivo, mude o que precisa e `PUT` de volta.
+   O link do usuário continua valendo.
+
+## Regras de conteúdo
+
+- Escreva o conteúdo de verdade. Nada de "Lorem ipsum" nem "[inserir aqui]".
+- Não invente números com cara de dado real. Sem fonte, diga que falta a fonte.
+- Uma ideia por cena. Se precisa rolar o olho para ler, dividiu errado.
+- Não peça para o usuário montar sozinho na interface.
+
+## Se você for mexer no código
+
+- `ferramentas/*.md` é a única fonte da spec. Mudou comportamento? Atualize lá —
+  `/api/manual` serve direto desses arquivos.
+- `web/js/render.js` desenha cenas; `render-prosa.js` e `render-grade.js` os outros
+  dois modelos. `render.css` é o único CSS que vai junto no export autônomo.
+- Sem dependências externas. Nada de CDN, nada de `npm install`, nada de build.
+  Se precisou de uma biblioteca, escreva a função.