@aksp/opencrew 1.8.0 → 1.10.0

package/CHANGELOG.md

@@ -3,6 +3,133 @@
 All notable changes to opencrew are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/).
 
+## [1.10.0] — 2026-10-07
+
+Fase U3b "Documento Word, com perfil de documento oficial" (`specs/fase-u3b-documento-word.md`).
+Chega a quem já usa com um `npx @aksp/opencrew@latest update`; o papel timbrado é criado só quando
+você pede.
+
+Ainda não nesta versão: imagem no corpo do texto, link clicável, sumário, nota de rodapé e
+numeração automática; logotipo em JPEG ou SVG; ler ou regravar um modelo `.dotx`; mais de um
+perfil por projeto na entrega; PDF direto (o Word salva como PDF). O resultado foi conferido no
+Word; no LibreOffice e no Google Docs, não.
+
+### Added
+- **Documento Word.** O texto em markdown (`.md` ou `.txt`) vira um arquivo do Word (`.docx`) com
+  as mesmas palavras e os mesmos números, na mesma ordem. No chat: `/opencrew documento <arquivo>`
+  (ou "Documento Word" no menu). No terminal:
+  `node _opencrew/core/scripts/documento.mjs "<arquivo.md>"`. O Word sai ao lado do texto, com o
+  mesmo nome; `--saida` escolhe outra pasta ou outro nome. Antes, quem precisava de um documento
+  oficial mantinha um script à parte, com o texto dentro do código.
+- **Papel timbrado (perfil de documento oficial).** Um arquivo de texto do projeto,
+  `_opencrew/_memory/documento-oficial.md`, guarda o logotipo (PNG), três linhas de cabeçalho, o
+  rodapé com "Página X de Y", as margens, a fonte e o tamanho da letra. Na primeira vez a IA
+  pergunta se você quer configurar e preenche o arquivo com as suas respostas; `--criar-perfil`
+  cria o arquivo a partir do modelo. O `update` não toca nele, e nenhum comando o sobrescreve.
+- **Três marcações para documento.** `::: titulo` e `::: subtitulo` (centralizados),
+  `::: quebra-de-pagina` (o anexo começa em página nova) e `::: assinaturas` … `:::` (as linhas
+  de assinatura, duas por linha, com o nome e o cargo). Títulos `#`, `##` e `###`, tabelas, listas,
+  negrito e itálico saem como estilos do Word.
+- **O texto oficial não muda.** Número de item escrito por você ("1.", "6.1.", "a)", "§ 1º") vai
+  como texto: nada é renumerado, reordenado nem corrigido.
+- **Na entrega, a pasta `documentos/`.** O passo com `format: documento-oficial` sai como
+  `entrega/documentos/<nome>.docx`, com o papel timbrado do projeto, e o LEIA-ME ganha a seção
+  "Documentos", com o que conferir no Word. Sem papel timbrado configurado, a entrega avisa e
+  diz como criar. A cópia para a pasta do projeto leva `documentos/`
+  junto.
+- **Guia `documento-oficial`** (o 23º guia de melhores práticas): ensina o redator a escrever um
+  texto que vira documento — um parágrafo por linha, número escrito à mão, anexo depois da quebra
+  de página, assinaturas no fim. Crews novas recebem esse formato no passo cujo resultado é um
+  documento para imprimir, assinar ou protocolar.
+- **Avisos de conversão.** O relatório diz o que ficou como texto (imagem, marcação `:::`
+  desconhecida, bloco de assinaturas sem o `:::` final) e quantos caracteres inválidos foram
+  removidos. Aviso não impede o documento.
+
+### Changed
+- **Um Word que já existe não é trocado em silêncio.** Se há um `.docx` diferente no destino, nada
+  é gravado e a IA pergunta antes de substituir (`--substituir`). Igual, byte a byte: nada a fazer.
+- **Perfil com erro não gera documento.** Chave desconhecida, valor fora da faixa, logotipo que
+  não existe, não é PNG ou passa de 2 MB: a mensagem diz a linha, e nada é gravado.
+- O menu "Mais opções" ganha "Documento Word".
+
+### Internal
+- `documento.mjs` e os módulos de `scripts/documento/` (sem dependência, sem `node:zlib`, até 200
+  linhas cada): zip sem compressão, com CRC-32 próprio e data fixa — o mesmo texto, com o mesmo
+  perfil, dá o mesmo arquivo, byte a byte. `modelos/documento-oficial.md` é o modelo do perfil;
+  `prompts/documento.prompt.md`, o prompt da rota. O `src/` não mudou; o runner não cresceu (874
+  linhas).
+- `AGENTS.md`: a regra 15 cita o `documento.mjs`; a regra 7 diz que abrir o `.docx` no Word não é
+  conferido pela porta.
+
+## [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

package/README.md

@@ -30,11 +30,15 @@ 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.
+- 📄 **Documento Word em papel timbrado** — ata, ofício, declaração: o texto em markdown vira um
+  arquivo do Word com as mesmas palavras, o seu logotipo no cabeçalho, "Página X de Y" no rodapé
+  e as linhas de assinatura. Um comando: `/opencrew documento <arquivo>`.
 - 🎛️ **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.
@@ -180,10 +184,11 @@ meu-projeto/
 │   │   ├── runner.pipeline.md    ← executor de pipeline
 │   │   ├── 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, caminhos, entrega e os scripts do Escritório
+│   │   ├── best-practices/       ← 23 guias de melhores práticas + _catalog.yaml
+│   │   ├── scripts/              ← verificador, conferência de fontes, caminhos, entrega, documento Word e os scripts do Escritório
+│   │   ├── modelos/              ← modelo do perfil de documento oficial (papel timbrado)
 │   │   ├── escritorio/           ← página do Escritório ao vivo (abre com /opencrew dashboard)
-│   │   └── prompts/              ← 14 prompts de fase (discovery, design, build, entrega, etc.)
+│   │   └── prompts/              ← 15 prompts de fase (discovery, design, build, entrega, documento, etc.)
 │   ├── agents/                   ← 5 agentes base compartilhados
 │   │   ├── researcher.agent.md
 │   │   ├── copywriter.agent.md
@@ -192,14 +197,15 @@ meu-projeto/
 │   │   └── strategist.agent.md
 │   ├── _memory/
 │   │   ├── company.md            ← perfil da sua empresa (onboarding)
-│   │   └── preferences.md        ← idioma, tier padrão, Escritório ligado ou desligado
+│   │   ├── preferences.md        ← idioma, tier padrão, Escritório ligado ou desligado
+│   │   └── documento-oficial.md  ← seu papel timbrado (só existe depois que você pede; veja "Documento Word")
 │   └── .opencrew-version
 │
 ├── 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
+│   │       └── 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
@@ -230,6 +236,7 @@ entrega/
 ├── whatsapp/       ← mensagem.txt
 ├── twitter/        ← tweet.txt (na thread: tweet-1.txt, tweet-2.txt…)
 ├── youtube/        ← o roteiro
+├── documentos/     ← o Word (.docx) de cada texto de formato documento-oficial
 ├── outros/         ← arquivo sem canal (proposta, minuta, relatório), como está
 └── editaveis/      ← o HTML dos slides, para quem quiser ajustar
 ```
@@ -239,26 +246,129 @@ 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" ou "Não está pronto"),
-  os arquivos, de onde cada um veio e os passos, numerados. "Antes de usar" junta o que falta;
-  "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.** Sobrou um `[PREENCHER]` ou um texto acima do limite? O
-  canal aparece como "Não está pronto" e a crew pergunta se você quer corrigir agora ou seguir
-  assim.
+- **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 é refeita 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.
+- **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.
 
 ---
 
+## Documento Word
+
+Ata, ofício, declaração, contrato: quando o resultado é um documento para imprimir, assinar ou
+protocolar, o OpenCrew transforma o texto em markdown num arquivo do Word (`.docx`) com **as
+mesmas palavras e os mesmos números, na mesma ordem**. Você escreve (ou a crew escreve) o texto;
+um comando gera o documento.
+
+**Como gerar:** no chat da sua IDE, digite `/opencrew documento Atas/ata.md` — ou escolha
+"Documento Word" em "Mais opções" do menu. O Word sai ao lado do texto, com o mesmo nome
+(`Atas/ata.docx`), e a IA mostra o relatório: onde gravou, qual papel timbrado usou e os avisos.
+Também funciona direto no terminal, na pasta do projeto:
+
+```bash
+node _opencrew/core/scripts/documento.mjs "Atas/ata.md"
+node _opencrew/core/scripts/documento.mjs "Atas/ata.md" --saida "Documentos/Prontos"
+node _opencrew/core/scripts/documento.mjs --criar-perfil     # cria o arquivo do papel timbrado
+```
+
+**Papel timbrado.** Na primeira vez, a IA pergunta se você quer configurar o papel timbrado do
+projeto. Com o "sim", ela cria o perfil de documento oficial em
+`_opencrew/_memory/documento-oficial.md`, pergunta o logotipo, as linhas do cabeçalho e o rodapé
+e preenche o arquivo. É um arquivo de texto, seu, que o `update` nunca toca. Nele ficam:
+
+- o logotipo (um PNG de até 2 MB, dentro do projeto) e a largura dele;
+- três linhas de cabeçalho (nome da organização, registro, site e contato);
+- o texto do rodapé e o "Página X de Y";
+- as margens, a fonte e o tamanho da letra.
+
+Com o "não", o documento sai sem timbre, com as margens padrão e "Página X de Y" no rodapé. É um
+perfil por projeto; mudar o perfil não muda os documentos já gerados.
+
+**Como escrever o texto.** Markdown comum, um parágrafo por linha, com três marcações a mais:
+
+```
+::: titulo ATA DA REUNIÃO DA DIRETORIA
+::: subtitulo Realizada em 5 de maio de 2026
+
+# I. Abertura
+Aos 5 dias do mês de maio de 2026, reuniu-se a diretoria.
+
+::: assinaturas
+Ana Lima | Presidente
+Rui Sá | Secretário
+:::
+
+::: quebra-de-pagina
+::: titulo ANEXO I — CALENDÁRIO
+```
+
+- `::: titulo` e `::: subtitulo` saem centralizados; `#`, `##` e `###` viram os títulos das
+  seções; tabela vira tabela; `- item` vira lista com marcador.
+- `::: quebra-de-pagina` começa uma página nova (para o anexo); `::: assinaturas`, uma linha
+  `Nome | Cargo` por pessoa e `:::` para fechar montam as linhas de assinatura.
+- **Os números são os seus.** "1.", "6.1.", "a)" e "§ 1º" vão como texto, do jeito que você
+  escreveu: nada é renumerado, reordenado nem corrigido.
+- **Nada é trocado sem você saber.** Se já existe um Word diferente com esse nome (você pode tê-lo
+  editado), nada é gravado: a IA pergunta antes de substituir.
+- **Avisos de conversão.** O relatório diz o que não coube no documento e ficou como texto: imagem,
+  marcação `:::` desconhecida, bloco de assinaturas sem o `:::` final. Perfil com erro (chave
+  desconhecida, logotipo que não existe) não gera documento: a mensagem diz a linha.
+- **O Word é uma cópia do texto.** O que você mudar no Word não volta para o texto: altere o texto
+  e gere de novo. Para ter um PDF, abra o documento no Word e use Salvar como PDF.
+
+**Dentro de uma crew.** O passo cujo resultado é um documento usa `format: documento-oficial` (o
+guia que ensina o redator a escrever assim). Na entrega, esse texto vira
+`entrega/documentos/<nome>.docx`, com o papel timbrado do projeto, e o LEIA-ME diz o que conferir.
+Crews novas já nascem assim; numa crew antiga, acrescente `format: documento-oficial` ao passo.
+
+**O que não faz.** Não põe imagem no corpo do texto, link clicável, sumário, nota de rodapé nem
+numeração automática; o logotipo é só PNG; tamanhos e cores dos títulos são fixos; não lê nem
+regrava um modelo `.dotx`. Os testes conferem a estrutura do arquivo; como ele fica na página,
+você confere no Word. No LibreOffice e no Google Docs o resultado não foi conferido.
+
+Quem já usa o OpenCrew recebe o documento Word com um `npx @aksp/opencrew@latest update`.
+
+---
+
 ## Escritório ao vivo
 
 Quer ver a equipe trabalhando? O **Escritório** é uma página em pixel-art, aberta no navegador,
@@ -323,6 +433,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ê
@@ -380,6 +496,7 @@ npx @aksp/opencrew update --check
 | `/opencrew settings` | Altera preferências (idioma, tier, Escritório) |
 | `/opencrew dashboard` | Liga e abre o Escritório ao vivo (a equipe trabalhando, no navegador) |
 | `/opencrew dashboard off` | Desliga o Escritório |
+| `/opencrew documento <arquivo>` | Transforma um texto (`.md` ou `.txt`) em documento Word, com o papel timbrado do projeto |
 | `/opencrew show-company` | Mostra o perfil da empresa |
 | `/opencrew edit-company` | Reconfigura o perfil da empresa |
 | `/opencrew help` | Mostra a lista de comandos |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aksp/opencrew",
-  "version": "1.8.0",
+  "version": "1.10.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

@@ -10,6 +10,7 @@ On activation, perform these steps IN ORDER:
 1. Read the company context file: `{project-root}/_opencrew/_memory/company.md`
 2. Read the preferences file: `{project-root}/_opencrew/_memory/preferences.md`
 3. Check if company.md is empty or contains only the template — if so, trigger ONBOARDING
+   (except for `/opencrew documento` and the `
 4. Otherwise, display the MAIN MENU
 
 ## Onboarding Flow (first time only)
@@ -36,7 +37,10 @@ numbered list and ask the user to reply with a number.
 **Primary menu:** Create a new crew · Run an existing crew · My crews ·
 More options
 
-**More options:** Skills · Company profile · Settings & Help
+**More options:** Skills · Documento Word · Company profile · Settings & Help
+
+"Documento Word" turns a text file of the project into a Word document: load
+`_opencrew/core/prompts/documento.prompt.md`, which asks for the file.
 
 ## Command Routing
 
@@ -60,8 +64,10 @@ Route input to the matching action:
 | `/opencrew settings` | Show/edit preferences.md |
 | `/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 documento <arquivo>` | Load `_opencrew/core/prompts/documento.prompt.md` → turn that text file (`.md` or `.txt`) into a Word document (`.docx`) |
 | `/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
@@ -123,10 +129,13 @@ and touch nothing else: stop no process, delete no file.
   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
+- Exception: the report of the Word document script (`documento.mjs`) and the "Página X de Y" of
+  the footer it writes are fixed PT-BR too
 
 ## Critical Rules
 
-- NEVER skip the onboarding if company.md is not configured
+- NEVER skip the onboarding if company.md is not configured (the Word document route is the only
+  exception: it does not use the company context)
 - ALWAYS load company context before running any crew
 - ALWAYS present checkpoints to the user — never skip them
 - ALWAYS save outputs to the crew's output directory

package/templates/_opencrew/.opencrew-version

@@ -1 +1 @@
-1.8.0
+1.10.0

package/templates/_opencrew/core/best-practices/_catalog.yaml

@@ -114,3 +114,8 @@ catalog:
     name: "WhatsApp Broadcast"
     whenToUse: "Creating agents that produce WhatsApp broadcast messages or conversational marketing content."
     file: whatsapp-broadcast.md
+
+  - id: documento-oficial
+    name: "Documento oficial (Word)"
+    whenToUse: "Creating agents that produce a document to print, sign or file (minutes, official letter, statement, contract, formal report) that becomes a Word file."
+    file: documento-oficial.md