@aksp/opencrew 1.6.0 → 1.6.2

package/CHANGELOG.md

@@ -3,6 +3,81 @@
 All notable changes to opencrew are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/).
 
+## [1.6.2] — 2026-10-05
+
+Correção da 1.6.1. Chega a quem já usa com um `npx @aksp/opencrew@latest update`.
+
+### Fixed
+- **Node 20: o verificador não esgota mais a memória com texto grande.** Um post, tweet ou
+  legenda de dezenas de milhares de caracteres numa peça só derrubava o verificador no Node 20,
+  sem relatório (o runner avisava que a verificação não rodou). A contagem de caracteres passou a
+  ser feita em janelas, com o mesmo resultado. O defeito vinha da 1.5.0; Node 22 e 24 não o
+  tinham.
+
+### Internal
+- Release: a tag só sai depois do CI verde nas quatro células (Ubuntu e Windows, Node 20 e 22).
+  A 1.6.1 foi publicada com o CI do Node 20 vermelho, porque a publicação roda só no Node 22.
+
+## [1.6.1] — 2026-10-05
+
+Fase R1 "Reparos da 1.6.0: o verificador mede de verdade" (`specs/fase-r1-reparos-1-6-1.md`),
+vinda da revisão das specs (`docs/auditoria/2026-10-04-revisao-specs.md`). Chega a quem já usa com
+um `npx @aksp/opencrew@latest update`.
+
+### Fixed
+- **O verificador mede o texto escrito com rótulos**, do jeito que os próprios best-practices
+  ensinam (`=== CAPTION ===`, `=== HASHTAGS ===`, `=== SLIDES ===`, `=== HOOK ===`, `=== TWEET ===`,
+  `=== TITLE ===`). Antes respondia "Nada a apontar" sem medir.
+- **"Não medido" é dito**: com o formato informado e a peça principal não achada, o relatório
+  alerta em vez de aprovar em silêncio. O resumo passa a ser
+  `X bloqueios, Y alertas, Z não medidos`.
+- **Bloqueios falsos**: cor hexadecimal (`#666666`), número comum, CEP e "XXX Congresso" não são
+  mais "Placeholder"; `{{name}}` em e-mail e WhatsApp vira nota; termo proibido vale como palavra
+  inteira ("IA" não bloqueia "dia a dia"); o termo que o usuário mandou preferir não é proibido.
+- **Arquivo local sem limites não desliga o verificador**: os limites de
+  `_opencrew/best-practices.local/` somam aos do core, chave a chave.
+- **Erros que passavam por OK**: rodar fora da pasta do projeto ou com crew inexistente agora dá
+  erro (código 1), sem linha de status; um arquivo ausente na lista não derruba a verificação dos
+  outros; imagem e `.docx` não são lidos como texto; no HTML, só o texto visível e os links;
+  arquivo de texto fora do UTF-8 vira alerta "Não verificado" (UTF-16 com marca é lido).
+- **Relatório que não saía**: com o projeto aberto por junção ou link de pasta, os dois scripts
+  terminavam sem imprimir nada.
+- **Várias peças no mesmo arquivo** são medidas uma a uma (três posts não viram uma soma); a linha
+  `---` não encerra mais a seção; slides contados nas escritas comuns ("📌 Slide 2", "Slide #3").
+  Título e meta description em bloco YAML (`>-`, `|`) são medidos inteiros; `[PREENCHER: …]`
+  longo não escapa; imagem e link de âncora não contam como link.
+- **Conferência de fontes**: enxerga `caminho:` com comentário ou aspas e os arquivos de `agents/`
+  (agentes e tasks); recusa crew de fora do projeto; mensagens corrigidas ("Não há correção
+  automática…", aviso de busca parcial); caminho com marcador de modelo (`AAAA-MM-DD`) e comando
+  entre crases não são conferidos; o `--corrigir` troca só o caminho citado (antes trocava
+  qualquer trecho igual) e nunca aponta o destino de gravação de um agente para um arquivo que
+  já existe.
+- **`init --repair-bridges`** sem `--ide` regrava só as IDEs instaladas (antes criava as pontes
+  das 9); `--all` regrava todas; o resumo lista as cópias de segurança. Numa pasta sem workspace,
+  para com erro em vez de instalar; num workspace sem manifesto, não cria um.
+
+### Changed
+- **Runner**: passa o formato de cada arquivo ao verificador (`caminho=formato`); laço de revisão
+  com 3 ciclos por padrão (`max_review_cycles`) e saída também quando não há bloqueio; regras do
+  revisor injetadas em toda execução (valem para crews já criadas); avisa quando um script não
+  rodou; a conferência de fontes roda antes de carregar as fontes; a aprovação final mostra o que
+  ficou sem medir e as notas do relatório.
+- Crew nova recebe o limite de ciclos de revisão pelo tier: Express 1, Standard 2, Full 3.
+- Em blog, a seção com cabeçalho de outro canal ("Como postar no LinkedIn") não é medida como
+  post, e o relatório diz isso ("Não medido").
+- Hashtags sob um cabeçalho que cita o canal ("Hashtags LinkedIn") somam à peça desse canal.
+- "Aceitar assim mesmo" não promete mais registro: o registro chega com a entrega por canal.
+- Texto solto depois de uma linha `---` passa a contar na peça de cima. Telefone falso de 8 ou 9
+  dígitos, fora de link, deixa de ser pego.
+
+### Internal
+- Scripts do runtime em módulos (`verificar/`, `conferir-fontes/`, `comum.mjs`); leitor de peças
+  exportado para a próxima fase. Todos os cenários R1 com teste de mesmo ID; teste de upgrade
+  1.6.0 → 1.6.1.
+- Revisão do código antes da tag: sete leituras independentes e duas rodadas de conserto com
+  teste; o que ficou adiado tem destino na spec (§11 e §12).
+- Revisão das specs (265 achados) e faxina de documentos; specs R1, U3a e U3b.
+
 ## [1.6.0] — 2026-10-02
 
 Trilha U2 "Crew que conhece o projeto" + U6 "Convivência" (`specs/fase-u2-crew-que-conhece-o-projeto.md`).
@@ -32,6 +107,7 @@ Trilha U2 "Crew que conhece o projeto" + U6 "Convivência" (`specs/fase-u2-crew-
 - Migração do formato de memória faz `memories.md.bak` e avisa (fim do reset silencioso); regra única
   sobre o que vai para a memória (só feedback explícito).
 - `_build/discovery.yaml` agora em `crews/{code}/_build/`; build grava caminhos relativos à raiz.
+
 ## [1.5.0] — 2026-10-02
 
 Trilha U1 "Revisor com dentes" — primeira melhoria vinda do uso real

package/README.md

@@ -143,6 +143,12 @@ enxuto — todos apontam para a mesma fonte.
 | `QWEN.md` (ponte) + `.agents/skills/opencrew/SKILL.md` | Qwen Code |
 | `AGENTS.md` (ponte) + `.trae/rules/opencrew.md` | Trae |
 
+> **Claude Cowork (modo alternativo):** o Cowork não reconhece o comando `/opencrew` (ele não lê
+> skills de dentro da pasta do projeto). Funciona assim: abra a pasta do projeto e peça, em texto:
+> *"Leia o arquivo `_opencrew/core/system.md` deste projeto e siga as instruções dele. Mostre o
+> menu principal."* Depois use frases como "rodar a crew blog-semanal" no lugar dos comandos com `/`.
+
+
 > ⚠️ **Importante:** `CLAUDE.md`, `GEMINI.md` e os demais arquivos de IDE são
 > pontes geradas automaticamente. Eles são finos (5-10 linhas) e usam blocos
 > marcados (`<!-- opencrew:start/end -->`) que permitem **merge não-destrutivo**
@@ -198,7 +204,7 @@ meu-projeto/
 
 > O dashboard visual (`dashboard/index.html`) **não é instalado** pelo `init` — ele vive
 > só no repositório do OpenCrew e ainda é experimental (decisão de publicar ou remover:
-> Fase 4 da auditoria em `docs/auditoria/`).
+> fase U3a — ver `IDEIAS.md` no repositório).
 
 ---
 
@@ -224,12 +230,20 @@ o que você fez:
 - **Versão mais nova instalada?** O `update` não volta para uma versão mais antiga (cache do
   `npx`): ele para e pede `npx @aksp/opencrew@latest update`.
 
-Para regravar as pontes de IDEs específicas (ou adicionar uma IDE nova):
+Para regravar as pontes de IDE num workspace que já existe:
 
 ```bash
-npx @aksp/opencrew init --repair-bridges --ide=claude-code
+npx @aksp/opencrew@latest init --repair-bridges                    # só as IDEs que você já tem instaladas
+npx @aksp/opencrew@latest init --repair-bridges --ide=claude-code  # só as indicadas (ou uma IDE nova)
+npx @aksp/opencrew@latest init --repair-bridges --all              # as 9 IDEs
 ```
 
+Sem `--ide` e sem `--all`, o `init --repair-bridges` usa a mesma detecção do `update` (aqui o
+`--yes` não escolhe IDE); se não encontra nenhuma ponte, para com erro e pede `--ide=<id>`.
+O reparo não instala: numa pasta sem workspace do OpenCrew ele para com erro e pede o `init`.
+Ponte de arquivo inteiro que você editou (ex.: `.claude/skills/opencrew/SKILL.md`) é copiada
+antes para `.opencrew-backup/<data>/`, e o resumo do `init --repair-bridges` lista cada cópia.
+
 Se você está migrando de uma versão anterior a v1.3, o `update` detecta
 AGENTS.md legados (sistema completo de 150 linhas) e os substitui pela ponte
 fina. Desde a v1.4.2 o arquivo original é copiado antes para `AGENTS.md.bak` (até a v1.4.1,
@@ -268,12 +282,12 @@ npx @aksp/opencrew update --check
 | Comando | O que faz |
 |---|---|
 | `npx @aksp/opencrew init` | Instala o OpenCrew na pasta atual |
-| `npx @aksp/opencrew update` | Atualiza o framework |
+| `npx @aksp/opencrew@latest update` | Atualiza o framework |
 | `npx @aksp/opencrew update --check` (ou `--dry-run`) | Verifica se há update disponível, sem alterar nada |
 | `npx @aksp/opencrew upgrade` | Atalho para `update` |
 | `npx @aksp/opencrew init --ide=claude-code,cursor` | Instala só as pontes das IDEs indicadas |
 | `npx @aksp/opencrew init --all` (ou `-y`) | Instala as pontes de todas as IDEs |
-| `npx @aksp/opencrew init --repair-bridges` | Regrava as pontes de IDE num workspace existente |
+| `npx @aksp/opencrew@latest init --repair-bridges` | Regrava as pontes das IDEs já instaladas num workspace existente (`--ide=a,b`: só as indicadas; `--all`: as 9) |
 | `npx @aksp/opencrew version` | Mostra a versão instalada |
 | `npx @aksp/opencrew help` | Mostra ajuda dos comandos CLI |
 

package/package.json

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

package/src/cli.js

@@ -103,7 +103,8 @@ ${c.bold('Options for init')}
   --ide=a,b       Preselect IDEs (skip the prompt). Valid: ${allIdeIds().join(', ')}
   --all           Configure every supported IDE
   --yes, -y       Non-interactive; accept defaults
-  --repair-bridges  Regenerate IDE bridge files in an existing workspace
+  --repair-bridges  Rewrite the bridges of the IDEs already installed in an existing
+                    workspace (with --ide: only those; with --all: every IDE)
 
 ${c.bold('Options for update')}
   --check         Report whether an update is available without making changes

package/src/commands/init.js

@@ -6,6 +6,7 @@ import { newDelivery, deliverTree, deliverFile, writeManifest, readManifest } fr
 import { ideById, allIdeIds, AGENTS_BRIDGE } from '../lib/ides.js';
 import { pickIdes as promptIdes } from '../lib/prompts.js';
 import { UsageError } from '../lib/errors.js';
+import { repairIdeIds, backupSummary, recordRepair, NO_BRIDGES_FOUND, NO_WORKSPACE } from '../lib/migrations.js';
 import { c, log, info, ok, warn, step } from '../lib/ui.js';
 
 const STAMP = path.join('_opencrew', '.opencrew-version');
@@ -22,25 +23,13 @@ export async function init(opts = {}, { pickIdes = promptIdes } = {}) {
   const version = pkg.version;
   const state = await workspaceState(target);
 
-  // --repair-bridges mode: regenerate IDE bridge files in an existing workspace.
-  if (opts['repair-bridges'] && state !== 'none') {
-    const ids = await resolveIdes(opts, async () => allIdeIds());
-    log(`\n${c.bold(c.cyan('opencrew'))} ${c.dim('v' + version)} — repairing IDE bridges`);
-    log(c.dim(`Target: ${target}\n`));
-    const previous = await readManifest(target);
-    const repairCtx = newDelivery(target, previous);
-    await writeBridges(target, ids, { overwrite: true, ctx: repairCtx });
-    await writeManifest(target, version, { ...(previous?.files ?? {}), ...repairCtx.files });
-
-    log(`\n${c.green(c.bold('Done!'))} IDE bridges regenerated.\n`);
-    log(`${c.bold('Next step:')} Restart your IDE, then type ${c.cyan('/opencrew')} to verify.\n`);
-    return;
-  }
+  if (opts['repair-bridges'] && state === 'none') throw new UsageError(NO_WORKSPACE); // before any write
+  if (opts['repair-bridges']) return repairBridges(target, version, opts);
 
   if (state === 'complete') {
     warn('An opencrew workspace already exists here.');
-    info(`To update only the framework, use: ${c.cyan('npx @aksp/opencrew update')}`);
-    info(`To repair IDE bridges, use: ${c.cyan('npx @aksp/opencrew init --repair-bridges')}`);
+    info(`To update only the framework, use: ${c.cyan('npx @aksp/opencrew@latest update')}`);
+    info(`To repair IDE bridges, use: ${c.cyan('npx @aksp/opencrew@latest init --repair-bridges')}`);
     info(`To reinstall from scratch, delete _opencrew/ first, then run init again.`);
     return;
   }
@@ -103,6 +92,25 @@ export async function init(opts = {}, { pickIdes = promptIdes } = {}) {
   log(`     No API keys needed up front — opencrew asks for them in chat only if a skill you use requires one.\n`);
 }
 
+/**
+ * --repair-bridges: rewrite IDE bridge files in an existing workspace. --ide wins (even next
+ * to --all); --all alone means every IDE; otherwise only the IDEs `update` would detect.
+ */
+async function repairBridges(target, version, opts) {
+  const ids = await resolveIdes({ ide: opts.ide }, () => repairIdeIds(target, opts));
+  if (!ids.length) throw new UsageError(NO_BRIDGES_FOUND); // before the first write
+  log(`\n${c.bold(c.cyan('opencrew'))} ${c.dim('v' + version)} — repairing IDE bridges`);
+  log(c.dim(`Target: ${target}\n`));
+  const ctx = newDelivery(target, await readManifest(target));
+  await writeBridges(target, ids, { overwrite: true, ctx });
+  await recordRepair(ctx, version); // only where a manifest already exists
+  const [copied, ...copies] = backupSummary(ctx);
+  if (copied) warn(copied);
+  for (const copy of copies) log(copy);
+  log(`\n${c.green(c.bold('Done!'))} IDE bridges regenerated.\n`);
+  log(`${c.bold('Next step:')} Restart your IDE, then type ${c.cyan('/opencrew')} to verify.\n`);
+}
+
 /**
  * Copy the framework payload into `target` without overwriting anything.
  * Never copies the version stamp: only a finished init writes it.
@@ -130,8 +138,8 @@ async function workspaceState(target) {
 
 /**
  * Decide which IDEs to configure. --all / --yes → every IDE; --ide → validated list;
- * nothing → `fallback()` (the interactive prompt). Throws UsageError if --ide names no
- * valid IDE.
+ * nothing → `fallback()` (the interactive prompt; in repair mode, the detection). Throws
+ * UsageError if --ide names no valid IDE.
  */
 async function resolveIdes(opts, fallback) {
   if (opts.all || opts.yes) return allIdeIds();

package/src/lib/migrations.js

@@ -1,10 +1,11 @@
 // What `update` does beyond refreshing _opencrew/core and the catalog skills, so that every
-// improvement reaches people who already use OpenCrew (AGENTS.md rule 14).
+// improvement reaches people who already use OpenCrew (AGENTS.md rule 14). The IDE detection
+// is shared with `init --repair-bridges`, whose helpers live here too.
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
 import { exists, writeBridgeFile } from './fsx.js';
-import { IDES } from './ides.js';
-import { deliverFile } from './manifest.js';
+import { IDES, allIdeIds } from './ides.js';
+import { deliverFile, writeManifest } from './manifest.js';
 
 /** Semver compare (no pre-release tags): >0 if a > b, <0 if a < b, 0 if equal. */
 export function compareVersions(a, b) {
@@ -46,6 +47,42 @@ export async function detectInstalledIdes(target) {
   return found;
 }
 
+/**
+ * IDE ids `init --repair-bridges` rewrites when --ide is not given: every IDE with --all,
+ * otherwise the ones `update` would detect. --yes chooses nothing here.
+ */
+export async function repairIdeIds(target, { all } = {}) {
+  if (all) return allIdeIds();
+  return (await detectInstalledIdes(target)).map((ide) => ide.id);
+}
+
+/** `init --repair-bridges` found no bridge and got neither --ide nor --all. */
+export const NO_BRIDGES_FOUND =
+  `Não encontrei pontes de IDE aqui. Use \`--ide=<id>\` para escolher. Ids válidos: ${allIdeIds().join(', ')}.`;
+
+/** `init --repair-bridges` in a folder that is not a workspace: the repair never installs. */
+export const NO_WORKSPACE =
+  'Não encontrei um workspace do OpenCrew nesta pasta. O reparo não instala: para instalar, rode `npx @aksp/opencrew@latest init`.';
+
+/**
+ * Add the bridges a repair rewrote to the manifest — only when the workspace has one. Without
+ * it (installed up to 1.5.0) none is created: a bridges-only manifest would make the next
+ * `update` call every older file "edited by you" and hide its first-protected-update notice.
+ */
+export async function recordRepair(ctx, version) {
+  if (ctx.manifest) await writeManifest(ctx.target, version, { ...ctx.manifest.files, ...ctx.files });
+}
+
+/** Summary lines of a delivery's backup copies, each with its path in .opencrew-backup/<date>/. */
+export function backupSummary(ctx) {
+  if (!ctx.copied.length) return [];
+  const dir = path.relative(ctx.target, ctx.backupDir).split(path.sep).join('/');
+  return [
+    `${ctx.copied.length} cópia(s) de segurança feita(s) antes de regravar:`,
+    ...ctx.copied.map((file) => `    ${dir}/${file}`),
+  ];
+}
+
 /** Rewrite the bridges of the installed IDEs only (frontmatter files whole, others by block). */
 export async function refreshBridges(ctx, ides) {
   const done = new Set();

package/templates/_opencrew/.opencrew-version

@@ -1 +1 @@
-1.6.0
+1.6.2

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

@@ -410,6 +410,8 @@ side_effects: irreversible  # REQUIRED for any step that publishes, posts, sends
                             # distributes outside the project (it cannot be undone). The Pipeline
                             # Runner never retries these automatically, and Gate 2c places them last.
                             # Omit for every other step.
+max_review_cycles: {N}  # ONLY for the review step: write it next to its `on_reject`.
+                        # By crew tier (`crew.tier` in design.yaml): Express 1, Standard 2, Full 3.
 ---
 ```
 

package/templates/_opencrew/core/runner.pipeline.md

@@ -85,16 +85,9 @@ Before starting execution:
         ```
    - Do not pause execution for this migration (the one-line notice above is enough).
 
-1c. **Project sources (`fontes:`)** — if `crew.yaml` has a `fontes:` list (files or folders of
-    the user's project, paths relative to the project root), read them now: a file in full up to
-    ~300 lines, otherwise its headings plus the passages relevant to this run's task; a folder as
-    its file list. Treat them as the **truth of the project**: when they disagree with the
-    briefing, the research or your own assumptions, the sources take precedence over them
-    (as fontes valem sobre o briefing e a pesquisa) — and say so when it matters.
-
-1d. **Source check** — before the first step, run:
+1c. **Source check** — before loading the project sources (1d), run:
     ```bash
-    node _opencrew/core/scripts/conferir-fontes.mjs --crew crews/{name}
+    node _opencrew/core/scripts/conferir-fontes.mjs --crew "crews/{name}"
     ```
     If the last line is `FONTES:PENDENTE` (a cited file was moved, renamed or deleted), show the
     report and ask — never continue silently with a missing source:
@@ -106,8 +99,19 @@ Before starting execution:
     2. Seguir assim mesmo
     3. Parar
     ```
-    On 1, run the same command with `--corrigir` and show the new result. Not-portable alerts
-    (absolute paths) are mentioned once, without stopping.
+    On 1, run the same command with `--corrigir`, show the new result and re-read `crew.yaml` and
+    any agent file already loaded (it may have changed them); 1d then loads the sources from the
+    corrected paths. If the new result still ends in `FONTES:PENDENTE`, ask again with options 2 and
+    3 only. Not-portable alerts (absolute paths) are mentioned once, without stopping. If the script
+    did not run (no Node, an error, or no `FONTES:` status line), tell the user "⚠️ A conferência de
+    fontes não rodou: {motivo}" and continue; the final approval repeats the warning.
+
+1d. **Project sources (`fontes:`)** — if `crew.yaml` has a `fontes:` list (files or folders of
+    the user's project, paths relative to the project root), read them now: a file in full up to
+    ~300 lines, otherwise its headings plus the passages relevant to this run's task; a folder as
+    its file list. Treat them as the **truth of the project**: when they disagree with the
+    briefing, the research or your own assumptions, the sources take precedence over them
+    (as fontes valem sobre o briefing e a pesquisa) — and say so when it matters.
 
 2. Read `crews/{name}/pipeline/pipeline.yaml` for the pipeline definition
 3. **Resolve skills**: Read `crew.yaml` → `skills` section. For each non-native skill (anything other than web_search, web_fetch):
@@ -349,6 +353,16 @@ Before executing any step that references an agent:
       - Faltou um dado real? Escreva [PREENCHER: o que falta] no lugar — o usuário completa
         na aprovação final. Um [PREENCHER] honesto vale mais que um exemplo inventado.
       ```
+   g. **Reviewer rules (always)** — for every step with `on_reject:`, inject at the same point:
+      ```
+      --- REGRAS DO REVISOR ---
+      - Copie os valores medidos do relatório; nunca estime contagens.
+      - Bloqueio no relatório é REJECT, seja qual for a nota — menos [PREENCHER], que o usuário
+        resolve na aprovação final.
+      - Alerta não resolvido nem justificado limita a nota a 7/10.
+      - O checklist só marca o que o relatório confirma; item "não medido" ou "não verificado" é
+        dito assim, nunca como aprovado.
+      ```
 
 ### Context Compression (Summary-Based Handoff)
 
@@ -564,7 +578,8 @@ Apply this transformation consistently for every write in this step.
   a fact, a format), write it to `crews/{name}/_memory/memories.md` in the matching section
   **before the next step** (antes do próximo passo) — not only at the end of the run, which may
   never come. A term the user asked to remove goes to `## Proibições Explícitas` **between
-  quotes** (entre aspas: `- Nunca usar "termo"`), so the automatic checker blocks it next time.
+  quotes** (entre aspas), in the canonical form — `- Nunca usar "termo"` or, with a replacement,
+  `- Nunca usar "termo" → usar "outro"` — so the automatic checker blocks it next time.
 - **Correction vs. company profile**: if the correction contradicts `_opencrew/_memory/company.md`
   (e.g. the organization's name, the main audience), ask: "Isso vale para todas as crews?
   Atualizo o perfil da empresa?" — change `company.md` only after a yes.
@@ -678,36 +693,48 @@ catching obvious issues early and reducing review cycle waste.
 When a step has `on_reject: {step-id}` (a review step):
 
 1. **Automatic check BEFORE the reviewer runs** — run the checker on **all outputs** (todas as
-   saídas) of every non-checkpoint step from the `on_reject` step up to the step right before
-   the review, using the transformed paths of this run (run_id/vN):
+   saídas) of every non-checkpoint step from the `on_reject` step up to the step right before the
+   review, using the transformed paths of this run (run_id/vN). Each item is `caminho=formato`, with
+   the `format:` of the step that generated that file; a step with no `format:`, with an export
+   format (`pdf`, `csv`, `formatted-post`) or with one outside `[a-z0-9-]+` goes without `=formato`:
    ```bash
-   node _opencrew/core/scripts/verificar.mjs --crew crews/{name} --arquivo "{path1},{path2},…" --formato {blog format id of those steps, if any}
+   node _opencrew/core/scripts/verificar.mjs --crew "crews/{name}" --arquivo "{path1}={format1},{path2},…"
    ```
    Save the full output to `crews/{name}/output/{run_id}/verificacao-ciclo-{N}.md` and inject it
    into the reviewer's context as `--- VERIFICAÇÃO AUTOMÁTICA ---`. The reviewer must copy the
-   measured values from it (see best-practices `review.md`). If the command itself fails (no
-   Node, unexpected error), tell the user "⚠️ A verificação automática não rodou: {motivo}" and
-   continue with the normal review.
+   measured values from it (see best-practices `review.md`). If the checker did not run (no Node,
+   an error, or no `VERIFICACAO:` status line), tell the user, continue with the normal review and
+   repeat it at the final approval: "⚠️ A verificação automática não rodou: {motivo}".
 2. **A block cannot be approved** — if the last line of the checker output is
    `VERIFICACAO:BLOQUEADA`, the verdict is **REJECT** regardless of the score (qualquer que seja a
    nota). Send the report (blocks first) to the writer together with the reviewer's feedback.
    If the last line is `VERIFICACAO:AGUARDANDO_USUARIO`, the only blocks are `[PREENCHER: …]`
    (real data only the user has): do NOT reject for them — the reviewer judges the rest, and the
    final approval below collects the missing data from the user.
-3. Track the review cycle count. If the reviewer rejects, go back to the referenced step.
-4. If max_review_cycles is reached with blocks remaining, present the report to the user:
+3. Track the review cycle count: a **cycle** is one pass of the reviewer. The maximum is
+   `max_review_cycles`, an integer from 1 declared where the step declares `on_reject` (the step
+   frontmatter or its `pipeline.yaml` entry); absent or invalid: 3. On every rejection, with or
+   without a block, send the reviewer's feedback to the writer and go back to the referenced step.
+4. If the last allowed pass also rejects, stop; the status of the last report picks the message, as
+   in item 2 — `VERIFICACAO:BLOQUEADA`: the blocks; any other status: the reviewer's feedback, also
+   with `VERIFICACAO:AGUARDANDO_USUARIO` (its only blocks are `[PREENCHER: …]`). Same three options:
    ```
-   ⚠️ A revisão ainda encontra bloqueios depois de {N} ciclos:
+   {if VERIFICACAO:BLOQUEADA} ⚠️ A revisão ainda encontra bloqueios depois de {N} ciclos:
    {lista de bloqueios do relatório}
+   {any other status} A revisão não aprovou o texto depois de {N} ciclos. Motivo: {parecer resumido}
 
    1. Corrigir eu mesmo (eu edito o texto e você verifica de novo)
-   2. Aceitar assim mesmo (fica registrado no histórico da execução)
+   2. Aceitar assim mesmo
    3. Abortar
    ```
 5. **Final approval checkpoint** (the checkpoint after the review): show the summary of the last
-   report — `Verificação automática: {N} bloqueios, {M} alertas` — plus the list of alerts. If the
-   approved text still contains `[PREENCHER: …]`, ask the user for each missing piece of real
-   information and write it into the text before approving.
+   report — `Verificação automática: {N} bloqueios, {M} alertas, {Z} não medidos` — plus the list
+   of alerts and the {Z} items not measured or not verified (the `Não medido` and `Não verificado`
+   lines under each file, not the "não é texto" line of **Notas**), one per line as
+   `{arquivo} — {motivo}`, then the lines under `**Notas:**` in that report, as they are written,
+   and repeat every "não rodou" warning of this run (checker and source check). If the approved
+   text still contains `[PREENCHER: …]`, ask the user for each missing piece of real information
+   and write it into the text before approving.
 
 ### Dashboard Handoff (between steps)
 
@@ -796,7 +823,8 @@ This archives the run state for the `runs` command while keeping crew history av
      - Writing style choices → `## Estilo de Escrita`
      - Visual/design preferences → `## Design Visual`
      - Content structure choices → `## Estrutura de Conteúdo`
-     - Explicit rejections or prohibitions → `## Proibições Explícitas`
+     - Explicit rejections or prohibitions → `## Proibições Explícitas`, in the canonical form
+       (`- Nunca usar "termo"` or `- Nunca usar "termo" → usar "outro"`)
      - Crew-specific technical patterns → `## Técnico (específico do crew)`
 
    **Never write to `memories.md`:**

package/templates/_opencrew/core/scripts/comum.mjs

@@ -0,0 +1,48 @@
+// Validações e mensagens de erro de uso comuns aos scripts do runtime (verificar,
+// conferir-fontes…). Node puro, sem dependências.
+// Spec: specs/fase-r1-reparos-1-6-1.md, regra 13 (repositório do OpenCrew).
+import { existsSync, realpathSync, statSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+export const MSG = {
+  faltaOpcao: (opcao) => `Falta a opção obrigatória ${opcao}.`,
+  semRaiz: 'Não encontrei `_opencrew/` nesta pasta. Rode o comando a partir da pasta do projeto.',
+  foraDoProjeto: (caminho) => `Caminho fora do projeto: ${caminho}`,
+  crewNaoEncontrada: (crew) => `Crew não encontrada: ${crew}`,
+};
+
+/** O caminho (relativo à raiz ou absoluto) fica dentro da raiz do projeto? */
+export function dentroDoProjeto(raiz, caminho) {
+  const rel = path.relative(raiz, path.resolve(raiz, caminho));
+  return !(rel === '..' || rel.startsWith(`..${path.sep}`) || path.isAbsolute(rel));
+}
+
+/**
+ * O script foi chamado direto (`node …/script.mjs`)? Compara os caminhos reais: com o projeto
+ * aberto por uma junção ou um link de pasta, o Node resolve o link em `import.meta.url` e não em
+ * `process.argv[1]`, e a comparação dos textos daria falso — o script sairia sem imprimir nada.
+ */
+export function ehPrincipal(metaUrl) {
+  try {
+    return Boolean(process.argv[1]) && realpathSync(process.argv[1]) === realpathSync(fileURLToPath(metaUrl));
+  } catch {
+    return false;
+  }
+}
+
+const ehPasta = (p) => existsSync(p) && statSync(p).isDirectory();
+
+/**
+ * Erro de uso, na ordem da regra 13: opção obrigatória faltando → pasta atual sem `_opencrew/`
+ * → crew ou caminho fora do projeto (antes de testar se existe) → crew inexistente.
+ * @returns {string|null} a mensagem em PT-BR, ou null quando está tudo certo
+ */
+export function erroDeUso({ raiz, faltando = [], crew, caminhos = [] }) {
+  if (faltando.length) return MSG.faltaOpcao(faltando[0]);
+  if (!ehPasta(path.join(raiz, '_opencrew'))) return MSG.semRaiz;
+  const fora = [crew, ...caminhos].find((c) => !dentroDoProjeto(raiz, c));
+  if (fora) return MSG.foraDoProjeto(fora);
+  if (!ehPasta(path.resolve(raiz, crew))) return MSG.crewNaoEncontrada(crew);
+  return null;
+}

package/templates/_opencrew/core/scripts/conferir-fontes/busca.mjs

@@ -0,0 +1,82 @@
+// Busca da conferência de fontes: onde está cada caminho citado (crew → raiz do projeto →
+// absoluto → ao lado do agente ou da task que cita) e, quando ele sumiu, o que existe no projeto
+// com o mesmo nome. Só testa existência e lista nomes; nunca lê conteúdo.
+// Spec: specs/fase-r1-reparos-1-6-1.md, regra 17 (repositório do OpenCrew).
+import { readdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+
+export const LIMITE_DA_BUSCA = 20000;
+const IGNORAR = new Set(['node_modules', 'output', '_opencrew', '_build']);
+
+export const barra = (p) => p.split(path.sep).join('/');
+export const ehAbsoluto = (p) => /^[A-Za-z]:[\\/]/.test(p) || p.startsWith('/');
+export const temBarraFinal = (ref) => /[\\/]$/.test(ref);
+const semBarraFinal = (ref) => ref.replace(/[\\/]+$/, '');
+
+const SUFIXO_DE_AGENTE = '.agent.md';
+
+/**
+ * Pastas ao lado de quem cita, só para arquivo de agente ou de task (dentro de `agents/`): a do
+ * próprio arquivo e, para `agents/X.agent.md`, também `agents/X/` — é lá que fica a task que o
+ * frontmatter do agente escreve como `tasks/x.md`.
+ */
+function pastasDeQuemCita(raiz, crew, citadoEm) {
+  const agentes = path.resolve(raiz, crew, 'agents') + path.sep;
+  return citadoEm.filter((arquivo) => arquivo.startsWith(agentes)).flatMap((arquivo) => {
+    const pasta = path.dirname(arquivo);
+    const nome = path.basename(arquivo);
+    return nome.endsWith(SUFIXO_DE_AGENTE) ? [pasta, path.join(pasta, nome.slice(0, -SUFIXO_DE_AGENTE.length))] : [pasta];
+  });
+}
+
+/**
+ * Caminho real do que foi citado, ou null quando não existe. Ordem: pasta da crew → raiz do
+ * projeto → absoluto → pastas ao lado dos arquivos de agente ou de task que citam (`citadoEm`).
+ */
+export function resolver(raiz, crew, ref, citadoEm = []) {
+  if (ehAbsoluto(ref)) return existsSync(ref) ? path.resolve(ref) : null;
+  for (const base of [path.resolve(raiz, crew), raiz, ...pastasDeQuemCita(raiz, crew, citadoEm)]) {
+    const p = path.resolve(base, ref);
+    if (existsSync(p)) return p;
+  }
+  return null;
+}
+
+/**
+ * Índice nome → caminhos relativos à raiz (pasta termina em `/`), sem saídas, dependências e
+ * pastas ocultas. Para ao passar de `limite` itens: aí `parcial` é true.
+ */
+export async function indexar(raiz, limite) {
+  const porNome = new Map();
+  let vistos = 0;
+  let parcial = false;
+  async function percorrer(dir) {
+    let entradas;
+    try { entradas = await readdir(dir, { withFileTypes: true }); } catch { return; }
+    for (const e of entradas) {
+      if (++vistos > limite) { parcial = true; return; }
+      if (e.name.startsWith('.') || (e.isDirectory() && IGNORAR.has(e.name))) continue;
+      const abs = path.join(dir, e.name);
+      const chave = e.name.toLowerCase();
+      if (!porNome.has(chave)) porNome.set(chave, []);
+      porNome.get(chave).push(barra(path.relative(raiz, abs)) + (e.isDirectory() ? '/' : ''));
+      if (e.isDirectory()) await percorrer(abs);
+    }
+  }
+  await percorrer(raiz);
+  return { porNome, parcial };
+}
+
+/** Candidatos com o mesmo nome. Citado com barra final só casa com pasta; sem ela, com os dois. */
+export function candidatosPorNome(indice, ref) {
+  const todos = indice.porNome.get(path.basename(semBarraFinal(ref)).toLowerCase()) ?? [];
+  return temBarraFinal(ref) ? todos.filter((c) => c.endsWith('/')) : todos;
+}
+
+/** Nomes do que existe na pasta em que o caminho deveria estar. */
+export async function nomesDaPastaEsperada(raiz, crew, ref) {
+  const pai = resolver(raiz, crew, path.dirname(semBarraFinal(ref)));
+  if (!pai) return [];
+  try { return (await readdir(pai)).filter((f) => !f.startsWith('.')); } catch { return []; }
+}