@aksp/opencrew 1.4.2 → 1.6.0

package/templates/_opencrew/core/scripts/verificar/regras.mjs

@@ -0,0 +1,127 @@
+// Regras do verificador automático (specs/fase-u1-revisor-com-dentes.md §5).
+// Máximos bloqueiam (fácil de corrigir: encurtar); mínimos alertam (podem depender do usuário).
+import { lerFrontmatter, semFrontmatter, semAcento } from './leitura.mjs';
+
+const segmentador = new Intl.Segmenter('pt', { granularity: 'grapheme' });
+
+/** Bloqueio que só o usuário resolve ([PREENCHER: …]). */
+export const FALTA_INFO = 'Falta informação sua';
+
+/** Caracteres visíveis: sem marcadores de negrito/itálico; emoji conta 1. */
+export function contar(texto) {
+  const limpo = String(texto).replace(/\*\*|__/g, '').replace(/\*([^*\n]+)\*/g, '$1').trim();
+  return [...segmentador.segment(limpo)].length;
+}
+
+const contarHashtags = (texto) => (texto.match(/#[\p{L}\p{N}_]+/gu) ?? []).length;
+
+const item = (nome, medido, limite, nivel, detalhe = '') => ({ item: nome, medido, limite, nivel, detalhe });
+
+function maximo(nome, medido, limite) {
+  if (typeof limite !== 'number') return null;
+  return item(nome, medido, limite, medido > limite ? 'bloqueio' : 'ok');
+}
+
+function minimo(nome, medido, limite) {
+  if (typeof limite !== 'number') return null;
+  return item(nome, medido, limite, medido < limite ? 'alerta' : 'ok');
+}
+
+const NAO_CONTA = /^(mailto:|tel:|https?:\/\/(wa\.me|api\.whatsapp\.com)\/)/i;
+
+function contarLinks(corpo, dominio) {
+  const urls = [...corpo.matchAll(/\[[^\]]*\]\(([^)\s]+)[^)]*\)/g)].map((m) => m[1]).filter((u) => !NAO_CONTA.test(u));
+  const interno = (u) => !/^https?:\/\//i.test(u) || (dominio && new URL(u).hostname.replace(/^www\./, '') === dominio);
+  return { internos: urls.filter(interno).length, externos: urls.filter((u) => !interno(u)).length };
+}
+
+/** Blog: frontmatter com título → título, meta description e links. */
+export function regrasBlog(texto, limites, dominio) {
+  const fm = lerFrontmatter(texto);
+  const titulo = fm?.title ?? fm?.titulo;
+  if (titulo == null || !limites) return [];
+  const meta = fm.meta_description ?? fm.meta_descricao;
+  const { internos, externos } = contarLinks(semFrontmatter(texto), dominio);
+  return [
+    maximo('Título (SEO) — caracteres', contar(titulo), limites.title_max_chars),
+    meta != null ? maximo('Meta description — caracteres', contar(meta), limites.meta_description_chars) : null,
+    minimo('Links internos', internos, limites.min_internal_links),
+    minimo('Links externos', externos, limites.min_external_links),
+  ].filter(Boolean);
+}
+
+/** Seções por canal (cabeçalhos "Legenda Instagram", "Post LinkedIn", "Tweet"…). */
+export function regrasCanais(secoes, limitesPorFormato) {
+  const itens = [];
+  for (const s of secoes) {
+    const t = semAcento(s.titulo);
+    const ig = limitesPorFormato['instagram-feed'];
+    if (/instagram/.test(t) && /legenda|caption/.test(t) && ig) {
+      itens.push(maximo('Legenda Instagram — caracteres', contar(s.corpo), ig.caption_max_chars));
+      itens.push(maximo('Legenda Instagram — hashtags', contarHashtags(s.corpo), ig.hashtags_max));
+    } else if (/instagram/.test(t) && /carrossel|carousel/.test(t) && ig) {
+      const slides = (s.corpo.match(/^\s*(?:#{3,6}\s*|\*\*\s*)slide\s*\d+/gim) ?? []).length;
+      if (slides) itens.push(maximo('Carrossel Instagram — slides', slides, ig.carousel_max_slides));
+    }
+    const li = limitesPorFormato['linkedin-post'];
+    if (/linkedin/.test(t) && !/carrossel|carousel/.test(t) && li) {
+      itens.push(maximo('Post LinkedIn — caracteres', contar(s.corpo), li.post_max_chars));
+      itens.push(maximo('Post LinkedIn — hashtags', contarHashtags(s.corpo), li.hashtags_max));
+    }
+    const tw = limitesPorFormato['twitter-post'];
+    if (/tweet|twitter/.test(t) && tw) {
+      s.corpo.split(/\n\s*\n/).filter((p) => p.trim()).forEach((p, i) => {
+        const r = maximo(`Tweet ${i + 1} — caracteres`, contar(p), tw.tweet_max_chars);
+        if (r?.nivel === 'bloqueio') itens.push(r);
+      });
+    }
+  }
+  return itens.filter(Boolean);
+}
+
+const PLACEHOLDERS = [
+  /(?:https?:\/\/)?[^\s()[\]<>"']*?(\d)\1{5,}[^\s()[\]<>"']*/g, // 6+ dígitos repetidos (wa.me/5584999999999)
+  /\[(?:empresa|cliente|nome|feira|evento|produto|cidade|link|url|telefone|e-?mail|data)\b[^\]]*\](?!\()/giu,
+  /lorem ipsum/gi,
+  /\bX{3,}\b/g,
+  /\{\{[^}]+\}\}/g,
+  /\b(?:example\.com|seusite\.com(?:\.br)?|suaempresa\.com(?:\.br)?)\b/gi,
+];
+
+const PRIMEIRA_PESSOA = /(?<!\p{L})(eu|nós|nosso|nossa|nossos|nossas|investimos|atendemos|fizemos|ajudamos|fundamos|começamos|criamos|entregamos|nossa equipe)(?!\p{L})/iu;
+const DADO_CONCRETO = /R\$\s?\d|US\$\s?\d|\d+([.,]\d+)?\s?%|\d+\s+(clientes|empresas|eventos|anos|projetos|pessoas)/iu;
+
+// Ano só conta como dado concreto se for passado: "Congresso 2026" (ano atual/futuro) é nome de
+// evento, não afirmação sobre a história da empresa (achado no uso real).
+function temDadoConcreto(frase) {
+  if (DADO_CONCRETO.test(frase)) return true;
+  const atual = new Date().getFullYear();
+  return [...frase.matchAll(/(?<!\d)((?:19|20)\d{2})(?!\d)/g)].some((m) => Number(m[1]) < atual);
+}
+
+const citar = (frase) => {
+  const limpa = frase.replace(/\*\*|__/g, '').replace(/\*([^*\n]+)\*/g, '$1').trim();
+  return limpa.length > 160 ? `${limpa.slice(0, 160).trimEnd()}…` : limpa;
+};
+
+/** Checagens que valem para qualquer texto. */
+export function regrasGerais(texto, proibidos) {
+  const corpo = semFrontmatter(texto);
+  const itens = [];
+  for (const rx of PLACEHOLDERS) {
+    for (const m of texto.matchAll(rx)) itens.push(item('Placeholder', null, null, 'bloqueio', m[0].replace(/[.,;:!?]+$/, '')));
+  }
+  for (const m of texto.matchAll(/\[PREENCHER:?\s*([^\]]*)\]/giu)) {
+    itens.push(item(FALTA_INFO, null, null, 'bloqueio', m[1].trim() || m[0]));
+  }
+  const normal = semAcento(texto);
+  for (const termo of proibidos) {
+    if (normal.includes(semAcento(termo))) itens.push(item('Termo proibido (memória da crew)', null, null, 'bloqueio', termo));
+  }
+  for (const frase of corpo.split(/(?<=[.!?])\s+|\n+/)) {
+    if (PRIMEIRA_PESSOA.test(frase) && temDadoConcreto(frase)) {
+      itens.push(item('Afirmação a confirmar', null, null, 'alerta', citar(frase)));
+    }
+  }
+  return itens;
+}

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

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+// Verificador automático do OpenCrew — mede o texto ANTES do revisor.
+// Uso: node _opencrew/core/scripts/verificar.mjs --crew crews/<nome> --arquivo <a.md>[,<b.md>] [--formato blog-post|blog-seo]
+// Os limites vêm do frontmatter `constraints:` dos best-practices (fonte única).
+// Última linha da saída: VERIFICACAO:OK ou VERIFICACAO:BLOQUEADA (o runner lê esta linha).
+// Spec: specs/fase-u1-revisor-com-dentes.md (repositório do OpenCrew).
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { lerLimites, lerSecoes, lerProibicoes, lerDominioDoSite } from './verificar/leitura.mjs';
+import { regrasBlog, regrasCanais, regrasGerais, FALTA_INFO } from './verificar/regras.mjs';
+
+const FORMATOS_DE_CANAL = ['instagram-feed', 'linkedin-post', 'twitter-post'];
+
+export async function verificar({ raiz, crew, arquivos, formato = 'blog-post' }) {
+  const notas = [];
+  const limites = {};
+  for (const id of [formato, ...FORMATOS_DE_CANAL]) {
+    limites[id] = await lerLimites(raiz, id);
+    if (!limites[id]) notas.push(`Formato "${id}" não encontrado em _opencrew/core/best-practices/ — sem limites para ele.`);
+  }
+  const proibicoes = await lerProibicoes(raiz, crew);
+  if (!proibicoes.existe) notas.push('Sem proibições registradas (a crew não tem memories.md).');
+  if (proibicoes.semAspas) {
+    const n = proibicoes.semAspas;
+    notas.push(`${n} ${n === 1 ? 'proibição' : 'proibições'} sem termo entre aspas ${n === 1 ? 'não é verificada' : 'não são verificadas'} automaticamente — escreva o termo entre aspas na memória para virar trava.`);
+  }
+  const dominio = await lerDominioDoSite(raiz);
+
+  const resultado = [];
+  for (const rel of arquivos) {
+    const texto = await readFile(path.join(raiz, rel), 'utf8');
+    const itens = [
+      ...regrasBlog(texto, limites[formato], dominio),
+      ...regrasCanais(lerSecoes(texto), limites),
+      ...regrasGerais(texto, proibicoes.termos),
+    ];
+    resultado.push({ arquivo: rel, itens });
+  }
+  const todos = resultado.flatMap((a) => a.itens);
+  const bloqueios = todos.filter((i) => i.nivel === 'bloqueio');
+  const alertas = todos.filter((i) => i.nivel === 'alerta').length;
+  // [PREENCHER] só o usuário resolve: não força REJECT (o redator não tem o dado), mas a
+  // aprovação final não fecha sem ele.
+  const reais = bloqueios.filter((i) => i.item !== FALTA_INFO).length;
+  const status = reais ? 'BLOQUEADA' : bloqueios.length ? 'AGUARDANDO_USUARIO' : 'OK';
+  return { arquivos: resultado, notas, bloqueios: bloqueios.length, alertas, status };
+}
+
+const ROTULO = { bloqueio: '❌ Bloqueio', alerta: '⚠️ Alerta', ok: '✅ OK' };
+const plural = (n, um, varios) => `${n} ${n === 1 ? um : varios}`;
+
+export function formatarRelatorio(r) {
+  const linhas = ['## Verificação automática', ''];
+  for (const a of r.arquivos) {
+    linhas.push(`### ${a.arquivo}`, '');
+    const medidos = a.itens.filter((i) => i.medido != null);
+    if (medidos.length) {
+      linhas.push('| Item | Medido | Limite | Resultado |', '|---|---|---|---|');
+      for (const i of medidos) {
+        const op = i.nivel === 'alerta' || /links/i.test(i.item) ? '≥' : '≤';
+        linhas.push(`| ${i.item} | ${i.medido} | ${op} ${i.limite} | ${ROTULO[i.nivel]} |`);
+      }
+      linhas.push('');
+    }
+    for (const i of a.itens.filter((x) => x.medido == null)) {
+      linhas.push(`- ${ROTULO[i.nivel]} — ${i.item}: "${i.detalhe}"`);
+    }
+    if (!a.itens.length) linhas.push('- ✅ Nada a apontar.');
+    linhas.push('');
+  }
+  if (r.notas.length) linhas.push('**Notas:**', ...r.notas.map((n) => `- ${n}`), '');
+  linhas.push(`**Resumo: ${plural(r.bloqueios, 'bloqueio', 'bloqueios')}, ${plural(r.alertas, 'alerta', 'alertas')}**`, '');
+  linhas.push(`VERIFICACAO:${r.status}`);
+  return linhas.join('\n');
+}
+
+function lerArgs(argv) {
+  const args = {};
+  for (let i = 0; i < argv.length; i++) {
+    const m = argv[i].match(/^--(crew|arquivo|formato)$/);
+    if (m && i + 1 < argv.length) args[m[1]] = argv[++i];
+  }
+  return args;
+}
+
+const USO = 'Uso: node _opencrew/core/scripts/verificar.mjs --crew crews/<nome> --arquivo <a.md>[,<b.md>] [--formato blog-post|blog-seo]';
+
+/** @returns {Promise<number>} 0 = verificou (OK ou BLOQUEADA) · 1 = erro de uso */
+export async function main(argv, { cwd = process.cwd(), escrever = (s) => process.stdout.write(`${s}\n`) } = {}) {
+  const args = lerArgs(argv);
+  if (!args.crew || !args.arquivo) {
+    escrever(USO);
+    return 1;
+  }
+  const arquivos = args.arquivo.split(',').map((s) => s.trim()).filter(Boolean);
+  for (const rel of [args.crew, ...arquivos]) {
+    const abs = path.resolve(cwd, rel);
+    if (path.relative(cwd, abs).startsWith('..') || path.isAbsolute(path.relative(cwd, abs))) {
+      escrever(`Caminho fora do projeto: ${rel}`);
+      return 1;
+    }
+  }
+  const faltando = arquivos.find((rel) => !existsSync(path.join(cwd, rel)));
+  if (faltando) {
+    escrever(`Arquivo não encontrado: ${faltando}`);
+    return 1;
+  }
+  const r = await verificar({ raiz: cwd, crew: args.crew, arquivos, formato: args.formato || 'blog-post' });
+  escrever(formatarRelatorio(r));
+  return 0;
+}
+
+const isMain = process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href;
+if (isMain) {
+  main(process.argv.slice(2)).then((code) => { process.exitCode = code; });
+}

package/templates/skills/image-ai-generator/SKILL.md

@@ -100,7 +100,7 @@ Each item can optionally include a `"reference": "path/to/ref.png"` field.
 ### Prompt guidelines
 
 - Be specific about composition, lighting, style, and mood
-- Specify aspect ratio or orientation when relevant (e.g., "portrait 3:4", "landscape 16:9")
+- Specify aspect ratio or orientation when relevant (e.g., "portrait 4:5", "landscape 16:9")
 - Include "hyper realistic, 4K quality" for photographic styles
 - Include "clean composition" to avoid cluttered outputs
 - Avoid requesting text in images — AI models struggle with text rendering

package/templates/skills/image-creator/SKILL.md

@@ -60,7 +60,7 @@ Use the Visual Renderer when you need to generate production-ready images from H
 
 Use these standard dimensions:
 - Instagram Post: 1080 x 1080
-- Instagram Carousel: 1080 x 1440
+- Instagram Carousel: 1080 x 1350
 - Instagram Story/Reel: 1080 x 1920
 - Facebook Post: 1200 x 630
 - Twitter/X Post: 1200 x 675
@@ -86,7 +86,7 @@ Example minimal structure:
   <meta charset="UTF-8">
   <style>
     * { margin: 0; padding: 0; box-sizing: border-box; }
-    body { width: 1080px; height: 1440px; overflow: hidden; }
+    body { width: 1080px; height: 1350px; overflow: hidden; }
     /* ... your design ... */
   </style>
 </head>

package/templates/skills/image-fetcher/SKILL.md

@@ -47,7 +47,7 @@ When taking a screenshot:
 1. Navigate to the URL with `browser_navigate`
 2. Set viewport: `browser_resize` with width/height for target format
    - Instagram post: 1080x1080
-   - Instagram carousel: 1080x1440
+   - Instagram carousel: 1080x1350
    - Story/Reel: 1080x1920
    - Generic: 1280x720
 3. Wait for page load (`browser_wait_for` if needed)

package/templates/skills/opencrew-best-practice-creator/SKILL.md

@@ -15,7 +15,7 @@ version: "2.0.0"
 
 # Best-Practice Creator — Workflow
 
-Use this workflow when creating a new best-practice file for the `_opencrew/core/best-practices/` library.
+Use this workflow when creating a new best-practice file. New and customized best-practices live in `_opencrew/best-practices.local/` — the user's own library, read before `_opencrew/core/best-practices/` and never touched by `npx @aksp/opencrew update` (the core folder is replaced on every update).
 
 ## Pre-flight Checks
 
@@ -67,7 +67,7 @@ For each existing best-practice file whose scope overlaps with the new one:
 
 ### 2. Update `_catalog.yaml`
 
-Add a new entry to `_opencrew/core/best-practices/_catalog.yaml` with:
+Add a new entry to `_opencrew/best-practices.local/_catalog.yaml` (create it if missing) with:
 - `id`: matching the frontmatter `id`
 - `name`: matching the frontmatter `name`
 - `whenToUse`: single-line summary of the scope (positive only, no "NOT for")
@@ -77,7 +77,7 @@ Place it under the appropriate section comment (Discipline or Platform best prac
 
 ### 3. File placement
 
-Save to `_opencrew/core/best-practices/{id}.md`.
+Save to `_opencrew/best-practices.local/{id}.md`.
 
 ### 4. Validation
 
@@ -93,7 +93,7 @@ Re-read the created file and verify:
 
 # Best-Practice Updater — Workflow
 
-Use this workflow when updating best-practice files in the `_opencrew/core/best-practices/` library.
+Use this workflow when updating best-practice files. To change a core best-practice, first copy it from `_opencrew/core/best-practices/` to `_opencrew/best-practices.local/` and edit the copy there (the local copy overrides the core one and survives updates).
 
 ## Versioning Rules (Semver)
 

package/templates/skills/template-designer/SKILL.md

@@ -46,7 +46,7 @@ Before generating any template, read and internalize the design best practices:
 - `_opencrew/core/best-practices/image-design.md` — **REQUIRED reading**. Contains platform-specific minimum font sizes, typography rules, spacing guidelines, color palette constraints, contrast requirements, and layout methodology. Every template you generate MUST comply with these rules.
 
 Key rules to always follow:
-- **Font sizes**: Hero 58px, Heading 43px, Body 34px, Caption 24px minimum for Instagram carousel (1080x1440). Absolute minimum 20px for any readable text on any platform.
+- **Font sizes**: Hero 58px, Heading 43px, Body 34px, Caption 24px minimum for Instagram carousel (1080x1350). Absolute minimum 20px for any readable text on any platform.
 - **Font weight**: 500 or higher for body text and above.
 - **Colors**: Maximum 5 colors per design system (primary, secondary, accent, background, text).
 - **Contrast**: WCAG AA minimum 4.5:1 for all text against background.
@@ -61,7 +61,7 @@ You should also apply general web design best practices: proper white space, vis
 These rules are NON-NEGOTIABLE. Every template must comply:
 
 **Fixed Dimensions (never use height: auto or flexible height):**
-- Instagram Carousel: `width: 1080px; height: 1440px` (3:4 portrait)
+- Instagram Carousel: `width: 1080px; height: 1350px` (4:5 portrait)
 - Instagram Story/Reel: `width: 1080px; height: 1920px` (9:16 portrait)
 - Instagram Post: `width: 1080px; height: 1080px` (1:1 square)
 - LinkedIn Post: `width: 1200px; height: 627px` (1.91:1 horizontal)
@@ -155,7 +155,7 @@ When the user approves, create two files:
 
 Save to: `crews/{code}/pipeline/data/template-reference.html`
 
-The complete, self-contained HTML/CSS of the approved template at full resolution (e.g., 1080x1440). This is the literal example the design agent will use.
+The complete, self-contained HTML/CSS of the approved template at full resolution (e.g., 1080x1350). This is the literal example the design agent will use.
 
 ### 2. Visual Identity Rules
 

package/templates/skills/template-designer/base-templates/model-a.html

@@ -2,7 +2,7 @@
 <!-- Style: Black background, tweet-style layout with avatar, verified badge, editorial text, contextual image -->
 <!-- Fonts: Inter (body), weight 400-700 -->
 <!-- Colors: #000 bg, #fff text, #1D9BF0 verified, #71767B muted, #2a2a2a borders/avatar, #1a1a2e image gradient -->
-<div style="width:1080px;height:1440px;background:#000;color:#fff;font-family:'Inter',sans-serif;display:flex;flex-direction:column;padding:72px;gap:0;position:relative;overflow:hidden;">
+<div style="width:1080px;height:1350px;background:#000;color:#fff;font-family:'Inter',sans-serif;display:flex;flex-direction:column;padding:72px;gap:0;position:relative;overflow:hidden;">
   <!-- Tweet header -->
   <div style="display:flex;gap:24px;align-items:center;">
     <div style="width:80px;height:80px;border-radius:50%;background:#2a2a2a;flex-shrink:0;"></div>

package/templates/skills/template-designer/base-templates/model-b.html

@@ -2,7 +2,7 @@
 <!-- Style: Warm cream background, bold uppercase title, numbered cards with warm gradient progression -->
 <!-- Fonts: Montserrat 900 (title), Inter 500-700 (body) -->
 <!-- Colors: #FDF6EE bg, #E85D2A primary orange, #D4742A/#C05A1A/#A04010 gradient steps, #FFF5E6-#D07030 card backgrounds -->
-<div style="width:1080px;height:1440px;background:#FDF6EE;color:#111;font-family:'Inter',sans-serif;display:flex;flex-direction:column;padding:72px;justify-content:center;gap:48px;position:relative;overflow:hidden;">
+<div style="width:1080px;height:1350px;background:#FDF6EE;color:#111;font-family:'Inter',sans-serif;display:flex;flex-direction:column;padding:72px;justify-content:center;gap:48px;position:relative;overflow:hidden;">
   <!-- Title -->
   <div style="text-align:center;">
     <h1 style="font-size:58px;font-weight:900;line-height:1.15;margin:0;text-transform:uppercase;font-family:'Montserrat',sans-serif;">

package/templates/skills/template-designer/base-templates/model-c.html

@@ -2,7 +2,7 @@
 <!-- Style: Purple-dark gradient, data metric cards, decorative glow effects -->
 <!-- Fonts: Montserrat 900 (title, metrics), Inter 500 (body, labels) -->
 <!-- Colors: gradient #0f0326-#1a0a3e-#0d0d0d bg, #F59E0B yellow, #EC4899 pink, #7C3AED purple, #4ADE80 green accents -->
-<div style="width:1080px;height:1440px;background:linear-gradient(160deg,#0f0326,#1a0a3e 40%,#0d0d0d);color:#fff;font-family:'Inter',sans-serif;display:flex;flex-direction:column;padding:72px;position:relative;overflow:hidden;">
+<div style="width:1080px;height:1350px;background:linear-gradient(160deg,#0f0326,#1a0a3e 40%,#0d0d0d);color:#fff;font-family:'Inter',sans-serif;display:flex;flex-direction:column;padding:72px;position:relative;overflow:hidden;">
   <!-- Glow effects -->
   <div style="position:absolute;top:-120px;right:-120px;width:480px;height:480px;background:radial-gradient(circle,#7C3AED33,transparent 70%);pointer-events:none;"></div>
   <div style="position:absolute;bottom:-100px;left:-100px;width:400px;height:400px;background:radial-gradient(circle,#F59E0B22,transparent 70%);pointer-events:none;"></div>