@semacode/cli 1.5.40 → 1.5.42

package/dist/profileI18nVisivel.js

@@ -0,0 +1,157 @@
+// SEMA-GOVERNED: sema.produto.governanca_ia.qualidade_contrato
+// Descricao: validador observavel de i18n por idioma em artefatos reais do profile Software.
+import { localizacaoDoMatchProfile } from "./profileArtefatoBase.js";
+import { VALIDADORES_I18N } from "./profileI18nCatalogo.js";
+import { criarAchadoArtefatoProfile } from "./profileRegras.js";
+const REGEX_TEXTO_TAG = />\s*([^<>{}]{1,240}?[A-Za-zÀ-ÿ][^<>{}]{0,240})\s*</g;
+const REGEX_ATRIBUTO_VISIVEL = /\b(?:placeholder|aria-label|title|alt|value|label)\s*=\s*(["'])([^"']{1,240})\1/gi;
+const REGEX_LITERAL_STRING = /"([^"\\\r\n]{1,240}(?:\\.[^"\\\r\n]{0,240})*)"|'([^'\\\r\n]{1,240}(?:\\.[^'\\\r\n]{0,240})*)'|`([^`\\]{1,240}(?:\\.[^`\\]{0,240})*)`/g;
+function semAcentos(texto) {
+    return texto.normalize("NFD").replace(/\p{Diacritic}/gu, "");
+}
+function normalizarTokenIdioma(token) {
+    return token.trim().toLowerCase().replace(/_/g, "-");
+}
+function idiomaSuportado(token) {
+    const normalizado = normalizarTokenIdioma(token);
+    if (normalizado === "pt" || normalizado === "pt-br" || normalizado === "ptbr")
+        return "pt-BR";
+    if (normalizado === "es" || normalizado === "es-es" || normalizado === "es-mx" || normalizado === "es-419")
+        return "es";
+    if (normalizado === "fr" || normalizado === "fr-fr" || normalizado === "fr-ca")
+        return "fr";
+    return null;
+}
+function adicionarIdioma(idiomas, semValidador, token) {
+    const suportado = idiomaSuportado(token);
+    if (suportado) {
+        idiomas.add(suportado);
+    }
+    else {
+        semValidador.add(normalizarTokenIdioma(token));
+    }
+}
+export function detectarEscopoI18nObservavel(contrato) {
+    const normalizado = semAcentos(contrato).toLowerCase();
+    const mencionaI18n = /\bi18n\b|\bi18n[-_][a-z0-9_-]+/i.test(normalizado);
+    const declaraTextoVisivel = mencionaI18n || /\b(?:texto[_ -]?visivel|interface|ui|labels?|mensagens?|placeholder|aria-label|locale|idioma|language|traducao|traducoes|translation|acento|acentos|diacritico|diacriticos|cedilha|mojibake)\b/.test(normalizado);
+    const declaraIdiomaOuI18n = mencionaI18n || /\b(?:locale|idioma|language|traducao|traducoes|translation|pt[-_ ]?br|portugues|portuguese|espanhol|spanish|frances|french)\b/.test(normalizado);
+    const ativo = declaraTextoVisivel && declaraIdiomaOuI18n;
+    if (!ativo)
+        return { ativo: false, idiomaNaoDeclarado: false, idiomas: [], idiomasSemValidador: [] };
+    const idiomas = new Set();
+    const semValidador = new Set();
+    if (/\bi18n[-_]ptbr\b|\b(?:pt[-_ ]?br|portugues|portuguese)\b/.test(normalizado))
+        idiomas.add("pt-BR");
+    if (/\b(?:espanhol|espanol|spanish)\b/.test(normalizado))
+        idiomas.add("es");
+    if (/\b(?:frances|french)\b/.test(normalizado))
+        idiomas.add("fr");
+    for (const match of normalizado.matchAll(/\bi18n[-_]([a-z]{2,4}(?:[-_][a-z0-9]{2,3})?)\b/g)) {
+        adicionarIdioma(idiomas, semValidador, match[1] ?? "");
+    }
+    for (const match of normalizado.matchAll(/\b(?:locale|idioma|language)\s*[:=]?\s*["']?([a-z]{2}(?:[-_][a-z0-9]{2,3})?)\b/g)) {
+        adicionarIdioma(idiomas, semValidador, match[1] ?? "");
+    }
+    return {
+        ativo: true,
+        idiomaNaoDeclarado: idiomas.size === 0 && semValidador.size === 0,
+        idiomas: [...idiomas],
+        idiomasSemValidador: [...semValidador],
+    };
+}
+function limparTextoSegmento(texto) {
+    return texto.replace(/\s+/g, " ").trim();
+}
+function contextoPareceScriptOuEstilo(artefato, indice) {
+    const antes = artefato.slice(Math.max(0, indice - 40), indice).toLowerCase();
+    return /<\s*(?:script|style|template)\b/.test(antes);
+}
+function textoTemTermoSemDiacritico(texto, validadores) {
+    return validadores.some((validador) => validador.termos.some((termo) => termo.regex.test(texto)));
+}
+function literalPareceTecnico(texto, validadores) {
+    const valor = texto.trim();
+    if (!valor || valor.length > 240)
+        return true;
+    if (/^(?:GET|POST|PUT|PATCH|DELETE|true|false|null|undefined)$/i.test(valor))
+        return true;
+    if (/^(?:https?:\/\/|\/|\.\/|#|[A-Z_][A-Z0-9_]*$)/.test(valor))
+        return true;
+    return /^[a-z0-9_.:/#-]+$/.test(valor) && !textoTemTermoSemDiacritico(valor, validadores);
+}
+function coletarSegmentosTextoVisivel(artefato, validadores) {
+    const segmentos = [];
+    for (const match of artefato.matchAll(REGEX_TEXTO_TAG)) {
+        if (contextoPareceScriptOuEstilo(artefato, match.index ?? 0))
+            continue;
+        const texto = limparTextoSegmento(match[1] ?? "");
+        if (texto)
+            segmentos.push({ texto, inicio: (match.index ?? 0) + match[0].indexOf(match[1] ?? ""), contexto: "texto_tag_html" });
+    }
+    for (const match of artefato.matchAll(REGEX_ATRIBUTO_VISIVEL)) {
+        const texto = limparTextoSegmento(match[2] ?? "");
+        if (texto)
+            segmentos.push({ texto, inicio: (match.index ?? 0) + match[0].indexOf(match[2] ?? ""), contexto: "atributo_visivel_html" });
+    }
+    for (const match of artefato.matchAll(REGEX_LITERAL_STRING)) {
+        const texto = limparTextoSegmento(match[1] ?? match[2] ?? match[3] ?? "");
+        if (literalPareceTecnico(texto, validadores) || !textoTemTermoSemDiacritico(texto, validadores))
+            continue;
+        segmentos.push({ texto, inicio: (match.index ?? 0) + match[0].indexOf(texto), contexto: "literal_string_ui" });
+    }
+    return segmentos;
+}
+function severidadeI18n(maturidade) {
+    if (maturidade === "critical")
+        return "critical";
+    if (maturidade === "draft")
+        return "warning";
+    return "blocking";
+}
+function criarAchadoIdiomaNaoDeclarado(maturidade) {
+    return criarAchadoArtefatoProfile("software_i18n_idioma_nao_declarado", "contrato declara i18n observavel, mas nao declara idioma/locale verificavel", false, severidadeI18n(maturidade), undefined, "declare o idioma explicitamente, por exemplo i18n_ptbr, i18n_es ou locale: pt-BR.", "i18n sem idioma impede validar acentos, diacriticos e texto visivel de forma observavel.", { regra: "i18n_idioma_obrigatorio", risco: "garantia_i18n_ambigua" });
+}
+function criarAchadoIdiomaSemValidador(idioma, maturidade) {
+    return criarAchadoArtefatoProfile("software_i18n_idioma_sem_validador_observavel", "contrato declara idioma i18n sem validador observavel registrado", false, severidadeI18n(maturidade), undefined, `adicione validador observavel para "${idioma}" ou remova a garantia de i18n desse idioma.`, "a garantia i18n nao pode aprovar idioma sem regra de verificacao executavel.", { regra: "i18n_validador_por_idioma_obrigatorio", risco: "garantia_i18n_sem_checker" });
+}
+export function avaliarI18nVisivelArtefato(contrato, artefato, maturidade) {
+    const escopo = detectarEscopoI18nObservavel(contrato);
+    if (!escopo.ativo)
+        return [];
+    const achados = [];
+    if (escopo.idiomaNaoDeclarado)
+        achados.push(criarAchadoIdiomaNaoDeclarado(maturidade));
+    for (const idioma of escopo.idiomasSemValidador) {
+        achados.push(criarAchadoIdiomaSemValidador(idioma, maturidade));
+    }
+    const validadores = escopo.idiomas.map((idioma) => VALIDADORES_I18N[idioma]);
+    const vistos = new Set();
+    for (const segmento of coletarSegmentosTextoVisivel(artefato, validadores)) {
+        for (const validador of validadores) {
+            for (const termo of validador.termos) {
+                const match = termo.regex.exec(segmento.texto);
+                if (!match)
+                    continue;
+                const inicio = segmento.inicio + match.index;
+                const chave = `${validador.idioma}:${inicio}:${match[0].toLowerCase()}`;
+                if (vistos.has(chave))
+                    continue;
+                vistos.add(chave);
+                const localizacao = localizacaoDoMatchProfile(artefato, inicio, match[0].length);
+                achados.push(criarAchadoArtefatoProfile("software_i18n_diacritico_ausente", "texto visivel perdeu diacritico obrigatorio para idioma declarado no contrato", false, severidadeI18n(maturidade), localizacao.trecho, `troque "${match[0]}" por "${termo.esperado}" em ${validador.nome} ou remova essa garantia i18n do contrato.`, `contrato declara i18n observavel para ${validador.idioma}, mas o artefato contem literal de UI sem diacritico no contexto ${segmento.contexto}.`, {
+                    linha: localizacao.linha,
+                    coluna: localizacao.coluna,
+                    inicio: localizacao.inicio,
+                    fim: localizacao.fim,
+                    regra: `i18n_${validador.idioma.toLowerCase()}_diacriticos_observaveis`,
+                    risco: "garantia_i18n_nao_observada",
+                }));
+                if (achados.length >= 16)
+                    return achados;
+            }
+        }
+    }
+    return achados;
+}
+//# sourceMappingURL=profileI18nVisivel.js.map

package/dist/profileI18nVisivel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profileI18nVisivel.js","sourceRoot":"","sources":["../src/profileI18nVisivel.ts"],"names":[],"mappings":"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"}

package/docs/agentes-por-capacidade.md

@@ -110,7 +110,7 @@ Timeout definido pelo agente não é falha do Sema. Se `sema resumo`, `inspecion
 
 ## Idioma
 
-A linguagem humana da resposta deve seguir o idioma do usuário e preservar acentos, cedilha, pontuação e símbolos esperados. A DSL .sema pode ter palavras-chave ASCII; isso não autoriza PT-BR sem acentos.
+A linguagem humana da resposta deve seguir o idioma do usuário e preservar acentos, cedilha, pontuação e símbolos esperados. A DSL .sema pode ter palavras-chave ASCII; isso não autoriza PT-BR sem acentos. Em PT-BR, texto humano sem acentos é entrega inválida.
 
 A gramática Sema pode ter palavras-chave ASCII. Isso não autoriza resposta humana sem acentos.
 

package/docs/cli.md

@@ -7,10 +7,11 @@
 
 ## English
 
-The Sema CLI is installed from the `@semacode/cli` npm installer package. It is not the commercial coordinator and it does not publish the MCP server or product control plane.
+The Sema CLI is installed from the `@semacode/cli` npm package. In local IDEs it is the complete Sema runtime: it reads the workspace, runs gates, validates contracts, checks drift/impact, and consults the SEMAS control plane before operating.
 
-Use it for the work the MCP authorizes:
+Use it for local-agent work:
 
+- run `sema preflight <command> --json` before action;
 - validate `.sema` contracts;
 - inspect modules, tasks, routes, and effects;
 - check drift against live or selected code;
@@ -20,13 +21,16 @@ Use it for the work the MCP authorizes:
 - run profile and pipeline validators;
 - execute local or VPS-side project actions.
 
-The private MCP decides when to charge SEMAS and which operation can continue. The CLI executes the technical work in the environment where it has file access.
+The key installer from the site installs Node/npm when missing, installs the CLI, and saves `SEMA_CLI_AUTH_TOKEN`, `SEMA_CLI_CONTROL_PLANE_URL`, and compatibility MCP env vars. If `preflight` returns anything other than `decisao=use_cli_local`, stop. Do not call remote MCP, `sema_sync`, `sema_contratos_sincronizar`, or `sema mcp-client` just to read a local workspace.
+
+Remote MCP remains the web/chat surface for ChatGPT, Lovable, GPTs, and similar clients without local workspace access. It uses the same commercial control plane and SEMAS account.
 
 ```bash
 npm install -g @semacode/cli
 ```
 
 ```bash
+sema preflight resumo --json
 sema resumo . --curto
 sema validar contratos/pedidos.sema --json
 sema drift contratos/pedidos.sema --escopo modulo --json
@@ -36,10 +40,11 @@ sema finalizar-mudanca --intencao "alterar pedidos" --doc-lida README.md --json
 
 ## Português
 
-A CLI da Sema é instalada pelo pacote npm do instalador `@semacode/cli`. Ela não é o coordenador comercial e não publica o servidor MCP nem o control plane do produto.
+A CLI da Sema é instalada pelo pacote npm `@semacode/cli`. Em IDE local, ela é o runtime completo da Sema: lê o workspace, roda gates, valida contratos, mede drift/impacto e consulta o control plane de SEMAS antes de operar.
 
-Use a CLI para o trabalho que o MCP autorizar:
+Use a CLI para trabalho de agente local:
 
+- rodar `sema preflight <comando> --json` antes de agir;
 - validar contratos `.sema`;
 - inspecionar módulos, tasks, rotas e efeitos;
 - medir drift contra código vivo ou código selecionado;
@@ -49,13 +54,16 @@ Use a CLI para o trabalho que o MCP autorizar:
 - rodar validadores de profiles e pipelines;
 - executar ações locais ou na VPS.
 
-O MCP privado decide quando cobrar SEMAS e qual operação pode continuar. A CLI executa o trabalho técnico no ambiente onde tem acesso aos arquivos.
+O instalador do site instala Node/npm quando faltar, instala a CLI e grava `SEMA_CLI_AUTH_TOKEN`, `SEMA_CLI_CONTROL_PLANE_URL` e variáveis MCP de compatibilidade. Se o `preflight` retornar qualquer coisa diferente de `decisao=use_cli_local`, pare. Não chame MCP remoto, `sema_sync`, `sema_contratos_sincronizar` nem `sema mcp-client` só para ler workspace local.
+
+O MCP remoto continua sendo a superfície web/chat para ChatGPT, Lovable, GPTs e clientes parecidos sem acesso ao workspace local. Ele usa o mesmo control plane comercial e a mesma conta de SEMAS.
 
 ```bash
 npm install -g @semacode/cli
 ```
 
 ```bash
+sema preflight resumo --json
 sema resumo . --curto
 sema validar contratos/pedidos.sema --json
 sema drift contratos/pedidos.sema --escopo modulo --json
@@ -65,10 +73,11 @@ sema finalizar-mudanca --intencao "alterar pedidos" --doc-lida README.md --json
 
 ## Español
 
-La CLI de Sema se instala desde el paquete npm instalador `@semacode/cli`. No es el coordinador comercial y no publica el servidor MCP ni el control plane del producto.
+La CLI de Sema se instala desde el paquete npm `@semacode/cli`. En una IDE local es el runtime completo de Sema: lee el workspace, ejecuta gates, valida contratos, mide drift/impacto y consulta el control plane de SEMAS antes de operar.
 
-Usa la CLI para el trabajo que el MCP autorice:
+Usa la CLI para trabajo de agente local:
 
+- ejecutar `sema preflight <comando> --json` antes de actuar;
 - validar contratos `.sema`;
 - inspeccionar módulos, tasks, rutas y efectos;
 - medir drift contra código vivo o código seleccionado;
@@ -78,13 +87,16 @@ Usa la CLI para el trabajo que el MCP autorice:
 - ejecutar validadores de profiles y pipelines;
 - ejecutar acciones locales o en la VPS.
 
-El MCP privado decide cuándo cobrar SEMAS y qué operación puede continuar. La CLI ejecuta el trabajo técnico en el entorno donde tiene acceso a los archivos.
+El instalador del sitio instala Node/npm cuando falten, instala la CLI y guarda `SEMA_CLI_AUTH_TOKEN`, `SEMA_CLI_CONTROL_PLANE_URL` y variables MCP de compatibilidad. Si `preflight` devuelve algo distinto de `decisao=use_cli_local`, para. No llames el MCP remoto, `sema_sync`, `sema_contratos_sincronizar` ni `sema mcp-client` solo para leer un workspace local.
+
+El MCP remoto sigue siendo la superficie web/chat para ChatGPT, Lovable, GPTs y clientes similares sin acceso al workspace local. Usa el mismo control plane comercial y la misma cuenta de SEMAS.
 
 ```bash
 npm install -g @semacode/cli
 ```
 
 ```bash
+sema preflight resumo --json
 sema resumo . --curto
 sema validar contratos/pedidos.sema --json
 sema drift contratos/pedidos.sema --escopo modulo --json

package/docs/como-ensinar-a-sema-para-ia.md

@@ -9,7 +9,7 @@
 
 Sema is taught to an AI through operational context, not through vague explanations. The agent needs syntax, semantics, intermediate representation, examples, and the project contract before it touches code or documents.
 
-In local IDEs, the first step is to confirm that `AGENTS.md` exists in the project root. If it does not exist, download `https://sema.otimitare.online/AGENTS.md` into the project. In web chats, do not download files into the chat environment; use `sema_chat_contexto`, `sema_sync`, and inline content.
+In local IDEs, the first step is to confirm that `AGENTS.md` exists in the project root and that the complete Sema CLI is installed. Then run `sema preflight resumo --json`; if the decision is not `use_cli_local`, stop. With CLI authorized, run `sema resumo`, `sema docs-impacto`, `sema inspecionar`, `sema drift`, and `sema impacto` locally. Do not call remote MCP, `sema_sync`, `sema_contratos_sincronizar`, or `sema mcp-client` to read a local workspace. In web chats, do not download files into the chat environment; call `sema_chat_contexto` and then `sema_sync` with contract, selected code, operational docs, and an index.
 
 The correct framing is simple: contract first, evidence before action, and no guessing from raw code when Sema can provide summary, drift, impact, and required docs.
 
@@ -17,7 +17,7 @@ The correct framing is simple: contract first, evidence before action, and no gu
 
 A Sema é ensinada para IA por contexto operacional, não por explicação vaga. O agente precisa de sintaxe, semântica, representação intermediária, exemplos e contrato do projeto antes de tocar código ou documentos.
 
-Em IDE local, o primeiro passo é confirmar que `AGENTS.md` existe na raiz do projeto. Se não existir, baixe `https://sema.otimitare.online/AGENTS.md` para o projeto. Em chats web, não baixe arquivos no ambiente do chat; use `sema_chat_contexto`, `sema_sync` e conteúdo inline.
+Em IDE local, o primeiro passo é confirmar que `AGENTS.md` existe na raiz do projeto e que a CLI completa da Sema está instalada. Depois rode `sema preflight resumo --json`; se a decisão não for `use_cli_local`, pare. Com CLI autorizada, rode `sema resumo`, `sema docs-impacto`, `sema inspecionar`, `sema drift` e `sema impacto` localmente. Não chame MCP remoto, `sema_sync`, `sema_contratos_sincronizar` nem `sema mcp-client` para ler workspace local. Em chats web, não baixe arquivos no ambiente do chat; chame `sema_chat_contexto` e depois `sema_sync` com contrato, código selecionado, docs operacionais e índice.
 
 A moldura correta é simples: contrato primeiro, evidência antes da ação e nada de adivinhar lendo código cru quando a Sema pode entregar resumo, drift, impacto e docs obrigatórias.
 
@@ -25,6 +25,6 @@ A moldura correta é simples: contrato primeiro, evidência antes da ação e na
 
 Sema se enseña a una IA con contexto operativo, no con explicaciones vagas. El agente necesita sintaxis, semántica, representación intermedia, ejemplos y contrato del proyecto antes de tocar código o documentos.
 
-En IDE local, el primer paso es confirmar que `AGENTS.md` existe en la raíz del proyecto. Si no existe, descarga `https://sema.otimitare.online/AGENTS.md` en el proyecto. En chats web, no descargues archivos en el entorno del chat; usa `sema_chat_contexto`, `sema_sync` y contenido inline.
+En una IDE local, el primer paso es confirmar que `AGENTS.md` existe en la raíz del proyecto y que la CLI completa de Sema está instalada. Después ejecuta `sema preflight resumo --json`; si la decisión no es `use_cli_local`, para. Con la CLI autorizada, ejecuta `sema resumo`, `sema docs-impacto`, `sema inspecionar`, `sema drift` y `sema impacto` localmente. No llames el MCP remoto, `sema_sync`, `sema_contratos_sincronizar` ni `sema mcp-client` para leer un workspace local. En chats web, no descargues archivos en el entorno del chat; llama `sema_chat_contexto` y después `sema_sync` con contrato, código seleccionado, docs operativas e índice.
 
 El encuadre correcto es simple: contrato primero, evidencia antes de la acción y nada de adivinar leyendo código crudo cuando Sema puede entregar resumen, drift, impacto y docs obligatorias.

package/docs/fluxo-pratico-ia-sema.md

@@ -22,16 +22,26 @@ Regra de idioma humano: responda no idioma do usuário. Em PT-BR, use acentos, c
 
 Regra de timeout: timeout local do agente não é falha do Sema. Se `sema resumo`, `drift`, `docs-impacto` ou outro gate estourar, aumente o timeout e tente de novo antes de declarar bloqueio. Para projeto grande, escopo menor vem primeiro: `sema resumo caminho/arquivo.sema --micro --para mudanca`.
 
+## Superfície obrigatória
+
+1. IDE local com workspace no disco: rode `sema preflight resumo --json`. Se `decisao` não for `use_cli_local`, pare bloqueado.
+2. IDE local autorizada: use somente a CLI local para `resumo`, `docs-impacto`, `inspecionar`, `drift`, `impacto`, `validar`, `verificar` e `finalizar-mudanca`.
+3. IDE local proibida: não chame MCP remoto, `sema_sync`, `sema_contratos_sincronizar` nem `sema mcp-client` para ler o workspace local.
+4. Web/chat/remoto sem workspace local: use `sema_chat_contexto`, depois `sema_sync` inline com contrato `.sema`, código selecionado, documentação operacional e índice; use o `projeto` retornado.
+5. Se a IA não consegue identificar se está em IDE local ou web/chat remoto, ela deve parar e declarar bloqueio. Não invente superfície.
+
 ## Fluxo curto
-
-1. ler contexto do projeto
-2. identificar a capacidade da IA
-3. identificar o módulo alvo
-4. consultar o menor artefato semântico suficiente
-5. editar
-6. formatar
-7. validar
-8. verificar
+
+1. identificar a superfície: CLI local ou MCP remoto web/chat
+2. em IDE local, rodar `sema preflight resumo --json` e parar se não retornar `use_cli_local`
+3. ler contexto do projeto
+4. identificar a capacidade da IA
+5. identificar o módulo alvo
+6. consultar o menor artefato semântico suficiente
+7. editar
+8. formatar
+9. validar
+10. verificar
 
 ## Fluxo detalhado
 
@@ -51,9 +61,9 @@ Se o trabalho estiver ligado a pagamento, ler também:
 
 Antes de despejar contexto na IA, escolha o que ela aguenta:
 
-- IA fraca, gratuita ou com pouca disciplina: `SEMA_BOOT.md`, `SEMA_SMALL_MODEL.md`, `sema resumo --micro` e `briefing.min.json`
-- IA média: `sema resumo --curto`, `briefing.min.json` e `drift.json`
-- IA forte: `contexto-ia`, `briefing.json`, `drift.json`, `ir.json` e `ast.json`
+- IA fraca, gratuita ou com pouca disciplina: `sema preflight resumo --json`, `SEMA_BOOT.md`, `SEMA_SMALL_MODEL.md`, `sema resumo --micro` e `briefing.min.json`
+- IA média: `sema preflight resumo --json`, `sema resumo --curto`, `briefing.min.json` e `drift.json`
+- IA forte: `sema preflight resumo --json`, `contexto-ia`, `briefing.json`, `drift.json`, `ir.json` e `ast.json`
 
 Se qualquer comando Sema acima estourar timeout definido pela própria IA, ela deve aumentar o timeout e repetir. Timeout do agente não autoriza pular Sema nem concluir que a sessão está inativa.
 
@@ -75,10 +85,11 @@ Regra pratica:
 
 Antes de alterar, a IA deve executar:
 
-```bash
-sema resumo caminho/arquivo.sema --curto --para mudanca
-sema ast caminho/arquivo.sema --json
-sema ir caminho/arquivo.sema --json
+```bash
+sema preflight resumo --json
+sema resumo caminho/arquivo.sema --curto --para mudanca
+sema ast caminho/arquivo.sema --json
+sema ir caminho/arquivo.sema --json
 ```
 
 Objetivo:
@@ -150,20 +161,22 @@ sema verificar arquivo-ou-pasta --json --saida ./.tmp/verificacao-ia
 
 Se voce quiser o menor fluxo aceitavel para uma IA fraca:
 
-```bash
-sema resumo caminho/arquivo.sema --micro --para mudanca
-sema formatar caminho/arquivo.sema
-sema validar caminho/arquivo.sema --json
+```bash
+sema preflight resumo --json
+sema resumo caminho/arquivo.sema --micro --para mudanca
+sema formatar caminho/arquivo.sema
+sema validar caminho/arquivo.sema --json
 ```
 
 Mas, sendo sincero, o fluxo bom mesmo e fechar com `verificar`.
 
 Se a tarefa envolver código derivado, o fluxo mínimo aceitavel vira:
 
-```bash
-sema ir caminho/arquivo.sema --json
-sema formatar caminho/arquivo.sema
-sema validar caminho/arquivo.sema --json
+```bash
+sema preflight resumo --json
+sema ir caminho/arquivo.sema --json
+sema formatar caminho/arquivo.sema
+sema validar caminho/arquivo.sema --json
 sema compilar caminho/arquivo.sema --alvo typescript --saida ./saida/typescript
 ```
 

package/docs/instalacao-e-primeiro-uso.md

@@ -7,9 +7,13 @@
 
 ## English
 
-Sema is private. The MCP endpoint is the primary product surface and coordinates authentication, SEMAS consumption, profiles, pipelines, and project mirrors.
+Sema is private. Local IDEs use the complete Sema CLI. Web/chat clients without local workspace access use the remote MCP.
 
-Local IDEs should receive `AGENTS.md` first. Web chats should use `sema_chat_contexto` and `sema_sync` instead of downloading files into the chat environment.
+In a local IDE, install the CLI and key, keep `AGENTS.md` in the project root, run `sema preflight resumo --json`, and stop unless `decisao` is `use_cli_local`. After that, use local CLI commands: `sema resumo`, `sema docs-impacto`, `sema inspecionar`, `sema drift`, `sema impacto`, `sema validar`, and `sema finalizar-mudanca`.
+
+Do not call remote MCP, `sema_sync`, `sema_contratos_sincronizar`, or `sema mcp-client` to read a local workspace. Those paths are forbidden for local IDE work when the CLI is operational.
+
+Web chats should use `sema_chat_contexto` and `sema_sync` with inline contract, selected code, operational docs, and index. Web chats must not download files into the chat environment.
 
 Install the governed CLI/client from npm when a local IDE or VPS mirror needs the `sema` command:
 
@@ -17,13 +21,17 @@ Install the governed CLI/client from npm when a local IDE or VPS mirror needs th
 npm install -g @semacode/cli
 ```
 
-The MCP server remains the private product surface. Do not install the MCP from the npm installer package; configure the authorized remote `/mcp` endpoint instead.
+The MCP server remains the private web/chat surface. Do not install the MCP from the npm installer package; configure the authorized remote `/mcp` endpoint only for remote clients.
 
 ## Português
 
-A Sema é privada. O endpoint MCP é a superfície principal do produto e coordena autenticação, consumo de SEMAS, profiles, pipelines e espelhos de projeto.
+A Sema é privada. IDE local usa a CLI completa da Sema. Cliente web/chat sem acesso ao workspace local usa MCP remoto.
+
+Em IDE local, instale a CLI e a chave, mantenha `AGENTS.md` na raiz do projeto, rode `sema preflight resumo --json` e pare se `decisao` não for `use_cli_local`. Depois disso, use comandos locais da CLI: `sema resumo`, `sema docs-impacto`, `sema inspecionar`, `sema drift`, `sema impacto`, `sema validar` e `sema finalizar-mudanca`.
 
-IDEs locais devem receber `AGENTS.md` primeiro. Chats web devem usar `sema_chat_contexto` e `sema_sync`, não baixar arquivos no ambiente do chat.
+Não chame MCP remoto, `sema_sync`, `sema_contratos_sincronizar` nem `sema mcp-client` para ler workspace local. Esses caminhos são proibidos em IDE local quando a CLI está operacional.
+
+Chats web devem usar `sema_chat_contexto` e `sema_sync` com contrato inline, código selecionado, docs operacionais e índice. Chats web não devem baixar arquivos no ambiente do chat.
 
 Instale a CLI/cliente governada pelo npm quando uma IDE local ou espelho na VPS precisar do comando `sema`:
 
@@ -31,13 +39,17 @@ Instale a CLI/cliente governada pelo npm quando uma IDE local ou espelho na VPS
 npm install -g @semacode/cli
 ```
 
-O servidor MCP continua sendo a superfície privada do produto. Não instale o MCP pelo pacote npm do instalador; configure o endpoint remoto `/mcp` autorizado.
+O servidor MCP continua sendo a superfície privada para web/chat. Não instale o MCP pelo pacote npm do instalador; configure o endpoint remoto `/mcp` autorizado apenas para clientes remotos.
 
 ## Español
 
-Sema es privada. El endpoint MCP es la superficie principal del producto y coordina autenticación, consumo de SEMAS, profiles, pipelines y espejos de proyecto.
+Sema es privada. Una IDE local usa la CLI completa de Sema. Un cliente web/chat sin acceso al workspace local usa el MCP remoto.
+
+En una IDE local, instala la CLI y la clave, deja `AGENTS.md` en la raíz del proyecto, ejecuta `sema preflight resumo --json` y para si `decisao` no es `use_cli_local`. Después usa comandos locales de la CLI: `sema resumo`, `sema docs-impacto`, `sema inspecionar`, `sema drift`, `sema impacto`, `sema validar` y `sema finalizar-mudanca`.
+
+No llames el MCP remoto, `sema_sync`, `sema_contratos_sincronizar` ni `sema mcp-client` para leer un workspace local. Esos caminos están prohibidos en una IDE local cuando la CLI está operacional.
 
-Las IDEs locales deben recibir `AGENTS.md` primero. Los chats web deben usar `sema_chat_contexto` y `sema_sync`, no descargar archivos en el entorno del chat.
+Los chats web deben usar `sema_chat_contexto` y `sema_sync` con contrato inline, código seleccionado, docs operativas e índice. Los chats web no deben descargar archivos en el entorno del chat.
 
 Instala la CLI/cliente gobernada desde npm cuando una IDE local o espejo en la VPS necesite el comando `sema`:
 
@@ -45,4 +57,4 @@ Instala la CLI/cliente gobernada desde npm cuando una IDE local o espejo en la V
 npm install -g @semacode/cli
 ```
 
-El servidor MCP sigue siendo la superficie privada del producto. No instales el MCP desde el paquete npm instalador; configura el endpoint remoto `/mcp` autorizado.
+El servidor MCP sigue siendo la superficie privada para web/chat. No instales el MCP desde el paquete npm instalador; configura el endpoint remoto `/mcp` autorizado solo para clientes remotos.

package/docs/integracao-com-ia.md

@@ -21,18 +21,24 @@ Sema pode usar palavras-chave de DSL em ASCII. A IA não deve copiar essa estét
 
 ## English
 
-Sema exists for AI agents operating live systems. The agent should ask Sema for summary, docs impact, drift, impact, profile validation, and finalization instead of guessing from raw code.
+Sema exists for AI agents operating live systems. The agent should ask Sema for preflight, summary, docs impact, drift, impact, profile validation, and finalization instead of guessing from raw code.
 
-In local IDEs, confirm `AGENTS.md` exists before `sema_resumo`. In web chats, use `sema_chat_contexto` first, then `sema_sync` or inline content. The MCP coordinates the flow and charges SEMAS; the CLI executes local or VPS-side checks.
+In local IDEs, confirm `AGENTS.md` exists, install the complete Sema CLI, run `sema preflight resumo --json`, and stop unless the decision is `use_cli_local`. Then use local CLI commands: `sema resumo`, `sema docs-impacto`, `sema inspecionar`, `sema drift`, `sema impacto`, `sema validar`, and `sema finalizar-mudanca`. Do not call remote MCP, `sema_sync`, `sema_contratos_sincronizar`, or `sema mcp-client` to read a local workspace.
+
+In web chats without workspace access, use `sema_chat_contexto` first, then `sema_sync` with contract, selected code, documentation, and index; then use the returned `projeto`. The CLI and MCP use the same commercial control plane and SEMAS account.
 
 ## Português
 
-A Sema existe para agentes de IA operarem sistemas vivos. O agente deve pedir resumo, impacto documental, drift, impacto, validação de profile e finalização para a Sema em vez de adivinhar pelo código cru.
+A Sema existe para agentes de IA operarem sistemas vivos. O agente deve pedir preflight, resumo, impacto documental, drift, impacto, validação de profile e finalização para a Sema em vez de adivinhar pelo código cru.
+
+Em IDE local, confirme que `AGENTS.md` existe, instale a CLI completa da Sema, rode `sema preflight resumo --json` e pare se a decisão não for `use_cli_local`. Depois use comandos locais da CLI: `sema resumo`, `sema docs-impacto`, `sema inspecionar`, `sema drift`, `sema impacto`, `sema validar` e `sema finalizar-mudanca`. Não chame MCP remoto, `sema_sync`, `sema_contratos_sincronizar` nem `sema mcp-client` para ler workspace local.
 
-Em IDE local, confirme que `AGENTS.md` existe antes de `sema_resumo`. Em chats web, use primeiro `sema_chat_contexto`, depois `sema_sync` ou conteúdo inline. O MCP coordena o fluxo e cobra SEMAS; a CLI executa checks locais ou na VPS.
+Em chats web sem acesso ao workspace, use primeiro `sema_chat_contexto`, depois `sema_sync` com contrato, código selecionado, documentação e índice; depois use o `projeto` retornado. CLI e MCP usam o mesmo control plane comercial e a mesma conta de SEMAS.
 
 ## Español
 
-Sema existe para agentes de IA que operan sistemas vivos. El agente debe pedir resumen, impacto documental, drift, impacto, validación de profile y finalización a Sema en vez de adivinar desde código crudo.
+Sema existe para agentes de IA que operan sistemas vivos. El agente debe pedir preflight, resumen, impacto documental, drift, impacto, validación de profile y finalización a Sema en vez de adivinar desde código crudo.
+
+En una IDE local, confirma que `AGENTS.md` existe, instala la CLI completa de Sema, ejecuta `sema preflight resumo --json` y para si la decisión no es `use_cli_local`. Después usa comandos locales de la CLI: `sema resumo`, `sema docs-impacto`, `sema inspecionar`, `sema drift`, `sema impacto`, `sema validar` y `sema finalizar-mudanca`. No llames el MCP remoto, `sema_sync`, `sema_contratos_sincronizar` ni `sema mcp-client` para leer un workspace local.
 
-En IDE local, confirma que `AGENTS.md` existe antes de `sema_resumo`. En chats web, usa primero `sema_chat_contexto`, después `sema_sync` o contenido inline. El MCP coordina el flujo y cobra SEMAS; la CLI ejecuta checks locales o en la VPS.
+En chats web sin acceso al workspace, usa primero `sema_chat_contexto`, después `sema_sync` con contrato, código seleccionado, documentación e índice; después usa el `projeto` devuelto. CLI y MCP usan el mismo control plane comercial y la misma cuenta de SEMAS.

package/docs/mcp.md

@@ -11,11 +11,11 @@ The Sema MCP is the private coordinator for agents. It authenticates clients, se
 
 It must stay compatible with web chats. For ChatGPT, Lovable, GPTs, and similar clients, the MCP runs on the VPS and uses the governed CLI installed there against authorized mirrors such as `/srv/sema/projetos/...`.
 
-It must also stay compatible with local IDEs. In that mode, the client sends typed snapshots: contracts, selected code, documentation, and an index. When complete local-code drift is required, the installed CLI may run in the IDE workspace.
+Local IDEs should not use remote MCP, `sema_sync`, `sema_contratos_sincronizar`, or `sema mcp-client` to read a local workspace. In that mode, install the complete Sema CLI, save the local key, run `sema preflight resumo --json`, and continue locally only when the decision is `use_cli_local`.
 
-The MCP must never pretend that a local Windows path exists on the Linux server. If the server cannot see the workspace, the next action is to request or create a mirror/snapshot.
+The MCP must never pretend that a local Windows path exists on the Linux server. If a local IDE asks the remote MCP to read that path, the next action is to use the local CLI. If a web/chat client has no workspace, the next action is to request or create a mirror/snapshot.
 
-The app or connector must recognize the remote MCP from connection/authentication even when no project workspace has been synchronized. Missing workspace is not a missing active session; it only means project work must use `sema_sync`, an attachment, or inline content. The remote MCP must not ask for or try to read the user's local folder.
+The app or connector must recognize the remote MCP from connection/authentication even when no project workspace has been synchronized. Missing workspace is not a missing active session. In web/chat, project work must use `sema_sync` with the applicable contract, selected code, documentation, and index. In a local IDE, project work must use CLI preflight and local CLI commands. The remote MCP must not ask for or try to read the user's local folder.
 
 Official Sema examples and grammar references must be exposed through `sema_exemplos`. Remote agents must not read `C:\GitHub\Sema\exemplos` or any other local user checkout just to learn the DSL.
 
@@ -31,11 +31,11 @@ O MCP da Sema é o coordenador privado dos agentes. Ele autentica clientes, esco
 
 Ele precisa continuar compatível com chats web. Para ChatGPT, Lovable, GPTs e clientes parecidos, o MCP roda na VPS e usa a CLI governada instalada lá contra espelhos autorizados como `/srv/sema/projetos/...`.
 
-Ele também precisa continuar compatível com IDEs locais. Nesse modo, o cliente envia snapshots tipados: contratos, código selecionado, documentação e índice. Quando drift completo contra código local for necessário, a CLI instalada pode rodar no workspace da IDE.
+IDEs locais não devem usar MCP remoto, `sema_sync`, `sema_contratos_sincronizar` nem `sema mcp-client` para ler workspace local. Nesse modo, instale a CLI completa da Sema, grave a chave local, rode `sema preflight resumo --json` e continue localmente somente quando a decisão for `use_cli_local`.
 
-O MCP nunca deve fingir que um caminho Windows local existe no servidor Linux. Se o servidor não enxerga o workspace, a próxima ação é pedir ou criar um espelho/snapshot.
+O MCP nunca deve fingir que um caminho Windows local existe no servidor Linux. Se uma IDE local pedir ao MCP remoto para ler esse caminho, a próxima ação é usar a CLI local. Se um cliente web/chat não tiver workspace, a próxima ação é pedir ou criar um espelho/snapshot.
 
-O app ou conector deve reconhecer o MCP remoto pela conexao/autenticacao, mesmo sem workspace de projeto sincronizado. Falta de workspace nao e falta de sessao ativa: e apenas o sinal de que a proxima acao de projeto deve usar `sema_sync`, anexo ou conteudo inline. O MCP remoto nao deve pedir nem tentar ler a pasta local do usuario.
+O app ou conector deve reconhecer o MCP remoto pela conexão/autenticação, mesmo sem workspace de projeto sincronizado. Falta de workspace não é falta de sessão ativa. Em web/chat, trabalho de projeto deve usar `sema_sync` com contrato aplicável, código selecionado, documentação e índice. Em IDE local, trabalho de projeto deve usar preflight e comandos locais da CLI. O MCP remoto não deve pedir nem tentar ler a pasta local do usuário.
 
 Exemplos oficiais da Sema e referencias de gramatica devem ser expostos por `sema_exemplos`. Agentes remotos nao devem ler `C:\GitHub\Sema\exemplos` nem qualquer checkout local do usuario so para aprender a DSL.
 
@@ -51,11 +51,11 @@ El MCP de Sema es el coordinador privado de los agentes. Autentica clientes, eli
 
 Debe seguir compatible con chats web. Para ChatGPT, Lovable, GPTs y clientes similares, el MCP corre en la VPS y usa la CLI gobernada instalada allí contra espejos autorizados como `/srv/sema/projetos/...`.
 
-También debe seguir compatible con IDEs locales. En ese modo, el cliente envía snapshots tipados: contratos, código seleccionado, documentación e índice. Cuando haga falta drift completo contra código local, la CLI instalada puede correr en el workspace de la IDE.
+Las IDEs locales no deben usar el MCP remoto, `sema_sync`, `sema_contratos_sincronizar` ni `sema mcp-client` para leer un workspace local. En ese modo, instala la CLI completa de Sema, guarda la clave local, ejecuta `sema preflight resumo --json` y continúa localmente solo cuando la decisión sea `use_cli_local`.
 
-El MCP nunca debe fingir que una ruta local de Windows existe en el servidor Linux. Si el servidor no ve el workspace, la siguiente acción es pedir o crear un espejo/snapshot.
+El MCP nunca debe fingir que una ruta local de Windows existe en el servidor Linux. Si una IDE local pide al MCP remoto leer esa ruta, la siguiente acción es usar la CLI local. Si un cliente web/chat no tiene workspace, la siguiente acción es pedir o crear un espejo/snapshot.
 
-La app o el conector debe reconocer el MCP remoto por conexion/autenticacion, incluso sin workspace de proyecto sincronizado. Falta de workspace no es falta de sesion activa: solo indica que el trabajo de proyecto debe usar `sema_sync`, un adjunto o contenido inline. El MCP remoto no debe pedir ni intentar leer la carpeta local del usuario.
+La app o el conector debe reconocer el MCP remoto por conexión/autenticación, incluso sin workspace de proyecto sincronizado. Falta de workspace no es falta de sesión activa. En web/chat, el trabajo de proyecto debe usar `sema_sync` con contrato aplicable, código seleccionado, documentación e índice. En una IDE local, el trabajo de proyecto debe usar preflight y comandos locales de la CLI. El MCP remoto no debe pedir ni intentar leer la carpeta local del usuario.
 
 Los ejemplos oficiales de Sema y las referencias de gramatica deben exponerse mediante `sema_exemplos`. Los agentes remotos no deben leer `C:\GitHub\Sema\exemplos` ni ningun checkout local del usuario solo para aprender la DSL.