@aksp/opencrew 1.7.1 → 1.9.0

package/CHANGELOG.md

@@ -3,6 +3,135 @@
 All notable changes to opencrew are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/).
 
+## [1.9.0] — 2026-10-07
+
+Fase U3a, fatia 2 "Entrega no projeto" (`specs/fase-u3a2-entrega-no-projeto.md`). Chega a quem já
+usa com um `npx @aksp/opencrew@latest update`, e funciona nas crews que já existem.
+
+Ainda não nesta versão: a crew que publica sozinha continua publicando como na 1.8.0 (o publicador
+ainda não lê a pasta da entrega); legenda, post e tweet continuam medidos sem as hashtags no fim
+(só o alerta); documento Word fica para a 1.10.0.
+
+### Added
+- **A entrega vai para uma pasta do seu projeto.** Na primeira entrega de cada crew, a IA pergunta
+  "Quer que eu copie o resultado para uma pasta do projeto?". Com a pasta escolhida (por exemplo,
+  `Conteudo/Prontos`), cada execução ganha a sua subpasta, `<pasta>/<execução>/`, com o LEIA-ME e
+  as pastas dos canais prontos. Antes, a entrega só existia em `crews/<crew>/output/…/entrega/`,
+  fora do git, e quem queria guardar copiava à mão.
+- **A pergunta é feita uma vez.** A resposta — também o "não" — fica na linha `entrega.destino` do
+  `crew.yaml` da crew; o arquivo anterior é guardado em `crew.yaml.bak`.
+- **Nada do que foi copiado é sobrescrito.** Entregar de novo sem mudança não cria nada; canal que
+  ficou pronto depois entra na mesma pasta; se algo já copiado mudou, a entrega nova vai para
+  `<execução>-reentrega-2`, ao lado, e o LEIA-ME da anterior avisa. Arquivo seu dentro da cópia
+  nunca é tocado: você pode editar a cópia à vontade, porque a entrega seguinte é comparada com o
+  que foi copiado, e não com o que você mudou depois.
+- **"Entregar assim mesmo".** Quando um canal não está pronto, a crew oferece três saídas: corrigir
+  agora, entregar assim mesmo ou deixar para depois. Em "entregar assim mesmo", o que falta fica
+  escrito como ressalva no começo do LEIA-ME, o canal aparece como "Pronto, com ressalva" e é
+  copiado com os outros. Pendência nova depois do aceite pede novo aceite — também a que foi
+  resolvida e voltou.
+- **Legenda de Instagram sem marcador.** Arquivo de legenda que é só o texto, pronto para colar,
+  sai como `instagram/legenda.txt`, com um aviso para conferir e com o alerta de tamanho. Antes, o
+  arquivo ia inteiro, sem ser medido.
+- **Mudar a pasta da cópia depois.** Peça à IA ("muda a pasta de entrega", "não quero mais cópia",
+  "volta a copiar"): ela refaz a entrega da última execução e grava a resposta nova.
+- **"Não tenho esse dado".** Na aprovação final, se você não tem a informação de um `[PREENCHER]`,
+  a crew não insiste e não inventa: deixa o `[PREENCHER]` no texto e você decide na entrega.
+
+### Changed
+- **PDF e "posts formatados" deixaram de ser gerados.** O PDF era prometido e o método não
+  funcionava; o "post formatado" foi substituído pela entrega por canal. Para ter um PDF, abra o
+  arquivo e use Imprimir → Salvar como PDF (o LEIA-ME ensina). Crew antiga com um passo de
+  `format: pdf` ou `format: formatted-post`: a execução avisa que o formato não é mais gerado e o
+  passo grava o texto em markdown (`.md`); nenhum `.pdf` é criado. O CSV continua.
+- **Canal que não está pronto não é copiado para o projeto.** Ele continua em `entrega/`, marcado
+  como "Não está pronto", e entra na cópia quando ficar pronto ou quando você aceitar a ressalva.
+- **"Corrigir agora" corrige no arquivo de origem**, verifica o texto de novo e só então monta a
+  entrega. Antes, a correção podia ser feita sem nova verificação.
+- **`[PREENCHER]` aparece no relatório como "✏️ A preencher"**, e não mais como "❌ Bloqueio"; o
+  resumo conta à parte ("1 a preencher"). O que impede a entrega não mudou: texto com `[PREENCHER]`
+  continua "Não está pronto" até você preencher ou aceitar.
+- No LEIA-ME, o aviso de trecho que ficou fora do texto para colar diz em qual arquivo de origem
+  ele está.
+- No laço de revisão, "Aceitar assim mesmo" diz que a escolha fica registrada na entrega.
+- **`update` em instalação que não terminou** (`_opencrew/core` sem o registro de versão): não
+  altera nada e pede `npx @aksp/opencrew init`, que conclui. Antes, atualizava mostrando a versão
+  "unknown".
+
+### Fixed
+- **O relatório de cada ciclo de revisão é gravado pelo verificador**
+  (`verificacao-ciclo-N.md`). Antes, a IA copiava a saída à mão e podia truncar.
+- **`.gitignore` com um marcador do bloco sem o par** (só `# opencrew:start` ou só
+  `# opencrew:end`): o `update` guarda o arquivo como estava em `.opencrew-backup/<data>/`, põe um
+  bloco completo no fim e lista a cópia. Nenhuma linha sua é apagada.
+
+### Internal
+- O bloco do `.gitignore` começa por `# gerenciado pelo OpenCrew: suas linhas ficam fora deste
+  bloco` (o primeiro `update` regrava só o bloco).
+- `entregar.mjs` ganha `--destino`, `--lembrar-destino` e `--aceitar-pendencias`; `verificar.mjs`
+  ganha `--relatorio`; módulos novos em `scripts/entrega/` e `scripts/verificar/` (sem dependência,
+  até 200 linhas cada). `export.prompt.md` fica só com o CSV. O runner não cresceu (874 linhas).
+
+## [1.8.0] — 2026-10-07
+
+Fase U3a, fatia 1 "Pasta de entrega" (`specs/fase-u3a1-pasta-de-entrega.md`). Chega a quem já usa
+com um `npx @aksp/opencrew@latest update`, e funciona nas crews que já existem, sem mexer nelas.
+
+Ainda não nesta versão: PDF e "posts formatados" não são gerados pela entrega (`artigo.md`,
+`corpo.md` e os roteiros saem em markdown, e o LEIA-ME ensina a salvar como PDF pelo "Imprimir");
+copiar a entrega para uma pasta do projeto, registrar "entregar assim mesmo" e marcar "já
+publicado" ficam para a 1.9.0. O LEIA-ME e os nomes dos arquivos são só em português.
+
+### Added
+- **Pasta `entrega/`: o que você usa, separado por canal.** Depois da aprovação final, a crew
+  monta `crews/<crew>/output/<execução>/entrega/` com uma pasta por canal (`instagram/`,
+  `linkedin/`, `blog/`, `email/`, `whatsapp/`, `twitter/`, `youtube/`; só os que a execução tem).
+  Antes, você recebia a pasta da execução com `v1`, `v2`, relatórios e textos cheios de `#`, `**`
+  e rótulos.
+- **Texto pronto para colar.** `legenda.txt`, `post.txt` e `tweet.txt` saem sem `#`, `**`, rótulos
+  nem recados internos, com as hashtags no fim. O primeiro comentário do LinkedIn vem em arquivo
+  à parte; a thread, em `tweet-1.txt`, `tweet-2.txt`…; o blog, em `seo.txt` (título, meta
+  description, palavra-chave, slug) e `artigo.md`; o e-mail, em `assunto.txt`, `previa.txt` e
+  `corpo.md`; o WhatsApp, em `mensagem.txt`. As imagens vão para a pasta do canal com o nome
+  original, sem alteração; o HTML dos slides, para `editaveis/`.
+- **`LEIA-ME.md` em cada entrega.** Diz o que fazer com cada arquivo, canal por canal, em passos
+  numerados; marca cada canal como "Pronto" ou "Não está pronto"; lista em "Antes de usar" o que
+  falta; e diz o que não foi conferido (links e fatos, texto dentro das imagens, aparência final
+  em cada rede).
+- **O que não está pronto fica marcado.** Texto com `[PREENCHER]`, acima de um limite ou arquivo
+  que faltou: o canal aparece como "Não está pronto" e a crew pergunta se você quer corrigir agora
+  ou seguir assim. Se a legenda, o post ou o tweet passar do limite por causa das hashtags no fim,
+  o LEIA-ME traz um alerta.
+- **Arquivo sem canal não se perde.** Proposta, minuta, relatório ou formato que não é de rede
+  nenhuma vai inteiro para `outros/`, com o nome original, e aparece no LEIA-ME.
+- **Entrega de uma execução antiga.** Peça à IA para montar a entrega de uma execução já
+  encerrada: ela lista os arquivos, pede o seu "sim" e monta a pasta.
+- Crew que publica sozinha (Instagram, por exemplo): a entrega é montada antes da publicação, e
+  o LEIA-ME avisa "Esta crew publica este canal sozinha. Antes de postar à mão, confira se já saiu."
+
+### Changed
+- **O fim da execução aponta para `entrega/` e para o LEIA-ME**, não mais para a pasta da execução
+  e para um "arquivo final" que ninguém dizia qual era. A cópia do arquivo final na raiz da
+  execução deixa de ser feita.
+- A pasta `entrega/` é refeita do zero a cada entrega e fica fora do git: o que você editar ali se
+  perde. Para guardar, copie a pasta para outro lugar do projeto (o LEIA-ME avisa).
+- Se o script da entrega não rodar (sem Node, por exemplo), a execução não para: a crew avisa e
+  lista os arquivos aprovados.
+
+### Fixed
+- **O título do arquivo era lido como legenda.** Num arquivo com `# Legenda — …` no topo e a
+  legenda de verdade mais abaixo, o verificador media duas legendas e podia dar alerta falso.
+  Agora o título do arquivo não conta como peça.
+
+### Internal
+- `_opencrew/core/scripts/entregar.mjs` e os módulos de `scripts/entrega/` (sem dependência, até
+  200 linhas cada); `_opencrew/core/prompts/entrega.prompt.md`; seção `### Entrega` no runner, que
+  perde "Save final output", "Run folder" e "Output saved to".
+- Regra 15 do `AGENTS.md`: script do runtime só escreve onde foi combinado.
+- Travas novas: `tests/entregar*.test.js`, `tests/runtime-contracts-u3a.test.js`,
+  `tests/upgrade-u3a.test.js` e o U3a-14c em `tests/package.test.js`.
+- Roteiro renumerado: U3a fatia 2 = 1.9.0, U3b = 1.10.0, U4 = 1.11.0.
+
 ## [1.7.1] — 2026-10-06
 
 Fase R3 "Reparos do runner em uso real" (`specs/fase-r3-runner-em-uso-real.md`): dois defeitos

package/README.md

@@ -30,8 +30,12 @@ dentro da sua IDE.**
   rejeita o mesmo erro 3 vezes, vira Regra de Ouro automática.
 - 📦 **Templates prontos** — blog semanal, Instagram carrossel, newsletter
   mensal, lançamento de produto. Comece em 2 minutos.
-- 📤 **Exportação multi-formato** — PDF, CSV e posts formatados por plataforma,
-  sem abrir editor nenhum.
+- 📤 **Tabelas em CSV** — as tabelas de um resultado saem em CSV, prontas para a planilha.
+- 📬 **Entrega por canal** — depois de aprovar, você encontra a pasta `entrega/`: uma pasta por
+  canal (Instagram, LinkedIn, blog, e-mail, WhatsApp, X/Twitter, YouTube), o texto pronto para
+  colar, as imagens e um `LEIA-ME.md` com o passo a passo. O que não está pronto fica marcado.
+- 📁 **Entrega no seu projeto** — a crew pergunta uma vez onde guardar e copia a entrega para uma
+  pasta do seu projeto, uma subpasta por execução, sem sobrescrever nada.
 - 🎛️ **Seleção inteligente de agentes** — o sistema analisa seu pedido e
   sugere quais agentes são necessários para aquela tarefa. Você confirma ou
   ajusta com um clique. Agentes pulados não gastam tokens naquele run.
@@ -178,9 +182,9 @@ meu-projeto/
 │   │   ├── skills.engine.md      ← gerenciador de skills
 │   │   ├── architect.agent.yaml  ← definição do Arquiteto
 │   │   ├── best-practices/       ← 22 guias de melhores práticas + _catalog.yaml
-│   │   ├── scripts/              ← verificador, conferência de fontes e os scripts do Escritório
+│   │   ├── scripts/              ← verificador, conferência de fontes, caminhos, entrega e os scripts do Escritório
 │   │   ├── escritorio/           ← página do Escritório ao vivo (abre com /opencrew dashboard)
-│   │   └── prompts/              ← 13 prompts de fase (discovery, design, build, etc.)
+│   │   └── prompts/              ← 14 prompts de fase (discovery, design, build, entrega, etc.)
 │   ├── agents/                   ← 5 agentes base compartilhados
 │   │   ├── researcher.agent.md
 │   │   ├── copywriter.agent.md
@@ -194,6 +198,9 @@ meu-projeto/
 │
 ├── crews/                        ← suas crews vivem aqui
 │   ├── blog-semanal/             ← template: blog semanal
+│   │   └── output/<execução>/    ← criada a cada execução
+│   │       ├── v1/  v2/  …       ← o que cada passo gravou
+│   │       └── entrega/          ← o que você usa: LEIA-ME.md + uma pasta por canal (copiada para a pasta do projeto que você escolher)
 │   ├── instagram-carrossel/      ← template: Instagram carrossel
 │   ├── newsletter-mensal/        ← template: newsletter
 │   └── lancamento-produto/       ← template: lançamento
@@ -209,6 +216,76 @@ meu-projeto/
 
 ---
 
+## Entrega por canal
+
+Depois da aprovação final, a crew monta a pasta `entrega/` dentro da pasta da execução
+(`crews/<crew>/output/<execução>/entrega/`). É ali que está o que você vai usar:
+
+```
+entrega/
+├── LEIA-ME.md      ← comece por aqui: o que fazer com cada arquivo, canal por canal
+├── instagram/      ← legenda.txt (hashtags no fim) e as imagens, com o nome original
+├── linkedin/       ← post.txt e, se houver, post-comentario.txt (o primeiro comentário)
+├── blog/           ← seo.txt (título, meta description, palavra-chave, slug) e artigo.md
+├── email/          ← assunto.txt, previa.txt e corpo.md
+├── whatsapp/       ← mensagem.txt
+├── twitter/        ← tweet.txt (na thread: tweet-1.txt, tweet-2.txt…)
+├── youtube/        ← o roteiro
+├── outros/         ← arquivo sem canal (proposta, minuta, relatório), como está
+└── editaveis/      ← o HTML dos slides, para quem quiser ajustar
+```
+
+Só aparecem as pastas que a execução tem.
+
+- **Texto pronto para colar.** Os `.txt` saem sem `#`, `**`, rótulos nem recados internos, com as
+  hashtags no fim. Com mais de uma peça do mesmo tipo, os arquivos são numerados (`post-1.txt`,
+  `post-2.txt`).
+- **O `LEIA-ME.md` diz o que fazer.** Cada canal tem a situação ("Pronto", "Pronto, com ressalva"
+  ou "Não está pronto"), os arquivos, de onde cada um veio e os passos, numerados. "Antes de usar"
+  junta o que falta e o que foi entregue com ressalva; "O que não foi conferido" lembra o que
+  ninguém mediu (links e fatos, texto dentro das imagens, aparência final em cada rede).
+- **O que não está pronto fica marcado, e você escolhe.** Sobrou um `[PREENCHER]` ou um texto
+  acima do limite? O canal aparece como "Não está pronto" e a crew oferece três saídas:
+  1. **Corrigir agora** — ela ajusta no arquivo de origem, verifica e monta a entrega de novo.
+  2. **Entregar assim mesmo** — o que falta fica escrito como ressalva no começo do LEIA-ME, e o
+     canal passa a "Pronto, com ressalva".
+  3. **Deixar para depois** — o canal fica como "Não está pronto" e não é copiado para o projeto.
+     Quando o dado existir, peça a entrega dessa execução de novo.
+- **Não tem o dado na hora?** Na aprovação final, diga "não tenho esse dado": a crew não insiste e
+  não inventa — o `[PREENCHER]` fica no texto e você decide na entrega.
+- **Arquivo sem canal vai para `outros/`**, inteiro e com o nome original: nada some.
+- **A pasta `entrega/` é refeita a cada entrega e fica fora do git.** O que você editar ali se
+  perde: o que é para guardar está na cópia do seu projeto (abaixo).
+- **Execução antiga?** Peça à IA: "monte a entrega da execução X da crew Y". Ela lista os
+  arquivos, pede o seu "sim" e monta a pasta. Funciona em crews criadas antes da 1.8.0, depois
+  do `update`.
+
+### A cópia no seu projeto
+
+Na primeira entrega de cada crew, a IA pergunta: "Quer que eu copie o resultado para uma pasta do
+projeto?". Se você disser uma pasta (por exemplo, `Conteudo/Prontos`), a crew copia a entrega para
+uma pasta do seu projeto, uma subpasta por execução: `<pasta>/<execução>/`, com o `LEIA-ME.md` e
+as pastas dos canais prontos.
+
+- **A pergunta é feita uma vez por crew.** A resposta — também o "não" — fica na linha
+  `entrega.destino` do `crew.yaml` da crew (o arquivo anterior fica em `crew.yaml.bak`). Para
+  mudar depois, peça à IA ou edite essa linha.
+- **Nada é sobrescrito.** Entregar de novo sem mudança não cria nada. Canal que ficou pronto
+  depois entra na mesma pasta. Se algo que já foi copiado mudou, a entrega nova vai para
+  `<execução>-reentrega-2` (depois `-3`…), ao lado, e a anterior fica como estava, com um aviso no
+  LEIA-ME dela. O que você editar ou guardar na cópia continua lá, e editar a cópia não faz a
+  entrega seguinte virar reentrega.
+- **Só vai o que está pronto.** Canal "Não está pronto" fica fora da cópia, a menos que você
+  escolha "Entregar assim mesmo".
+- **A pasta fica dentro do projeto**, fora de `_opencrew/`, `crews/`, `skills/`, `.git/` e
+  `node_modules/`; se não existe, é criada. Se ela entra no git, a escolha é sua.
+
+A entrega não gera PDF nem imagem: `artigo.md`, `corpo.md` e os roteiros saem em markdown, e o
+LEIA-ME ensina a salvar como PDF pelo "Imprimir" do seu editor. O LEIA-ME e os nomes dos arquivos
+são sempre em português.
+
+---
+
 ## Escritório ao vivo
 
 Quer ver a equipe trabalhando? O **Escritório** é uma página em pixel-art, aberta no navegador,
@@ -273,6 +350,12 @@ o que você fez:
   copiou. Essa pasta fica fora do git (entra no bloco do `.gitignore`). No primeiro `update` para
   a 1.6.3 há cópia do `.gitignore` mesmo sem edição sua: as versões anteriores não registravam o
   bloco.
+- **O `.gitignore` tem um marcador do bloco sem o par** (só `# opencrew:start` ou só
+  `# opencrew:end`)? Nenhuma linha sua é apagada: o `update` guarda o arquivo como estava e põe
+  um bloco completo no fim. O bloco começa por um comentário que diz que ele é do OpenCrew: as
+  suas linhas ficam fora dele.
+- **A instalação anterior parou no meio?** O `update` não altera nada e pede para você rodar
+  `npx @aksp/opencrew init`, que conclui a instalação sem apagar o que já existe.
 - **Apagou um modelo de crew ou um skill do catálogo?** Ele volta no `update`, e a saída diz o
   que foi entregue de novo.
 - **Removeu o servidor Playwright do `.mcp.json`?** O `update` o entrega uma única vez; se você

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aksp/opencrew",
-  "version": "1.7.1",
+  "version": "1.9.0",
   "publishConfig": {
     "access": "public"
   },

package/src/commands/update.js

@@ -9,7 +9,7 @@ import { detectInstalledIdes } from '../lib/deteccao.js';
 import { withoutLegacy } from '../lib/legado.js';
 import { updateMcp } from '../lib/mcp.js';
 import { compareVersions, installedVersion, findLeftovers } from '../lib/migrations.js';
-import { say, recreatedLines, updateSummary, UNTOUCHED } from '../lib/resumo.js';
+import { say, recreatedLines, updateSummary, UNTOUCHED, INTERRUPTED } from '../lib/resumo.js';
 import { c, log, info, ok, warn, err, step } from '../lib/ui.js';
 
 const tpl = (...p) => path.join(templatesDir, ...p);
@@ -39,7 +39,13 @@ export async function update(opts = {}) {
     return;
   }
 
-  const current = (await installedVersion(target)) ?? 'unknown';
+  // No stamp = an install that did not finish: nothing is written or stamped (rule 31).
+  const current = await installedVersion(target);
+  if (!current) {
+    err(INTERRUPTED);
+    process.exitCode = 1;
+    return;
+  }
   log(`\n${c.bold(c.cyan('opencrew update'))}`);
   log(c.dim(`Installed: ${current}  →  Package: ${version}\n`));
   if (canApply(opts, current, version)) await apply(target, version);
@@ -47,7 +53,7 @@ export async function update(opts = {}) {
 
 /** `--check` only reports, and a package older than the workspace stops: false = write nothing. */
 function canApply(opts, current, version) {
-  const newer = current !== 'unknown' && compareVersions(current, version) > 0;
+  const newer = compareVersions(current, version) > 0;
   if (opts.check) {
     if (current === version) ok(`Up to date (v${version}).`);
     else if (newer) info(`A versão instalada (v${current}) é mais nova que este pacote (v${version}).`);

package/src/lib/blocos.js

@@ -70,11 +70,14 @@ function planBlock(file, text, marked) {
   const block = bytesOf(marked).replace(/\n/g, eol);
   const ranges = blockRanges(text, file);
   if (!ranges.length) {
+    // A marker left alone (its pair deleted by hand): the block still goes in whole, and the
+    // file as it was is copied first (spec U3a-2, rule 30).
+    const orphan = markersOf(file).some((marker) => text.includes(marker));
     const bom = text.startsWith(BOM) ? BOM : '';
     const added = AT_END.has(file)
       ? `${text.replace(/[ \t\r\n]+$/, '')}${eol}${eol}${block}${eol}`
       : `${bom}${block}${eol}${eol}${text.slice(bom.length).replace(/^[ \t\r\n]+/, '')}`;
-    return { action: 'added', text: added, hashes: [] };
+    return { action: 'added', text: added, hashes: [], orphan };
   }
   const hashes = ranges.map(([from, to]) => hashOf(Buffer.from(text.slice(from, to), 'latin1').toString('utf8')));
   if (hashes.every((h) => h === hashOf(marked))) return { action: 'kept', hashes };
@@ -85,7 +88,8 @@ function planBlock(file, text, marked) {
  * Put `content` between the opencrew markers of `file` (path relative to the project root,
  * with `/`) and record the block in `ctx.files`.
  * - no file → `created`; file with no block → `added` at the top (at the end in .gitignore
- *   and .env.example), the user's content kept, no copy;
+ *   and .env.example), the user's content kept, no copy — unless a marker was left alone
+ *   in it: then the whole file is copied first;
  * - block equal to the new one → `kept`, nothing written;
  * - otherwise → `updated`: only the block is rewritten, in the line ending of the file. The
  *   whole file is copied first unless the block is exactly what the manifest recorded.
@@ -102,7 +106,7 @@ export async function deliverBlock(ctx, file, content) {
   const edited = plan.action === 'updated' && !plan.hashes.every((h) => h === record);
   // A UTF-16 file cannot take a UTF-8 block without damage: the whole file is copied first.
   const risky = raw && plan.text !== undefined && isUtf16(raw);
-  const copied = (edited || risky) && (await backupFile(ctx, file));
+  const copied = (edited || risky || plan.orphan) && (await backupFile(ctx, file));
   if (plan.text !== undefined) {
     await fs.mkdir(path.dirname(dest), { recursive: true });
     await fs.writeFile(dest, Buffer.from(plan.text, 'latin1'));

package/src/lib/resumo.js

@@ -15,6 +15,9 @@ export const UNTOUCHED = 'Não foram alterados: as crews que você criou, `_open
 /** `init` in a workspace that is already installed (rule 15). */
 export const ALREADY_INSTALLED = 'Para atualizar, rode `npx @aksp/opencrew@latest update`. Não apague `_opencrew/` para reinstalar: a pasta guarda a sua memória (`_opencrew/_memory/`) e as suas best-practices (`_opencrew/best-practices.local/`).';
 
+/** `update` over `_opencrew/core` with no version stamp (spec U3a-2, rule 31). */
+export const INTERRUPTED = 'A instalação anterior não terminou. Rode `npx @aksp/opencrew init` para concluir.';
+
 const NO_BRIDGES = 'Nenhuma ponte de IDE encontrada: nada a atualizar. Para criar a ponte de uma IDE: `npx @aksp/opencrew@latest init --repair-bridges --ide=<id>`.';
 const LEAK_REMOVED = 'CLAUDE.md: removi a seção de STATUS.md que as versões 1.4.0 e 1.4.1 gravaram por engano.';
 const FIRST_PROTECTED = 'Primeira atualização com proteção: sem registro anterior, guardamos tudo o que diferia. Daqui em diante, só o que você editar.';

package/templates/AGENTS.md

@@ -61,6 +61,8 @@ Route input to the matching action:
 | `/opencrew dashboard` | Turn on and open the Escritório (live view) — see "Dashboard (Optional)" |
 | `/opencrew dashboard off` | Turn the Escritório off — see "Dashboard (Optional)" |
 | `/opencrew reset` | Confirm and reset all configuration |
+| Request to deliver a run that already ended ("monte a entrega da execução …") | Load `_opencrew/core/prompts/entrega.prompt.md` → build the `entrega/` folder of that run |
+| Request to change where the delivery is copied ("muda a pasta de entrega", "não quero mais cópia", "volta a copiar") | Load `_opencrew/core/prompts/entrega.prompt.md` → "Changing the folder later" |
 | Natural language about crews | Infer intent and route accordingly |
 
 ## Loading Agents
@@ -120,6 +122,8 @@ and touch nothing else: stop no process, delete no file.
 - Exception: crew memory scaffolding (`memories.md` headers, `runs.md` columns)
   keeps fixed PT-BR structural labels regardless of the user's language —
   see `_opencrew/core/runner.pipeline.md`
+- Exception: the delivery folder (`entrega/`) — its folder names, file names and the `LEIA-ME.md`
+  are written by a script in fixed PT-BR, whatever the user's language
 
 ## Critical Rules
 

package/templates/_opencrew/.opencrew-version

@@ -1 +1 @@
-1.7.1
+1.9.0

package/templates/_opencrew/core/prompts/discovery.prompt.md

@@ -112,7 +112,7 @@ Based on the detected domain, ask the most relevant contextual question first. W
 **If domain = `analysis`:**
 1. Where does the data come from? (open-ended — let the user describe their data sources)
 2. What decisions should this analysis help you make? (open-ended)
-3. What format should the output take? (multiple choice: dashboard / PDF report / spreadsheet / automated alert / other)
+3. What format should the output take? (multiple choice: dashboard / written report / spreadsheet / automated alert / other)
 
 **If domain = `mixed`:**
 Ask the most pressing question from each relevant domain, starting with the primary one. Cap at 3 questions total in this step.

package/templates/_opencrew/core/prompts/entrega.prompt.md

@@ -0,0 +1,205 @@
+# Entrega — The Delivery Folder of a Run
+
+One script turns the approved files of a run into `crews/{name}/output/{run_id}/entrega/`: one
+folder per channel, text ready to paste and a `LEIA-ME.md` that tells the user what to do with each
+file. The same script copies what is ready to a folder of the project the user chose, one folder per
+run. Your part is to build the list of files, run the script, act on its last line and ask, once per
+crew, where the copy goes.
+
+You do NOT copy, split, rename or rewrite a file yourself, and you never write inside `entrega/`:
+the script rebuilds that folder from scratch on every call. **When** the delivery runs is in the
+section "Entrega" of `_opencrew/core/runner.pipeline.md`; a request to deliver a run that is
+already over starts at "A run that already ended", below.
+
+## Step 1: Build the list
+
+`{lista}` is one item per file, separated by commas, each written `{caminho}={formato}`.
+
+- **What goes in:** for each **creation or rendering step** of the approved run, every path the
+  `saida` action of `caminho.mjs` returned the **last time** the step ran (a step sent back by the
+  reviewer ran more than once: only its last version counts) — all the output files of the step,
+  images and HTML included. Use the paths you stored during the run. Never look for a `vN` folder
+  by yourself and never assume `v1`.
+- **`{formato}`** is the `format:` of the step that wrote the file. A rendering step with no
+  `format:` uses the `format:` of the content step it renders (the slides of an `instagram-feed`
+  carousel go as `=instagram-feed`). With no format either way, with an export format (`pdf`,
+  `csv`, `formatted-post`) or with one outside `[a-z0-9-]+`, the item goes without `={formato}`:
+  the script puts that file in `outros/`.
+  This list is **not** the list of the checker (`verificar.mjs`), where a step with no `format:`
+  goes without one: here the rendering step (images, HTML) takes the format of the content step it
+  renders — the step that wrote its `inputFile`. Without it the images land in `outros/`.
+- **Stay out:** research, briefing, the reviewer's verdict, checkpoint answers and every skipped
+  step (a deselected agent, or a step the user skipped).
+- **Safe names** — the safe-name rule (nome seguro) of the runner applies. A file that rule left
+  out of commands stays out of the list too; tell the user:
+  `{arquivo} — ficou fora da entrega: nome com caractere que não vai em comando`.
+
+## Step 2: Channels the crew publishes by itself
+
+Add `--vai-publicar {canal}` once for each channel of the list that has an irreversible step in the
+pipeline (`side_effects: irreversible`, in the step or in the agent's skill), whether that step
+already ran or not. The `LEIA-ME.md` then opens that channel with: "Esta crew publica este canal
+sozinha. Antes de postar à mão, confira se já saiu."
+
+- The channel of a step is the `platform:` of its `format:` — read it in
+  `_opencrew/best-practices.local/{format}.md` when that file declares `platform:`, otherwise in
+  `_opencrew/core/best-practices/{format}.md`. For a step with no `format:`, the one of the skill
+  (`instagram-publisher` → `instagram`). With neither, do not pass the option.
+- `{canal}` is the folder name: `instagram`, `linkedin`, `blog`, `email`, `whatsapp`, `twitter` or
+  `youtube`. Only a channel that has an item in the list (an item whose format has that
+  `platform:`) — for any other the script stops with `Canal não encontrado nesta entrega: {canal}.`
+
+## Step 3: Run the script
+
+From the project root, one line, everything between double quotes:
+
+`node _opencrew/core/scripts/entregar.mjs --crew "crews/{name}" --run "{run_id}" --arquivo "{lista}"`
+
+With channels from Step 2, the same command ends with one option per channel:
+
+`node _opencrew/core/scripts/entregar.mjs --crew "crews/{name}" --run "{run_id}" --arquivo "{lista}" --vai-publicar {canal}`
+
+## Step 4: Show the result and read the last line
+
+The output of the script is the final summary of the run (the folder, each channel as "Pronto",
+"Pronto, com ressalva" or "Não está pronto", what is missing, the line of the copy, the path of
+the `LEIA-ME.md`): show it to the user as it came,
+without the `ENTREGA:` line. Do not rewrite it and do not add files it does not list. Besides the
+`entrega/` folder, the script also writes `crews/{name}/output/{run_id}/verificacao-entrega.md`,
+the report of the check made at delivery time (it is not part of the delivery).
+
+- `ENTREGA:OK` → go on with the run (Step 5 first, when it applies).
+- `ENTREGA:COM_RESSALVA` → everything that was missing is a ressalva the user accepted: the
+  `LEIA-ME.md` opens with it and the channel is "Pronto, com ressalva"; go on as with `ENTREGA:OK`.
+- `ENTREGA:INCOMPLETA` → a channel is not ready, the destination was refused or a file could not be
+  written. `entrega/` was generated anyway and the `LEIA-ME.md` marks the channel; a channel that
+  is not ready is not copied to the project. The channels that are ready were already copied by
+  this same call, before the user answers: nothing waits for the answer. Show what is missing and
+  ask:
+  ```
+  ⚠️ A entrega ficou incompleta: {o que falta}
+  1. Corrigir agora (eu ajusto no arquivo de origem, verifico e monto a entrega de novo)
+  2. Entregar assim mesmo (fica registrado como ressalva no LEIA-ME)
+  3. Deixar para depois (o canal fica como "Não está pronto" e não é copiado)
+  ```
+  Wait for the answer.
+  - **1** — for each item that is missing, fix it in the source file the pending item names, never
+    inside `entrega/`, and in place — the same file at the same path, no new `vN` folder and no
+    copy — so the list does not change: ask the user for the real information of every
+    `[PREENCHER: …]`, shorten what is over a limit, write again a file that is not there. Then run
+    the checker on that file
+    (`node _opencrew/core/scripts/verificar.mjs --crew "crews/{name}" --arquivo "{caminho}={formato}"`)
+    and only then run the delivery again, with the same list.
+  - **2** — run the same command again, ending with `--aceitar-pendencias`: the script records
+    each pending item as a ressalva (in `ressalvas.json`, in the run folder, and at the top of the
+    `LEIA-ME.md`), the channel becomes "Pronto, com ressalva" and is copied like the ready ones.
+    It does **not** solve a file that does not exist, a refused destination or a file that could
+    not be written: for those, see below.
+  - **3** — go on: the channel stays "Não está pronto" and is not copied. Every irreversible step
+    still asks for its own confirmation, as it does today. Tell the user what is missing and that
+    it is enough to ask for the delivery of this run when the data exists.
+  - **Destination refused, or a file that could not be written** (the lines "Não copiei: …" and
+    "Não consegui gravar …"): show the message as it came and ask for another folder (Step 5, with
+    the new answer) or for a new attempt, which is the same command again. A file of the list that
+    does not exist: ask for it, or take it out of the list.
+
+  The first call never has `--aceitar-pendencias`. Outside option 2 it goes only when the user
+  already chose "Aceitar assim mesmo" in the review loop of this run and what is missing is only
+  what was accepted there: then run the command again with it, without asking.
+
+After "Edit this content" (the final menu of the runner) changes an approved file, or any step
+runs again after the delivery, run the delivery again with the new paths: the folder is rebuilt
+from scratch, so whatever was edited inside `entrega/` is lost — the `LEIA-ME.md` says so. The copy
+in the project is never overwritten: when something already copied changed, the script puts the
+new delivery in a folder beside it (`{run_id}-reentrega-2`) and the summary says so.
+
+## Step 5: The folder of the project that keeps the copy
+
+The line `Cópia:` of the summary says what was copied and where (or "Criei a pasta …" before it):
+show it as it came. A crew whose answer was "não" has no such line, and nothing is asked.
+
+After **any** delivery whose summary has the line "Cópia: nenhuma pasta escolhida para esta crew."
+— `ENTREGA:OK` and `ENTREGA:COM_RESSALVA` included — ask, once. When the last line was
+`ENTREGA:INCOMPLETA`, ask only after it was resolved (Step 4):
+
+```
+Quer que eu copie o resultado para uma pasta do projeto? Se sim, diga qual (por exemplo, `Conteudo/Prontos`). Se não, não pergunto de novo.
+```
+
+- A folder → run the same command again (same list, same options), ending with
+  `--lembrar-destino "{pasta}"`.
+- "Não" → the same command again, ending with `--lembrar-destino nao`.
+
+The script writes the answer in the `crew.yaml` of the crew (`entrega.destino`, with a `.bak` copy
+of the file) and makes the copy in the same call: never edit the `crew.yaml` yourself for this. The
+next deliveries of the crew do not ask again.
+
+- **`{pasta}` was typed by the user and goes into a command** — the safe-name rule (nome seguro)
+  of the runner applies: between double quotes and only if it is made of letters (accents
+  included), digits, space and `. _ - / \ : ( )`. With any other character do NOT run the command;
+  say `⚠️ O nome `{pasta}` tem um caractere que não posso usar em comandos ({caractere}). Use só letras, números, espaço, ponto, hífen, sublinhado e parênteses.`
+  and ask for the folder again.
+- The folder is a path inside the project, written from its root (`Conteudo/Prontos`). When the
+  script refuses it ("Não copiei: …"), nothing was recorded — also when it is the only line of the
+  output, with no `ENTREGA:` line: show it as it came and ask for another folder (or "não").
+- To copy one delivery somewhere else without changing the answer of the crew, the same command
+  ends with `--destino "{pasta}"` (same rule for `{pasta}`); only when the user asks for it.
+
+## Changing the folder later
+
+When the user asks to change where the copy goes, to stop copying or to copy again ("muda a pasta
+de entrega", "não quero mais cópia", "volta a copiar"): run the delivery of the **last run** of the
+crew ("A run that already ended", below), with the command ending with
+`--lembrar-destino "{pasta}"` (same rule for `{pasta}`), or with `--lembrar-destino nao` to stop.
+With no folder in the request, ask which. Never edit the `crew.yaml` by hand.
+
+## When the script does not run
+
+The script did not run when there is no Node, an error, or no `ENTREGA:` line at the end (it prints
+one line in PT-BR and stops, with nothing written). Then never build the folder by hand. If the line points to something in the
+command you wrote (an option, a channel, the run), fix the command and run it once more. Otherwise
+tell the user, list the approved files (the paths of your list) and go on with the run:
+
+```
+⚠️ A entrega automática não rodou: {motivo}
+Os arquivos aprovados estão em:
+- {caminho}
+```
+
+`{motivo}` is the line the script printed, or what kept it from running. The completion summary
+of the runner then shows this list in place of the `entrega/` folder.
+
+**A refused destination is not that.** When the only line is "Não copiei: … Recebi: {valor}." (the
+folder given to `--lembrar-destino` was refused; nothing was written), the script did run: show
+that line to the user as it came and ask for another folder (or "não"), as in Step 5 — never answer
+it with "A entrega automática não rodou".
+
+## A run that already ended
+
+When the user asks to deliver a run that is over (it was run before this folder existed, or the
+delivery did not run):
+
+1. Find the crew and the run. If the user did not say which, list the folders of
+   `crews/{name}/output/` with the IDE's folder-listing tool (no shell command) and ask.
+2. Read the steps of `crews/{name}/pipeline/`. For the `outputFile` of each creation or rendering
+   step (same rules of Step 1 for what stays out and for `{formato}`), run:
+   `node _opencrew/core/scripts/caminho.mjs "{name}" entrada --run "{run_id}" --arquivo "{outputFile}"`
+   `CAMINHO:OK {path}` → that path is the item. `CAMINHO:FALTA` → the file is not in that run:
+   leave it out.
+3. Nobody recorded what was approved in that run, so show the list and wait for the "sim":
+   ```
+   Entrega da execução {run_id} da crew {name}. Arquivos:
+   - {caminho} ({formato})
+   Posso montar a entrega com esta lista? (sim / não)
+   ```
+4. On "sim", follow Steps 2 to 5. No step of the pipeline runs again, and nothing is published.
+
+## Rules
+
+- **DO** show the output of the script as it came; the folder and file names and the `LEIA-ME.md`
+  are fixed PT-BR, whatever the user's language.
+- **DO** run the delivery again whenever an approved file changes.
+- **DO NOT** create, edit or delete anything inside `entrega/` yourself.
+- **DO NOT** write the destination in the `crew.yaml` yourself, nor copy the delivery by hand.
+- **DO NOT** put in the list a file the user did not approve, nor a path you guessed.
+- **DO NOT** treat `ENTREGA:INCOMPLETA` as an error of the script: it is its answer.