raptor-aios 0.8.2 → 0.9.0

package/CHANGELOG.md

@@ -3,6 +3,24 @@
 All notable changes to this project will be documented in this file.
 Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.9.0] - 2026-06-11
+
+### Added
+
+- **Preset `gol-smiles` (G1–G6), empilhável sobre `mobile-opinionated`.** Novo preset bundled (`packages/core/src/presets/gol-smiles.ts` + `gol-smiles-gates.ts`) focado no ecossistema Gol/Smiles (RN + Design System Tangerina, arquitetura `modernization/`): **G1** Tangerina-first UI (vocabulário fechado de componentes/receitas), **G2** arquitetura moderna (Zustand + RHF/Zod), **G3** i18n pt-BR/en/es, **G4** contrato de analytics, **G5** rollout por feature flag, **G6** paridade multi-marca — todos com opt-out honesto. Registrado no `REGISTRY` com aliases `gol`/`smiles`. `init --preset mobile-opinionated,gol-smiles` empilha os 12 artigos e 12 gates; `raptor preset add gol-smiles` ativa num projeto existente.
+- **Render multi-preset na constituição (D-10).** `raptor init --preset a,b` aceita um stack comma-separated e renderiza os artigos de **todos** os presets (`renderPresetsArticles`, atribuição de fonte por preset), gravando `presets:` no `raptor.yml`; `raptor preset add` **anexa** os artigos do novo preset à constituição (append seguro e idempotente, sem sobrescrever artigos do projeto).
+- **Knowledge pack via extensão de preset (D-3).** O schema `raptor.extension/v1` ganhou `provides.knowledge[]` e `requires.preset`; o scaffold instala extensões **condicionalmente ao preset ativo** (`installBundledExtensions`/`collectFrameworkFiles` filtram; `collectKnowledgeRefs` alimenta o bloco de contexto). `buildContextBlock` ganhou a seção "Knowledge packs". A extensão `extensions/gol-smiles/` traz 5 catálogos (Tangerina, kit interno com classificação A/B/C/D, receitas de composição, tokens, 19 regras de conformidade) + o dicionário Figma→Tangerina, referenciados no `CLAUDE.md`/`AGENTS.md`.
+- **Frontmatter ciente do preset (D-2).** `spec.md.hbs`/`plan.md.hbs` emitem os blocos G* (`ui`/`i18n`/`analytics`/`brands` na spec; `architecture`/`rollout` no plan) **somente** quando `gol-smiles` está ativo — projetos non-gol ficam intactos. Mirrors de doc sincronizados.
+- **Verificadores `raptor verify tangerina | i18n | arch` (Fase 3).** Runners reais que medem o código (`packages/core/src/verify/`): tokens literais/lista negra do kit/receita-base e receitas declaradas (tangerina, com modo `--design`), paridade de chaves pt-BR/en/es (i18n), imports banidos e aliases (arch). Achados carregam `regra`/`receita#asserção` + `arquivo:linha` + severidade (`error` bloqueia; `warning` só com `--strict`).
+- **Modo deep gate→verify (D-7), opt-in.** Com `gol_smiles.deep_verify: true` no `raptor.yml`, os gates G1/G2/G3 também executam os runners na avaliação e agregam o resultado em `details` (erro determinístico no código reprova o gate). Sem o opt-in, os gates seguem puramente declarativos (padrão dos gates mobile).
+
+## [0.8.3] - 2026-06-10
+
+### Documentation
+
+- **Glossário Canônico (`docs/glossary.md`) reescrito e certificado contra o código.** Passou de ~16 termos para ~60 conceitos cobrindo todo o ecossistema (Gate, GateLevel, ADR, Override, Canonical, Blueprint, Priority Stack, Preset, Extension, Hook, Skill, MCP, Harness, SDD, Stage, Workflow, Traceability/Coverage/Trace, Staleness, Readiness, M1–M6/M7/M8, C1–C5, D#, artefatos e memória), cada um no modelo Nome/Objetivo/Definição/Responsabilidades/Quando usar/Quando não usar/Relação/Prioridade/Exemplos/Anti-padrões. Inclui apêndices com as hierarquias de governança/decisão/documentos/execução/contexto, a distinção C/D/M, o catálogo dos 42 gates (nível + artigo) e o catálogo de comandos CLI. Cada entrada cita `arquivo:linha`.
+- **README atualizado para refletir o código atual.** Nova seção "Documentação & glossário" (com link em destaque para o glossário, tabela dos docs e diagrama mermaid da hierarquia de governança) e entrada no índice. Correções confrontadas com `packages/core`/`packages/cli`: contagem de testes (1019 = 784 core + 201 cli + 34 e2e), workflows bundled (`sdd-cycle`, `sdd-cycle-quick`), hooks (34 pontos = before/after de 17 comandos), tabelas "Capacidades" e "Referência CLI" com markdown corrigido, badge de versão, e menção ao preset `lean`.
+
 ## [0.8.2] - 2026-06-10
 
 ### Fixed

package/README.md

@@ -8,7 +8,7 @@
 [![node](https://img.shields.io/badge/node-%E2%89%A5%2020-3c873a?logo=node.js&logoColor=white)](https://nodejs.org)
 [![platform](https://img.shields.io/badge/target-React%20Native-61dafb?logo=react&logoColor=black)](https://reactnative.dev)
 [![tests](https://img.shields.io/badge/tests-1019%20passing-22c55e)](#️-desenvolvimento-local)
-[![version](https://img.shields.io/badge/version-0.8.1-ef4444)](CHANGELOG.md)
+[![version](https://img.shields.io/badge/version-0.8.3-ef4444)](CHANGELOG.md)
 [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 
 </div>
@@ -360,14 +360,14 @@ Gates são checagens versionadas com um **nível**: 🔴 `critical` (bloqueia, i
 
 Cada gate exige campos no *frontmatter* de `spec.md` ou `plan.md` — declarativos, verificáveis e (para alguns) **mensuráveis** via `verify`.
 
-|                     Gate                      | Nível |                     Exige no frontmatter                     |  Verificável por   |
-| --------------------------------------------- | ----- | ------------------------------------------------------------ | ------------------ |
+|                     Gate                      | Nível |                                                 Exige no frontmatter                                                  |  Verificável por   |
+| --------------------------------------------- | ----- | --------------------------------------------------------------------------------------------------------------------- | ------------------ |
 | **M1 — App/Play Store Compliance**            | 🟡     | `spec.stores.ios_permissions`, `.android_permissions` (ou `stores.no_restricted_apis: "<motivo>"` p/ opt-out honesto) | `verify stores`    |
-| **M2 — Privacidade & Residência (LGPD/GDPR)** | 🟡     | `plan.privacy.lawful_basis`, `.residency`, `.retention`      | —                  |
-| **M3 — Acessibilidade (WCAG AA)**             | 🟡     | `spec.a11y.wcag_level`, `.criteria`                          | `verify a11y`      |
-| **M4 — Matriz de SO**                         | 🟡     | `plan.os_matrix.ios_min`, `.android_min`                     | `verify os-matrix` |
-| **M5 — Orçamento de Performance**             | 🟡     | `plan.perf_budget.ttfi_ms`, `.interactions_ms`               | `verify perf`      |
-| **M6 — Crash-Free SLO & Observabilidade**     | 🔵     | `plan.crash_free_slo` (≥99.5), `plan.observability.provider` | —                  |
+| **M2 — Privacidade & Residência (LGPD/GDPR)** | 🟡     | `plan.privacy.lawful_basis`, `.residency`, `.retention`                                                               | —                  |
+| **M3 — Acessibilidade (WCAG AA)**             | 🟡     | `spec.a11y.wcag_level`, `.criteria`                                                                                   | `verify a11y`      |
+| **M4 — Matriz de SO**                         | 🟡     | `plan.os_matrix.ios_min`, `.android_min`                                                                              | `verify os-matrix` |
+| **M5 — Orçamento de Performance**             | 🟡     | `plan.perf_budget.ttfi_ms`, `.interactions_ms`                                                                        | `verify perf`      |
+| **M6 — Crash-Free SLO & Observabilidade**     | 🔵     | `plan.crash_free_slo` (≥99.5), `plan.observability.provider`                                                          | —                  |
 
 ### 🔗 M7 — Rastreabilidade código↔spec
 
@@ -454,17 +454,17 @@ Declarar não é cumprir. O Raptor **mede** e compara com o declarado:
 
 ## 🧰 Capacidades do Raptor
 
-|       Capacidade        |                                        Para que serve                                         |                       Comandos                        |
-| ----------------------- | --------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
-| 🎚️ **Presets**          | Conjuntos reusáveis de artigos + gates, empilháveis. Bundled: `mobile-opinionated`, `lean`.   | `raptor preset list · add · info · remove`            |
+|       Capacidade        |                                           Para que serve                                           |                         Comandos                         |
+| ----------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
+| 🎚️ **Presets**          | Conjuntos reusáveis de artigos + gates, empilháveis. Bundled: `mobile-opinionated`, `lean`.        | `raptor preset list · add · info · remove`               |
 | 🔁 **Workflows**         | Orquestram o ciclo via YAML, com gates de revisão humana. Bundled: `sdd-cycle`, `sdd-cycle-quick`. | `raptor workflow catalog · run · status · resume · list` |
-| 🤖 **Agentes**           | Materializa os slash commands por agente.                                                     | `raptor add-agent` · `raptor list-agents`             |
-| 🧠 **Skills**            | Habilidades reusáveis materializadas para os agentes.                                         | `raptor skill add · list · sync · remove`             |
-| 🔌 **MCP**               | Registra servidores MCP e materializa nas configs nativas dos agentes.                        | `raptor mcp add · list · sync · remove`               |
-| 🪝 **Hooks**             | Scripts disparados em **34 pontos** do ciclo (`before_*`/`after_*` de 17 comandos).           | `raptor hook list · run`                              |
-| 📦 **Extensões**         | Pacotes self-contained (templates/gates/hooks/workflows).                                     | `raptor extension add · list · info · remove`         |
-| 🎟️ **Jira**             | Puxa issues do Jira (somente leitura) para semear specs.                                      | `raptor jira connect · status · pull · disconnect`    |
-| 📜 **Auditoria & trace** | Consulta a trilha de eventos e a rastreabilidade.                                             | `raptor audit query · show` · `raptor trace`          |
+| 🤖 **Agentes**           | Materializa os slash commands por agente.                                                          | `raptor add-agent` · `raptor list-agents`                |
+| 🧠 **Skills**            | Habilidades reusáveis materializadas para os agentes.                                              | `raptor skill add · list · sync · remove`                |
+| 🔌 **MCP**               | Registra servidores MCP e materializa nas configs nativas dos agentes.                             | `raptor mcp add · list · sync · remove`                  |
+| 🪝 **Hooks**             | Scripts disparados em **34 pontos** do ciclo (`before_*`/`after_*` de 17 comandos).                | `raptor hook list · run`                                 |
+| 📦 **Extensões**         | Pacotes self-contained (templates/gates/hooks/workflows).                                          | `raptor extension add · list · info · remove`            |
+| 🎟️ **Jira**             | Puxa issues do Jira (somente leitura) para semear specs.                                           | `raptor jira connect · status · pull · disconnect`       |
+| 📜 **Auditoria & trace** | Consulta a trilha de eventos e a rastreabilidade.                                                  | `raptor audit query · show` · `raptor trace`             |
 
 ### 🎟️ Integração com Jira
 
@@ -554,15 +554,15 @@ CLAUDE.md                    # 📎 bloco de contexto do agente
 
 Comece pelo **[📖 Glossário Canônico](docs/glossary.md)** — a referência normativa de todos os termos, gates, hierarquias e anti-padrões do Raptor (Gate, ADR, Override, Canonical, Preset, M1–M8, C1–C5, traceability…). É a base de onboarding para usuários, mantenedores e agentes IA.
 
-| Documento | Sobre |
-| --- | --- |
-| **[📖 docs/glossary.md](docs/glossary.md)** | Glossário canônico: conceitos, hierarquias, catálogo de 42 gates e de comandos CLI |
-| [🛡️ docs/readiness-gates.md](docs/readiness-gates.md) | Gates de prontidão (`spec/plan/tasks.ready`) em detalhe |
-| [🎨 docs/design-gate.md](docs/design-gate.md) | Design gate, integração Figma e `assets-manifest.json` |
-| [🔗 docs/artifact-chain.md](docs/artifact-chain.md) | Cadeia de artefatos e rastreabilidade spec→plan→tasks→código |
-| [🎟️ docs/jira-spec-enrichment.md](docs/jira-spec-enrichment.md) | Enriquecimento de spec a partir de cards do Jira |
-| [📐 docs/templates-architecture.md](docs/templates-architecture.md) | Dualidade de templates (`.hbs` vs `*-template.md`) e Priority Stack |
-| [✅ docs/spec-kit-parity.md](docs/spec-kit-parity.md) | Paridade com o GitHub Spec Kit |
+|                             Documento                              |                                       Sobre                                        |
+| ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |
+| **[📖 docs/glossary.md](docs/glossary.md)**                         | Glossário canônico: conceitos, hierarquias, catálogo de 42 gates e de comandos CLI |
+| [🛡️ docs/readiness-gates.md](docs/readiness-gates.md)              | Gates de prontidão (`spec/plan/tasks.ready`) em detalhe                            |
+| [🎨 docs/design-gate.md](docs/design-gate.md)                       | Design gate, integração Figma e `assets-manifest.json`                             |
+| [🔗 docs/artifact-chain.md](docs/artifact-chain.md)                 | Cadeia de artefatos e rastreabilidade spec→plan→tasks→código                       |
+| [🎟️ docs/jira-spec-enrichment.md](docs/jira-spec-enrichment.md)    | Enriquecimento de spec a partir de cards do Jira                                   |
+| [📐 docs/templates-architecture.md](docs/templates-architecture.md) | Dualidade de templates (`.hbs` vs `*-template.md`) e Priority Stack                |
+| [✅ docs/spec-kit-parity.md](docs/spec-kit-parity.md)               | Paridade com o GitHub Spec Kit                                                     |
 
 ### Hierarquia de governança (quem manda)
 

package/dist/_core/dist/agents/context-file.js

@@ -21,6 +21,14 @@ export function buildContextBlock(opts) {
         lines.push(`\n## Applicable articles\n`);
         lines.push(`- ${opts.constitutionArticles.join(", ")}`);
     }
+    if (opts.knowledge && opts.knowledge.length > 0) {
+        lines.push(`\n## Knowledge packs\n`);
+        lines.push("Preset knowledge installed for this project. READ the relevant file before generating code so the output matches the house patterns (components, recipes, tokens, conventions):");
+        lines.push("");
+        for (const ref of opts.knowledge) {
+            lines.push(`- \`${ref}\``);
+        }
+    }
     lines.push("\n## Raptor Commands (slash commands)\n");
     lines.push("- `/raptor-new` — create a new feature spec");
     lines.push("- `/raptor-clarify` — detect and resolve [NEEDS CLARIFICATION] in spec");

package/dist/_core/dist/extensions/types.js

@@ -26,6 +26,7 @@ export const EXTENSION_JSON_SCHEMA = {
             type: "object",
             properties: {
                 raptor_version: { type: "string" },
+                preset: { type: "string" },
             },
             additionalProperties: false,
         },
@@ -37,6 +38,7 @@ export const EXTENSION_JSON_SCHEMA = {
                 hooks: { type: "array", items: { type: "string" } },
                 workflows: { type: "array", items: { type: "string" } },
                 presets: { type: "array", items: { type: "string" } },
+                knowledge: { type: "array", items: { type: "string" } },
             },
             additionalProperties: false,
         },

package/dist/_core/dist/presets/gol-smiles-deep.js

@@ -0,0 +1,268 @@
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { parseFrontmatter } from "../frontmatter/index.js";
+import { analyzeGolArch, analyzeI18nUsage, parseTangerinaDesignMap, scanTangerinaFiles, } from "../verify/index.js";
+export function readGolDeepConfig(projectRoot) {
+    const path = join(projectRoot, ".raptor", "raptor.yml");
+    if (!existsSync(path))
+        return { enabled: false };
+    let parsed;
+    try {
+        parsed = parseYaml(readFileSync(path, "utf8"));
+    }
+    catch {
+        return { enabled: false };
+    }
+    if (typeof parsed !== "object" || parsed === null)
+        return { enabled: false };
+    const section = parsed["gol_smiles"];
+    if (typeof section !== "object" || section === null)
+        return { enabled: false };
+    const s = section;
+    const cfg = { enabled: s["deep_verify"] === true };
+    if (typeof s["source_root"] === "string")
+        cfg.sourceRoot = s["source_root"];
+    return cfg;
+}
+const SKIP_DIRS = new Set([
+    "node_modules",
+    ".raptor",
+    ".git",
+    "android",
+    "ios",
+    "dist",
+    "build",
+    "__tests__",
+    "__test__",
+]);
+export function collectGolSourceFiles(dir, exts) {
+    const out = [];
+    const walk = (d) => {
+        let entries;
+        try {
+            entries = readdirSync(d);
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (SKIP_DIRS.has(e))
+                continue;
+            const p = join(d, e);
+            let st;
+            try {
+                st = statSync(p);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory())
+                walk(p);
+            else if (exts.some((x) => e.endsWith(x)) && !/\.test\.|\.spec\./.test(e)) {
+                out.push(p);
+            }
+        }
+    };
+    walk(dir);
+    return out;
+}
+export function readGolFeatureDecls(featureDir) {
+    const decls = { recipes: [] };
+    const specPath = join(featureDir, "spec.md");
+    if (existsSync(specPath)) {
+        const { data } = parseFrontmatter(readFileSync(specPath, "utf8"));
+        if (Array.isArray(data.ui?.recipes))
+            decls.recipes = data.ui.recipes;
+        if (typeof data.ui?.scope === "string")
+            decls.uiScope = data.ui.scope;
+        if (typeof data.i18n?.scope === "string")
+            decls.i18nScope = data.i18n.scope;
+    }
+    const planPath = join(featureDir, "plan.md");
+    if (existsSync(planPath)) {
+        const { data } = parseFrontmatter(readFileSync(planPath, "utf8"));
+        if (typeof data.architecture?.module === "string")
+            decls.module = data.architecture.module;
+        if (typeof data.architecture?.layer === "string")
+            decls.layer = data.architecture.layer;
+    }
+    return decls;
+}
+export function resolveGolScanRoot(projectRoot, opts = {}) {
+    if (opts.pathFlag) {
+        const target = join(projectRoot, opts.pathFlag);
+        return {
+            scanRoot: existsSync(target) ? target : projectRoot,
+            source: "path-flag",
+        };
+    }
+    if (opts.sourceRoot) {
+        const target = join(projectRoot, opts.sourceRoot);
+        if (existsSync(target))
+            return { scanRoot: target, source: "config" };
+    }
+    if (opts.module) {
+        const modulesDir = join(projectRoot, "modernization", "modules");
+        if (existsSync(modulesDir)) {
+            const match = readdirSync(modulesDir).find((d) => d.toLowerCase() === opts.module.toLowerCase());
+            if (match)
+                return { scanRoot: join(modulesDir, match), source: "plan-module" };
+        }
+    }
+    for (const candidate of ["modernization", "src"]) {
+        const p = join(projectRoot, candidate);
+        if (existsSync(p))
+            return { scanRoot: p, source: "default" };
+    }
+    return { scanRoot: projectRoot, source: "default" };
+}
+export const GOL_DESIGN_MAP_PATH = join(".raptor", "extensions", "gol-smiles", "knowledge", "figma-tangerina-map.json");
+export function loadInstalledDesignMap(projectRoot) {
+    const path = join(projectRoot, GOL_DESIGN_MAP_PATH);
+    if (!existsSync(path))
+        return null;
+    const { map } = parseTangerinaDesignMap(readFileSync(path, "utf8"));
+    return map;
+}
+export function collectGolTranslationResources(projectRoot, scanRoot, languages) {
+    const out = [];
+    const seen = new Set();
+    const push = (p, language, scope) => {
+        if (seen.has(p) || !existsSync(p))
+            return;
+        seen.add(p);
+        out.push({
+            language,
+            path: p.replace(projectRoot + "/", ""),
+            content: readFileSync(p, "utf8"),
+            scope,
+        });
+    };
+    const walk = (d, scope) => {
+        let entries;
+        try {
+            entries = readdirSync(d);
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (SKIP_DIRS.has(e))
+                continue;
+            const p = join(d, e);
+            let st;
+            try {
+                st = statSync(p);
+            }
+            catch {
+                continue;
+            }
+            if (!st.isDirectory())
+                continue;
+            const effective = scope === "module" || p === scanRoot || p.startsWith(scanRoot + "/")
+                ? "module"
+                : "global";
+            if (e.toLowerCase() === "translations") {
+                for (const lang of languages)
+                    push(join(p, `${lang}.json`), lang, effective);
+            }
+            walk(p, effective);
+        }
+    };
+    walk(scanRoot, "module");
+    for (const base of ["modernization", "src", "modules"]) {
+        const dir = join(projectRoot, base);
+        if (existsSync(dir))
+            walk(dir, "global");
+    }
+    for (const lang of languages) {
+        push(join(projectRoot, "src", "Translations", "lang", `${lang}.json`), lang, "global");
+    }
+    return out;
+}
+function readRel(projectRoot, files) {
+    return files.map((p) => ({
+        path: p.replace(projectRoot + "/", ""),
+        content: readFileSync(p, "utf8"),
+    }));
+}
+const SAMPLE = 5;
+function sampleOf(report) {
+    return report.findings
+        .filter((f) => f.severity === "error")
+        .slice(0, SAMPLE)
+        .map((f) => ({ rule: f.rule, file: f.file, line: f.line, message: f.message }));
+}
+export function runGolDeepTangerina(projectRoot, featureDir) {
+    const cfg = readGolDeepConfig(projectRoot);
+    if (!cfg.enabled)
+        return { skipped: "deep_verify off" };
+    const decls = readGolFeatureDecls(featureDir);
+    if (decls.uiScope === "none")
+        return { skipped: "ui.scope: none" };
+    const { scanRoot } = resolveGolScanRoot(projectRoot, {
+        sourceRoot: cfg.sourceRoot,
+        module: decls.module,
+    });
+    const files = collectGolSourceFiles(scanRoot, [".tsx", ".jsx"]);
+    if (files.length === 0)
+        return { skipped: `no UI source under ${scanRoot}` };
+    const map = loadInstalledDesignMap(projectRoot);
+    const report = scanTangerinaFiles(readRel(projectRoot, files), {
+        declaredRecipes: decls.recipes,
+        knownIcons: map?.icons ?? [],
+    });
+    return {
+        filesScanned: report.filesScanned,
+        errors: report.errors,
+        warnings: report.warnings,
+        sample: sampleOf(report),
+        command: "raptor verify tangerina",
+    };
+}
+export function runGolDeepArch(projectRoot, featureDir) {
+    const cfg = readGolDeepConfig(projectRoot);
+    if (!cfg.enabled)
+        return { skipped: "deep_verify off" };
+    const decls = readGolFeatureDecls(featureDir);
+    const { scanRoot } = resolveGolScanRoot(projectRoot, {
+        sourceRoot: cfg.sourceRoot,
+        module: decls.module,
+    });
+    const files = collectGolSourceFiles(scanRoot, [".ts", ".tsx", ".js", ".jsx"]);
+    if (files.length === 0)
+        return { skipped: `no source under ${scanRoot}` };
+    const report = analyzeGolArch(readRel(projectRoot, files));
+    return {
+        filesScanned: report.filesScanned,
+        errors: report.errors,
+        warnings: report.warnings,
+        sample: sampleOf(report),
+        command: "raptor verify arch",
+    };
+}
+export function runGolDeepI18n(projectRoot, featureDir, languages) {
+    const cfg = readGolDeepConfig(projectRoot);
+    if (!cfg.enabled)
+        return { skipped: "deep_verify off" };
+    const decls = readGolFeatureDecls(featureDir);
+    if (decls.i18nScope === "none")
+        return { skipped: "i18n.scope: none" };
+    const { scanRoot } = resolveGolScanRoot(projectRoot, {
+        sourceRoot: cfg.sourceRoot,
+        module: decls.module,
+    });
+    const files = collectGolSourceFiles(scanRoot, [".ts", ".tsx", ".js", ".jsx"]);
+    if (files.length === 0)
+        return { skipped: `no source under ${scanRoot}` };
+    const resources = collectGolTranslationResources(projectRoot, scanRoot, languages);
+    const report = analyzeI18nUsage(readRel(projectRoot, files), resources, { languages });
+    return {
+        filesScanned: report.filesScanned,
+        errors: report.errors,
+        warnings: report.warnings,
+        sample: sampleOf(report),
+        command: "raptor verify i18n",
+    };
+}