altis-claude-harness 1.4.2 → 1.4.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "altis-claude-harness",
-  "version": "1.4.2",
+  "version": "1.4.3",
   "description": "Padroes Claude Code da Altis Sistemas - instalador, auto-update e liberacao por estacao",
   "bin": {
     "altis-claude-harness": "bin/cli.js"

package/payload/commands/altis-docsai.md

@@ -1,32 +1,33 @@
 ---
-description: Solicita a documentação de uma tela do ERP Altis ao servidor altis-docsai (MCP) e entrega o resultado no padrão definido pelo usuário.
+description: Solicita a documentação de uma rotina/tela do ERP Altis ao servidor altis-docsai (MCP) e salva o pacote .zip retornado.
 ---
 
 # /altis-docsai — Documentação remota de telas do ERP Altis
 
-Você vai solicitar a documentação de uma tela ao servidor interno `altis-docsai` (tools MCP `mcp__altis-docsai__*`) e entregar o resultado ao usuário.
+Você vai solicitar a documentação de uma rotina/tela ao servidor interno `altis-docsai` (tools MCP `mcp__altis-docsai__*`). O servidor lê o **código do monorepo** (fonte da verdade), monta o documento no **template padrão do projeto** e devolve um **pacote `.zip`** (md + `img/` quando houver print).
 
 ## Passos
 
 1. **Colete os dados** (pergunte o que faltar):
-   - **Nome da tela** ou caminho de menu (obrigatório).
-   - **Print da tela** (opcional, recomendado): imagem colada na conversa ou caminho de arquivo. Limite: 5 MB.
+   - **Caminho da rotina** ou nome da tela (obrigatório). Ex.: `Cadastros > Funcionários > Autorizações de Telas`.
+   - **Print da tela** (opcional): imagem colada na conversa ou caminho de arquivo. Limite: 5 MB. O print só ilustra — a documentação sai do código mesmo sem print.
      Para converter arquivo em base64 no PowerShell:
      `[Convert]::ToBase64String([IO.File]::ReadAllBytes('C:\caminho\print.png'))`
-   - **Tipo** (opcional): chame `listar_tipos_documentacao` se precisar mostrar as opções ao usuário.
+   - **Tipo** (opcional): chame `listar_tipos_documentacao` se precisar mostrar as opções.
+   - **Preferências adicionais** (opcional): se o usuário tiver pedidos extras, passe em `padrao_documentacao` — mas o **template do projeto sempre prevalece** (Objetivo → Passo a passo → Descrição da tela → Observações).
 
-2. **Defina o padrão de saída**: pergunte ao usuário o padrão desejado (estrutura de seções, nível de detalhe, público-alvo, idioma). Monte um template claro em markdown descrevendo as seções esperadas — esse texto será obedecido estritamente pelo servidor. Se o usuário não tiver preferência, proponha: Identificação da tela, Caminho de menu, Visão geral, Campos e colunas, Passo a passo de uso, Validações e mensagens, Atalhos, Regras de negócio.
+2. **Solicite**: chame `solicitar_documentacao` com `nome_tela`, `padrao_documentacao` (preferências ou vazio), `print_base64` (se houver) e `tipo_doc` (se souber). Informe ao usuário o `job_id`, a posição na fila e a estimativa em minutos.
 
-3. **Solicite**: chame `solicitar_documentacao` com `nome_tela`, `padrao_documentacao`, `print_base64` (se houver) e `tipo_doc` (se souber). Informe ao usuário o `job_id`, a posição na fila e a estimativa em minutos.
+3. **Acompanhe**: chame `consultar_documentacao(job_id)` aguardando ~30 segundos entre consultas (`Start-Sleep -Seconds 30` no PowerShell / `sleep 30` no bash). Pare quando o status for `CONCLUIDO` ou `ERRO`.
 
-4. **Acompanhe**: chame `consultar_documentacao(job_id)` aguardando ~30 segundos entre consultas (`Start-Sleep -Seconds 30` no PowerShell / `sleep 30` no bash). Pare quando o status for `CONCLUIDO` ou `ERRO`.
-
-5. **Entregue**:
-   - `CONCLUIDO`: entregue a documentação **exatamente como veio do servidor** — não reformate nem resuma. Se houver `avisos`, mostre-os ao final. Ofereça salvar em arquivo `.md`.
-   - `ERRO`: mostre a mensagem ao usuário. Se for limite da conta do servidor, oriente a re-solicitar mais tarde.
+4. **Entregue**:
+   - `CONCLUIDO`: o resultado traz `zip_base64` + `zip_nome` (e `relatorio` do processamento). **Salve o `.zip`** em disco e informe o caminho ao usuário:
+     `[IO.File]::WriteAllBytes('C:\caminho\{zip_nome}', [Convert]::FromBase64String($zipBase64))`
+     Mostre o `relatorio` (etapas T1/T3/T4). Se houver `avisos`, exiba-os. **Não** tente colar o conteúdo do documento — a entrega é o `.zip`.
+   - `ERRO`: mostre a mensagem. Se for limite da conta do servidor, oriente a re-solicitar mais tarde.
 
 ## Regras
 
-- Nunca reformate ou resuma a documentação recebida — o padrão já foi aplicado no servidor.
-- Print acima de 5 MB: peça ao usuário para reduzir/recortar, ou envie sem print.
-- Servidor fora do ar (erro de conexão nas tools): avise o usuário e encerre — não tente analisar o código localmente.
+- A entrega é o **`.zip`** — salve-o, não reformate nem resuma.
+- Print acima de 5 MB: peça para reduzir/recortar, ou envie sem print (é opcional).
+- Servidor fora do ar (erro de conexão nas tools): avise o usuário e encerre — não tente documentar localmente.