@semacode/cli 1.5.39 → 1.5.41

package/dist/profileI18nCatalogo.js

@@ -0,0 +1,92 @@
+// SEMA-GOVERNED: sema.produto.governanca_ia.qualidade_contrato
+// Descricao: catalogo de termos i18n por idioma para validacao observavel de texto visivel.
+export const VALIDADORES_I18N = {
+    "pt-BR": {
+        idioma: "pt-BR",
+        nome: "Portugues do Brasil",
+        termos: [
+            { regex: /\bDescricao\b/i, esperado: "Descrição" },
+            { regex: /\bDescricoes\b/i, esperado: "Descrições" },
+            { regex: /\bAcao\b/i, esperado: "Ação" },
+            { regex: /\bAcoes\b/i, esperado: "Ações" },
+            { regex: /\bAtencao\b/i, esperado: "Atenção" },
+            { regex: /\bConfiguracao\b/i, esperado: "Configuração" },
+            { regex: /\bInformacao\b/i, esperado: "Informação" },
+            { regex: /\bInformacoes\b/i, esperado: "Informações" },
+            { regex: /\bEducacao\b/i, esperado: "Educação" },
+            { regex: /\bSaude\b/i, esperado: "Saúde" },
+            { regex: /\bAlimentacao\b/i, esperado: "Alimentação" },
+            { regex: /\bOnibus\b/i, esperado: "Ônibus" },
+            { regex: /\balmoco\b/i, esperado: "almoço" },
+            { regex: /\brapido\b/i, esperado: "rápido" },
+            { regex: /\brapida\b/i, esperado: "rápida" },
+            { regex: /\bnumero\b/i, esperado: "número" },
+            { regex: /\binvalido\b/i, esperado: "inválido" },
+            { regex: /\binvalida\b/i, esperado: "inválida" },
+            { regex: /\bobrigatorio\b/i, esperado: "obrigatório" },
+            { regex: /\bobrigatoria\b/i, esperado: "obrigatória" },
+            { regex: /\busuario\b/i, esperado: "usuário" },
+            { regex: /\busuarios\b/i, esperado: "usuários" },
+            { regex: /\bcartao\b/i, esperado: "cartão" },
+            { regex: /\bcredito\b/i, esperado: "crédito" },
+            { regex: /\bdebito\b/i, esperado: "débito" },
+            { regex: /\bvalidacao\b/i, esperado: "validação" },
+            { regex: /\bexclusao\b/i, esperado: "exclusão" },
+            { regex: /\bhistorico\b/i, esperado: "histórico" },
+            { regex: /\bVoce\b/i, esperado: "Você" },
+            { regex: /\bvoce\b/i, esperado: "você" },
+            { regex: /\bNao\b/i, esperado: "Não" },
+            { regex: /\bnao\b/i, esperado: "não" },
+            { regex: /\bJa\b/i, esperado: "Já" },
+            { regex: /\bja\b/i, esperado: "já" },
+            { regex: /\bAte\b/i, esperado: "Até" },
+            { regex: /\bate\b/i, esperado: "até" },
+            { regex: /\bProximo\b/i, esperado: "Próximo" },
+            { regex: /\bproximo\b/i, esperado: "próximo" },
+        ],
+    },
+    es: {
+        idioma: "es",
+        nome: "Espanhol",
+        termos: [
+            { regex: /\bDescripcion\b/i, esperado: "Descripción" },
+            { regex: /\bAccion\b/i, esperado: "Acción" },
+            { regex: /\bAcciones\b/i, esperado: "Acciones" },
+            { regex: /\bAtencion\b/i, esperado: "Atención" },
+            { regex: /\bConfiguracion\b/i, esperado: "Configuración" },
+            { regex: /\bInformacion\b/i, esperado: "Información" },
+            { regex: /\bEducacion\b/i, esperado: "Educación" },
+            { regex: /\brapido\b/i, esperado: "rápido" },
+            { regex: /\brapida\b/i, esperado: "rápida" },
+            { regex: /\bnumero\b/i, esperado: "número" },
+            { regex: /\binvalido\b/i, esperado: "inválido" },
+            { regex: /\binvalida\b/i, esperado: "inválida" },
+            { regex: /\bobligacion\b/i, esperado: "obligación" },
+            { regex: /\bcredito\b/i, esperado: "crédito" },
+            { regex: /\bdebito\b/i, esperado: "débito" },
+            { regex: /\btelefono\b/i, esperado: "teléfono" },
+            { regex: /\bproximo\b/i, esperado: "próximo" },
+            { regex: /\bTambien\b/i, esperado: "También" },
+            { regex: /\btambien\b/i, esperado: "también" },
+        ],
+    },
+    fr: {
+        idioma: "fr",
+        nome: "Frances",
+        termos: [
+            { regex: /\bResume\b/i, esperado: "Résumé" },
+            { regex: /\bresume\b/i, esperado: "résumé" },
+            { regex: /\btelephone\b/i, esperado: "téléphone" },
+            { regex: /\bnumero\b/i, esperado: "numéro" },
+            { regex: /\bdeja\b/i, esperado: "déjà" },
+            { regex: /\becole\b/i, esperado: "école" },
+            { regex: /\beleve\b/i, esperado: "élève" },
+            { regex: /\bfrancais\b/i, esperado: "français" },
+            { regex: /\bFrancais\b/i, esperado: "Français" },
+            { regex: /\baout\b/i, esperado: "août" },
+            { regex: /\bNoel\b/i, esperado: "Noël" },
+            { regex: /\bNoe?l\b/i, esperado: "Noël" },
+        ],
+    },
+};
+//# sourceMappingURL=profileI18nCatalogo.js.map

package/dist/profileI18nCatalogo.js.map

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

package/dist/profileI18nVisivel.d.ts

@@ -0,0 +1,11 @@
+import { type IdiomaI18nSuportado } from "./profileI18nCatalogo.js";
+import type { AchadoProfile, MaturidadeProfile } from "./profileAuthorTipos.js";
+interface EscopoI18nObservavel {
+    ativo: boolean;
+    idiomaNaoDeclarado: boolean;
+    idiomas: IdiomaI18nSuportado[];
+    idiomasSemValidador: string[];
+}
+export declare function detectarEscopoI18nObservavel(contrato: string): EscopoI18nObservavel;
+export declare function avaliarI18nVisivelArtefato(contrato: string, artefato: string, maturidade: MaturidadeProfile): AchadoProfile[];
+export {};

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/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. If it does not exist, download `https://sema.otimitare.online/AGENTS.md` into the project. Then call `sema_resumo`. If the remote MCP cannot read the local path, call `sema_sync` with the applicable `.sema` contract, affected files, operational docs, and an index; use the returned `projeto`; call `sema_resumo` again; inspect the contract; then run drift and impact. In web chats, do not download files into the chat environment; call `sema_chat_contexto` and then `sema_sync` with the same typed snapshot.
 
 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. Se não existir, baixe `https://sema.otimitare.online/AGENTS.md` para o projeto. Depois chame `sema_resumo`. Se o MCP remoto não conseguir ler o caminho local, chame `sema_sync` com o contrato `.sema` aplicável, arquivos afetados, docs operacionais e índice; use o `projeto` retornado; chame `sema_resumo` de novo; inspecione o contrato; então rode drift e impacto. Em chats web, não baixe arquivos no ambiente do chat; chame `sema_chat_contexto` e depois `sema_sync` com o mesmo snapshot tipado.
 
 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 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. Después llama `sema_resumo`. Si el MCP remoto no puede leer la ruta local, llama `sema_sync` con el contrato `.sema` aplicable, archivos afectados, docs operativas e índice; usa el `projeto` devuelto; llama `sema_resumo` otra vez; inspecciona el contrato; después ejecuta drift e impacto. En chats web, no descargues archivos en el entorno del chat; llama `sema_chat_contexto` y después `sema_sync` con el mismo snapshot tipado.
 
 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/documentacao.md

@@ -20,8 +20,10 @@ The `docs-impacto` result returns:
 
 - `leituraObrigatoria`: docs, readmes, and contracts that must be read.
 - `docsAusentes`: docs that block the action.
-- `docsCriadas`: docs created automatically when authorized.
-- `bloqueios`: severity 4 diagnostics.
+- `docsCriadas`: docs created automatically when authorized.
+- `bloqueios`: severity 4 diagnostics.
+
+Automatically created docs are scaffolds, not proof. The agent must replace the generic template with real procedure, validation, and rollback before `finalizar-mudanca` can pass.
 
 Before declaring the work done, the agent must run:
 
@@ -49,8 +51,10 @@ O resultado de `docs-impacto` retorna:
 
 - `leituraObrigatoria`: docs, readmes e contratos que precisam ser lidos.
 - `docsAusentes`: docs que bloqueiam a ação.
-- `docsCriadas`: docs criadas automaticamente quando autorizado.
-- `bloqueios`: diagnósticos de severidade 4.
+- `docsCriadas`: docs criadas automaticamente quando autorizado.
+- `bloqueios`: diagnósticos de severidade 4.
+
+Docs criadas automaticamente são esqueletos, não prova. A IA precisa trocar o template genérico por procedimento, validação e rollback reais antes de `finalizar-mudanca` passar.
 
 Antes de dizer que o trabalho terminou, o agente precisa rodar:
 
@@ -78,8 +82,10 @@ El resultado de `docs-impacto` devuelve:
 
 - `leituraObrigatoria`: docs, readmes y contratos que deben leerse.
 - `docsAusentes`: docs que bloquean la acción.
-- `docsCriadas`: docs creadas automáticamente cuando se autoriza.
-- `bloqueios`: diagnósticos de severidad 4.
+- `docsCriadas`: docs creadas automáticamente cuando se autoriza.
+- `bloqueios`: diagnósticos de severidad 4.
+
+Los documentos creados automáticamente son esqueletos, no prueba. El agente debe reemplazar el template genérico con procedimiento, validación y rollback reales antes de que `finalizar-mudanca` pueda aprobar.
 
 Antes de decir que el trabajo terminó, el agente debe ejecutar:
 

package/docs/integracao-com-ia.md

@@ -23,16 +23,16 @@ Sema pode usar palavras-chave de DSL em ASCII. A IA não deve copiar essa estét
 
 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.
 
-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 before `sema_resumo`. If the remote MCP cannot read the local path, call `sema_sync` with the applicable contract, selected code, documentation, and index; then use the returned `projeto`. In web chats, use `sema_chat_contexto` first, then `sema_sync` with the same typed snapshot. The MCP coordinates the flow and charges SEMAS; the CLI executes local or VPS-side checks.
 
 ## 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.
 
-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 IDE local, confirme que `AGENTS.md` existe antes de `sema_resumo`. Se o MCP remoto não conseguir ler o caminho local, chame `sema_sync` com contrato aplicável, código selecionado, documentação e índice; depois use o `projeto` retornado. Em chats web, use primeiro `sema_chat_contexto`, depois `sema_sync` com o mesmo snapshot tipado. O MCP coordena o fluxo e cobra SEMAS; a CLI executa checks locais ou na VPS.
 
 ## 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.
 
-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 IDE local, confirma que `AGENTS.md` existe antes de `sema_resumo`. Si el MCP remoto no puede leer la ruta local, llama `sema_sync` con contrato aplicable, código seleccionado, documentación e índice; después usa el `projeto` devuelto. En chats web, usa primero `sema_chat_contexto`, después `sema_sync` con el mismo snapshot tipado. El MCP coordina el flujo y cobra SEMAS; la CLI ejecuta checks locales o en la VPS.

package/docs/mcp.md

@@ -15,7 +15,7 @@ It must also stay compatible with local IDEs. In that mode, the client sends typ
 
 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 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; it means project work must use `sema_sync` with the applicable contract, selected code, documentation, and index. 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.
 
@@ -35,7 +35,7 @@ Ele também precisa continuar compatível com IDEs locais. Nesse modo, o cliente
 
 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 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: é o sinal de que a próxima ação de projeto deve usar `sema_sync` com contrato aplicável, código selecionado, documentação e índice. 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.
 
@@ -55,7 +55,7 @@ También debe seguir compatible con IDEs locales. En ese modo, el cliente envía
 
 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.
 
-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: indica que la siguiente acción de proyecto debe usar `sema_sync` con contrato aplicable, código seleccionado, documentación e índice. 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.
 

package/node_modules/@sema/gerador-css/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema/gerador-css",
-  "version": "1.5.39",
+  "version": "1.5.41",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts"

package/node_modules/@sema/gerador-dart/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema/gerador-dart",
-  "version": "1.5.39",
+  "version": "1.5.41",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts"

package/node_modules/@sema/gerador-html/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema/gerador-html",
-  "version": "1.5.39",
+  "version": "1.5.41",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts"

package/node_modules/@sema/gerador-javascript/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema/gerador-javascript",
-  "version": "1.5.39",
+  "version": "1.5.41",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts"

package/node_modules/@sema/gerador-lua/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema/gerador-lua",
-  "version": "1.5.39",
+  "version": "1.5.41",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts"

package/node_modules/@sema/gerador-python/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema/gerador-python",
-  "version": "1.5.39",
+  "version": "1.5.41",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts"

package/node_modules/@sema/gerador-typescript/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema/gerador-typescript",
-  "version": "1.5.39",
+  "version": "1.5.41",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts"

package/node_modules/@sema/nucleo/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema/nucleo",
-  "version": "1.5.39",
+  "version": "1.5.41",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts"

package/node_modules/@sema/padroes/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema/padroes",
-  "version": "1.5.39",
+  "version": "1.5.41",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@semacode/cli",
-  "version": "1.5.39",
+  "version": "1.5.41",
   "description": "Semantic governance CLI for AI agents: contracts, drift, impact, documentation gates, and Sema profiles for live systems.",
   "type": "module",
   "icon": "logo.png",
@@ -46,15 +46,15 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@sema/nucleo": "1.5.39",
-    "@sema/gerador-dart": "1.5.39",
-    "@sema/gerador-lua": "1.5.39",
-    "@sema/gerador-python": "1.5.39",
-    "@sema/gerador-typescript": "1.5.39",
-    "@sema/gerador-javascript": "1.5.39",
-    "@sema/gerador-html": "1.5.39",
-    "@sema/gerador-css": "1.5.39",
-    "@sema/padroes": "1.5.39",
+    "@sema/nucleo": "1.5.41",
+    "@sema/gerador-dart": "1.5.41",
+    "@sema/gerador-lua": "1.5.41",
+    "@sema/gerador-python": "1.5.41",
+    "@sema/gerador-typescript": "1.5.41",
+    "@sema/gerador-javascript": "1.5.41",
+    "@sema/gerador-html": "1.5.41",
+    "@sema/gerador-css": "1.5.41",
+    "@sema/padroes": "1.5.41",
     "typescript": "^5.8.3"
   },
   "bundledDependencies": [