@semacode/cli 1.5.47 → 1.5.52

package/LICENSE

@@ -1,21 +1,39 @@
-MIT License
-
-Copyright (c) 2026 Sema
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+Sema Public Non-Commercial License
+Version 1.0
+
+Copyright (c) 2026 Sema
+
+Official support: suporte@otimitare.online
+
+Permission is granted, free of charge, to use, copy, study, modify, and
+distribute this software and its documentation for personal, educational,
+research, internal business, and non-commercial purposes, subject to the terms
+below.
+
+You may:
+
+1. Use Sema locally as a CLI in your own projects.
+2. Study and modify the source code.
+3. Share unmodified or modified copies for non-commercial purposes.
+4. Publish patches, examples, documentation, and integrations that do not sell
+   Sema itself as a product or commercial replacement.
+
+You may not, without prior written permission from OtimiTare:
+
+1. Sell Sema, a modified Sema, or a substantially similar rebranded copy.
+2. Offer Sema, a modified Sema, or a substantially similar implementation as a
+   commercial replica or paid replacement.
+3. Bundle Sema into a paid product in a way that makes Sema itself a material
+   commercial feature.
+4. Use Sema's name, marks, documentation, or public repository to imply
+   endorsement by Sema or OtimiTare.
+5. Remove this license or the copyright notice from distributed copies.
+
+Commercial licensing, resale permission, or commercial replica permission
+requires written approval. Contact suporte@otimitare.online.
+
+This software is provided "as is", without warranty of any kind, express or
+implied, including but not limited to warranties of merchantability, fitness for
+a particular purpose, and non-infringement. In no event shall the authors or
+copyright holders be liable for any claim, damages, or other liability arising
+from the software or its use.

package/README.md

@@ -1,78 +1,77 @@
 # @semacode/cli
 
-`@semacode/cli` é o instalador/cliente npm da CLI governada da Sema.
+`@semacode/cli` is the public local CLI for Sema semantic governance.
 
-Em IDE local, a CLI é a superfície completa para acesso ao workspace. Ela não é
-o servidor MCP remoto, não é o painel e não é o controle comercial inteiro. Ela
-opera localmente, mas consulta a pré-checagem comercial antes de executar ações
-governadas.
+It validates `.sema` contracts, checks semantic drift, maps impact, enforces
+documentation gates, generates starter code, and prepares AI-first context for
+agents working inside a local project folder.
 
-## Instalação
+Official support: [suporte@otimitare.online](mailto:suporte@otimitare.online)
+
+## Install
 
 ```bash
 npm install -g @semacode/cli
 ```
 
-Em uso real, o humano deve preferir o instalador de chave do painel Sema. A IA
-não acessa o painel. Se `sema --version` falhar, a IA deve parar e pedir ao
-humano para instalar pelo painel.
-
-## Chave Local
+## First Run
 
 ```bash
-printf '%s' 'sema_mcp_...' | sema mcp-instalar-chave --stdin --json
+sema --version
+sema preflight resumo --json
+sema resumo . --curto
 ```
 
-O comando grava a chave comercial no ambiente local como
-`SEMA_CLI_AUTH_TOKEN`, grava `SEMA_CLI_CONTROL_PLANE_URL` quando informado e
-mantém variáveis MCP de compatibilidade sem receber segredo como argumento de
-linha de comando.
+Public Sema is local-only. The CLI does not require external service credentials,
+does not install service keys, and does not contact external services during
+`preflight`.
 
-## Fluxo Obrigatório Em IDE Local
+## Local Workflow
 
 ```bash
-sema --version
-sema preflight resumo --json
-sema resumo . --curto
-sema docs-impacto --intencao "alterar pedidos" --arquivo contratos/pedidos.sema --json
-sema inspecionar contratos/pedidos.sema --json
-sema drift contratos/pedidos.sema --escopo modulo --json
-sema impacto contratos/pedidos.sema --alvo app.pedidos --mudanca "alterar pedidos" --json
-sema finalizar-mudanca --intencao "alterar pedidos" --doc-lida README.md --json
+sema docs-impacto --intencao "describe the change" --arquivo contratos/app.sema --json
+sema inspecionar contratos/app.sema --json
+sema drift contratos/app.sema --escopo modulo --json
+sema impacto contratos/app.sema --alvo app.modulo --mudanca "describe the change" --json
+sema finalizar-mudanca --intencao "describe the change" --doc-lida README.md --json
 ```
 
-Se a decisão da pré-checagem não for `use_cli_local`, pare. Em workspace local,
-não chame MCP remoto, `sema_sync`, `sema_contratos_sincronizar` nem
-`sema mcp-client` só para ler a pasta local.
-
-## Geração De Código
+If the project has no `.sema` contract, create one before implementing behavior:
 
 ```bash
-sema compilar contratos/pedidos.sema --alvo typescript --saida .tmp/pedidos-ts --estrutura modulos
-sema compilar contratos/pedidos.sema --alvo python --saida .tmp/pedidos-py --estrutura modulos
+sema iniciar --template base
 ```
 
-A geração cria código com cabeçalho `SEMA-GOVERNED`, tipos/estruturas de entrada
-e saída, validações, garantias, erros e testes derivados do contrato.
+## Code Generation
+
+```bash
+sema compilar contratos/app.sema --alvo typescript --saida .tmp/app-ts --estrutura modulos
+sema compilar contratos/app.sema --alvo python --saida .tmp/app-py --estrutura modulos
+```
 
-Alvos suportados pelo projeto incluem `typescript`, `python`, `dart`, `lua`,
-`javascript`, `html` e `css`. Estruturas e frameworks como `modulos`, `backend`,
-`nestjs` e `fastapi` podem ser usados quando aplicáveis.
+Generated artifacts include `SEMA-GOVERNED` headers and must stay aligned with
+the source contract.
 
-## Verificação
+## Validation
 
 ```bash
-sema validar contratos/pedidos.sema --json
-sema diagnosticos contratos/pedidos.sema --json
-sema testar contratos/pedidos.sema --alvo typescript --saida .tmp/teste-pedidos
-sema verificar contratos/pedidos.sema --saida .tmp/verificacao-pedidos --json
+sema validar contratos/app.sema --json
+sema diagnosticos contratos/app.sema --json
+sema testar contratos/app.sema --alvo typescript --saida .tmp/app-tests
+sema verificar contratos/app.sema --saida .tmp/app-check --json
 ```
 
-## Runner Remoto
+## Public Boundary
+
+The npm package is for local CLI usage only. It must not contain private or
+sensitive operational material.
+
+## Commercial Use
+
+Sema is public source for local semantic governance, but commercial resale,
+white-label redistribution, or commercial replicas require written permission
+from OtimiTare.
 
-`sema runner servidor` só pode rodar sem token em host local. Bind público exige
-`--token` ou `SEMA_RUNNER_TOKEN`.
+## Support
 
-O runner remoto existe para snapshots controlados e validação em ambiente
-isolado. Ele não é desculpa para enviar workspace local inteiro sem filtro nem
-para vazar segredo.
+Use [suporte@otimitare.online](mailto:suporte@otimitare.online) for support.

package/dist/agentContext.d.ts

@@ -1,7 +1,7 @@
 import { type GuiaCapacidadeIaMap } from './agentContextTipos.js';
 export declare function criarEntradaCanonicaProjeto(guiaPorCapacidade: GuiaCapacidadeIaMap): {
     descricao: string;
-    ordemLeitura: ("SEMA_BOOT.md" | "SEMA_SMALL_MODEL.md" | "AGENT_CONTEXT_PACK.json" | "llms.txt" | "SEMA_BRIEF.md" | "SEMA_INDEX.json" | "AGENTS.md" | "README.md" | "llms-full.txt")[];
+    ordemLeitura: ("SEMA_BOOT.md" | "llms.txt" | "AGENT_CONTEXT_PACK.json" | "SEMA_SMALL_MODEL.md" | "SEMA_BRIEF.md" | "SEMA_INDEX.json" | "AGENTS.md" | "README.md" | "llms-full.txt")[];
     porCapacidade: {
         fraca: string[];
         pequena: string[];
@@ -13,7 +13,7 @@ export declare function criarEntradaCanonicaProjeto(guiaPorCapacidade: GuiaCapac
         pequena: import("./agentContextTipos.js").CapacidadeIa;
         grande: import("./agentContextTipos.js").CapacidadeIa;
     };
-    docsSuporte: ("docs/agentes-por-capacidade.md" | "docs/AGENT_STARTER.md" | "docs/integracao-com-ia.md" | "docs/fluxo-pratico-ia-sema.md" | "docs/como-ensinar-a-sema-para-ia.md" | "docs/persistencia-vendor-first.md" | "docs/sintaxe.md" | "docs/cli.md" | "docs/comandos.md" | "docs/mcp.md" | "docs/profiles.md" | "docs/profiles-author-agents-flow.md" | "docs/testes.md" | "docs/documentacao.md" | "docs/deploy.md" | "docs/env.md" | "docs/rollback.md" | "docs/extensao-vscode.md")[];
+    docsSuporte: ("docs/ai-integration.md" | "docs/ai-workflow.md" | "docs/ai-onboarding.md" | "docs/syntax.md" | "docs/cli.md" | "docs/commands.md" | "docs/profiles.md" | "docs/testing.md" | "docs/documentation.md" | "docs/deploy.md" | "docs/env.md" | "docs/rollback.md")[];
     agentContextPack: import("./agentContextTipos.js").AgentContextPack;
     guiaPorCapacidade: GuiaCapacidadeIaMap;
 };

package/dist/agentContext.js

@@ -8,7 +8,7 @@ export function criarEntradaCanonicaProjeto(guiaPorCapacidade) {
     const media = [ARQUIVO_SEMA_BOOT, 'llms.txt', ARQUIVO_AGENT_CONTEXT_PACK, 'SEMA_BRIEF.curto.txt', 'SEMA_INDEX.json', 'AGENTS.md', 'README.md'];
     const forte = [ARQUIVO_SEMA_BOOT, 'llms-full.txt', ARQUIVO_AGENT_CONTEXT_PACK, 'SEMA_BRIEF.md', 'SEMA_INDEX.json', 'AGENTS.md', 'README.md'];
     return {
-        descricao: 'Entrada can?nica do reposit?rio para IA. O repo n?o ? human-first; a IA deve come?ar por esses artefatos antes de abrir c?digo cru.',
+        descricao: 'Entrada canônica do repositório para IA. O repo não é human-first; a IA deve começar por esses artefatos antes de abrir código cru.',
         ordemLeitura: [...ARQUIVOS_CANONICOS_IA_RAIZ],
         porCapacidade: {
             fraca,

package/dist/agentContextPack.d.ts

@@ -1,4 +1,4 @@
 import { type AgentContextPack, type GuiaCapacidadeIaMap } from './agentContextTipos.js';
-export declare const LIMITE_CARACTERES_PAYLOAD_INLINE_MCP = 262144;
+export declare const LIMITE_CARACTERES_PAYLOAD_INLINE = 262144;
 export declare function criarGuiaCapacidadeIa(): GuiaCapacidadeIaMap;
 export declare function criarAgentContextPack(guiaPorCapacidade: GuiaCapacidadeIaMap): AgentContextPack;

package/dist/agentContextPack.js

@@ -1,8 +1,8 @@
-// SEMA-GOVERNED: sema.produto.governanca_ia.contexto
+// SEMA-GOVERNED: sema.produto.governanca_ia.contexto.agent_pack
 // Descrição: monta o Agent Context Pack e políticas que agentes fracos, médios e fortes consomem antes do código.
-import { LIMITE_AVISO_LINHAS_ORCAMENTO_SEMANTICO, LIMITE_BLOQUEIO_LINHAS_ORCAMENTO_SEMANTICO, } from './driftOrcamento.js';
+import { LIMITE_AVISO_LINHAS_CODIGO_GOVERNADO, LIMITE_AVISO_LINHAS_CONTRATO_SEMA, LIMITE_BLOQUEIO_LINHAS_CODIGO_GOVERNADO, LIMITE_BLOQUEIO_LINHAS_CONTRATO_SEMA, } from './driftOrcamento.js';
 import { ALIASES_CAPACIDADE_IA, ARQUIVO_AGENT_CONTEXT_PACK, ARQUIVO_DOC_AGENTES_CAPACIDADE, ARQUIVO_SEMA_BOOT, ARQUIVO_SEMA_SMALL_MODEL, EXEMPLOS_OFICIAIS_AGENT_CONTEXT, } from './agentContextTipos.js';
-export const LIMITE_CARACTERES_PAYLOAD_INLINE_MCP = 262144;
+export const LIMITE_CARACTERES_PAYLOAD_INLINE = 262144;
 export function criarGuiaCapacidadeIa() {
     const fraca = {
         descricao: "IA fraca, gratuita, local pequena ou com disciplina baixa. Leia o boot card, pare cedo e chame Sema antes de agir.",
@@ -42,12 +42,12 @@ function criarPoliticaIdiomaAgentContext() {
 function criarPoliticaCodigoGovernadoAgentContext() {
     return {
         marcador: "SEMA-GOVERNED",
-        regra: `Arquivos de código gerados ou governados pela Sema devem manter um cabeçalho curto com módulo de origem, lembrete para consultar o contrato .sema e descrição humana no idioma do usuário. Validação inline prova apenas o payload enviado; o arquivo físico sincronizado ainda precisa de SEMA-GOVERNED para orientar a próxima IA. Código e contrato governados acima de ${LIMITE_AVISO_LINHAS_ORCAMENTO_SEMANTICO} linhas geram diagnóstico de refatoração; acima de ${LIMITE_BLOQUEIO_LINHAS_ORCAMENTO_SEMANTICO} linhas bloqueiam drift, finalização, geração e snapshot. Documentação Markdown não entra nesse limite de código; continua governada por docs-impacto, limite de bytes e verificação de segredos. Payload inline MCP acima de ${LIMITE_CARACTERES_PAYLOAD_INLINE_MCP} caracteres não é caso de aumentar timeout: divida por responsabilidade ou use anexo/caminho de servidor autorizado. O limite exige divisão por responsabilidade real, não fatiamento artificial como index_p1.html, index_p2.html só para passar no gate.`,
+        regra: `Arquivos de codigo gerados ou governados pela Sema devem manter cabecalho curto com modulo de origem, contrato .sema aplicavel e descricao humana. Validacao inline prova apenas o payload enviado; o arquivo fisico ainda precisa de SEMA-GOVERNED para orientar a proxima IA. Codigo governado avisa acima de ${LIMITE_AVISO_LINHAS_CODIGO_GOVERNADO} linhas e bloqueia acima de ${LIMITE_BLOQUEIO_LINHAS_CODIGO_GOVERNADO}. Contrato .sema avisa acima de ${LIMITE_AVISO_LINHAS_CONTRATO_SEMA} linhas e bloqueia criacao, edicao, drift, finalizacao, geracao e snapshot acima de ${LIMITE_BLOQUEIO_LINHAS_CONTRATO_SEMA}. O split de .sema deve ser por dominio/capacidade, nunca parte_1/parte_2; varios contratos podem governar o mesmo arquivo de codigo via vinculos. Sema Codigo deve preservar essa rastreabilidade em cabecalhos e saidas geradas. Documentacao Markdown nao entra nesse limite de codigo; continua governada por docs-impacto, limite de bytes e verificacao de segredos. Payload inline acima de ${LIMITE_CARACTERES_PAYLOAD_INLINE} caracteres nao e caso de aumentar timeout: divida por responsabilidade ou use anexo/caminho de servidor autorizado.`,
         descricaoHumana: "O comentário deve orientar humanos e IAs sem duplicar o contrato inteiro dentro do código: diga o que o arquivo implementa, qual contrato governa e onde a próxima IA deve olhar.",
         porCapacidade: {
-            fraca: `Se abrir código com SEMA-GOVERNED, pare, leia SEMA_SMALL_MODEL.md e chame Sema antes de editar. Não crie código ou contrato governado acima de ${LIMITE_BLOQUEIO_LINHAS_ORCAMENTO_SEMANTICO} linhas nem envie payload inline acima de ${LIMITE_CARACTERES_PAYLOAD_INLINE_MCP} caracteres; divida antes por responsabilidade, nunca em partes p1/p2 sem sentido.`,
-            media: `Se abrir código com SEMA-GOVERNED, rode docs-impacto e drift antes de alterar comportamento. Trate ${LIMITE_AVISO_LINHAS_ORCAMENTO_SEMANTICO}+ linhas em código ou contrato governado como refatoração provável; se o payload inline passar de ${LIMITE_CARACTERES_PAYLOAD_INLINE_MCP} caracteres, separe HTML, estilos, estado, renderização, cálculo e dados antes de sincronizar.`,
-            forte: `Se abrir código com SEMA-GOVERNED, pode inspecionar AST/IR e código completo, mas mantém contrato primeiro, drift, orçamento governado de ${LIMITE_BLOQUEIO_LINHAS_ORCAMENTO_SEMANTICO} linhas e finalizar-mudanca. Contexto grande não autoriza monólito nem payload inline acima de ${LIMITE_CARACTERES_PAYLOAD_INLINE_MCP} caracteres.`,
+            fraca: `Se abrir codigo com SEMA-GOVERNED, pare, leia SEMA_SMALL_MODEL.md e chame Sema antes de editar. Nao crie codigo acima de ${LIMITE_BLOQUEIO_LINHAS_CODIGO_GOVERNADO} linhas nem contrato .sema acima de ${LIMITE_BLOQUEIO_LINHAS_CONTRATO_SEMA}; divida .sema por capacidade, nunca em parte_1/parte_2.`,
+            media: `Se abrir codigo com SEMA-GOVERNED, rode docs-impacto e drift antes de alterar comportamento. Trate codigo ${LIMITE_AVISO_LINHAS_CODIGO_GOVERNADO}+ e contrato .sema ${LIMITE_AVISO_LINHAS_CONTRATO_SEMA}+ como refatoracao provavel; se o payload inline passar de ${LIMITE_CARACTERES_PAYLOAD_INLINE} caracteres, separe HTML, estilos, estado, renderizacao, calculo e dados antes de sincronizar.`,
+            forte: `Se abrir codigo com SEMA-GOVERNED, pode inspecionar AST/IR e codigo completo, mas mantem contrato primeiro, drift, codigo ate ${LIMITE_BLOQUEIO_LINHAS_CODIGO_GOVERNADO}, .sema ate ${LIMITE_BLOQUEIO_LINHAS_CONTRATO_SEMA} e finalizar-mudanca. Contexto grande nao autoriza monolito nem payload inline acima de ${LIMITE_CARACTERES_PAYLOAD_INLINE} caracteres.`,
         },
         formatosPorAlvo: {
             typescript: "// SEMA-GOVERNED",
@@ -76,9 +76,9 @@ function criarPoliticaTimeoutResumoAgentContext() {
 }
 function criarPoliticaDesignVisualAgentContext() {
     return {
-        regra: "Quando a tarefa envolve interface, app, site, dashboard, painel, formulário, landing, jogo ou artefato visual, o Sema governa também qualidade visual. Modernidade, identidade, responsividade, estados e evidência visual não são extras opcionais.",
+        regra: "Quando a tarefa envolve site, sistema, app, interface, dashboard, painel, formulário, landing, jogo, terminal, CLI/TUI ou qualquer artefato voltado ao usuário, o Sema governa também acabamento, modernidade e adequação ao domínio. Beleza funcional, identidade, criatividade útil, tecnologia adequada, estados, responsividade e evidência não são extras opcionais.",
         modernoObrigatorio: true,
-        aplicarQuando: "site, app, dashboard, painel, admin, onboarding, formulário, modal, jogo, material visual ou qualquer entrega com UI.",
+        aplicarQuando: "site, sistema, app, dashboard, painel, admin, onboarding, formulário, modal, jogo, material visual, CLI, TUI, terminal, relatório interativo ou qualquer entrega com experiência de uso.",
         proibicoes: [
             "interface_generica_2010",
             "formularios_sem_hierarquia_visual",
@@ -87,38 +87,59 @@ function criarPoliticaDesignVisualAgentContext() {
             "texto_estourando_ou_sobreposto",
             "sem_estados_de_hover_focus_loading_erro_vazio",
             "sem_assets_quando_o_dominio_pede_visual",
+            "mesma_estetica_para_dominios_diferentes",
+            "painel_agrono_com_cara_de_ecommerce_generico",
+            "terminal_sem_hierarquia_status_ou_feedback",
+            "ignorar_bibliotecas_atuais_quando_disponiveis",
+            "efeitos_gratuitos_sem_proposito",
             "copiar_estetica_do_contrato_para_ui",
+            "declarar_responsivo_sem_prova_mobile",
+            "fechar_ui_com_scrollwidth_maior_que_clientwidth",
         ],
         porCapacidade: {
-            fraca: "Use um padrão moderno seguro: hierarquia clara, espaçamento consistente, paleta com contraste, estados básicos, responsivo mobile/desktop e nada de formulário cinza genérico. Se não conseguir validar visualmente, pare e peça revisão.",
-            media: "Defina intenção visual antes de codar: público, domínio, densidade, tokens, componentes, estados, responsividade e anti-2010. Rode ou peça screenshot/browser check quando houver UI.",
-            forte: "Crie direção visual específica do domínio, use assets reais/gerados quando fizer sentido, refine microinterações e faça verificação visual em desktop/mobile com screenshot e correção de overlap.",
+            fraca: "Use um padrão moderno seguro e contextual: hierarquia clara, espaçamento consistente, paleta com contraste, componentes coerentes com o domínio, estados básicos, responsivo mobile/desktop e nada de formulário cinza genérico. Em terminal, entregue saída organizada com status e erro claros. Se não conseguir validar o resultado, pare e peça revisão.",
+            media: "Defina intenção de experiência antes de codar: público, domínio, workflow real, densidade, tokens, componentes, tecnologia/biblioteca/efeitos adequados, estados, responsividade e anti-2010. O domínio manda na solução: agro, finanças, saúde, game e e-commerce não podem compartilhar a mesma casca. Rode ou peça screenshot/browser check quando houver UI e smoke check quando for terminal.",
+            forte: "Crie direção específica e ambiciosa do domínio, use bibliotecas, APIs, assets, microinterações e efeitos atuais quando fizerem sentido, refine o fluxo principal até parecer produto real e faça verificação visual/terminal com evidência. Inovação precisa servir ao uso, não virar enfeite.",
         },
         evidencias: {
             fraca: [
                 "descrever padrão visual escolhido",
+                "explicar como o domínio aparece na interface ou terminal",
                 "confirmar responsividade básica",
+                "provar mobile sem overflow horizontal com scrollWidth <= clientWidth",
                 "listar estados essenciais",
             ],
             media: [
                 "registrar tokens e componentes usados",
+                "registrar bibliotecas, APIs ou efeitos escolhidos e por que combinam com o pedido",
                 "validar desktop e mobile",
+                "testar viewport estreito como 390px sem scroll horizontal",
                 "corrigir texto sobreposto",
+                "rodar smoke check de CLI/TUI quando aplicável",
             ],
             forte: [
                 "screenshot desktop/mobile",
+                "browser check com scrollWidth <= clientWidth em desktop/mobile",
                 "verificação de assets e renderização",
                 "auditoria de contraste, hierarquia e estado vazio",
+                "evidência de fluxo principal polido",
+                "evidência de saída terminal com status, erro e ajuda quando aplicável",
             ],
         },
         criteriosMinimos: [
             "não parecer template de 2010",
+            "não reciclar a mesma estética para domínios diferentes",
+            "domínio e público moldam layout, linguagem, componentes e interação",
             "hierarquia visual clara",
             "paleta com contraste e identidade do domínio",
+            "tecnologia, biblioteca ou efeito escolhido combina com pedido e stack existente",
             "responsividade mobile e desktop",
+            "evidencia mobile sem overflow horizontal (scrollWidth <= clientWidth)",
             "estados de hover, focus, loading, erro e vazio quando aplicáveis",
             "texto sem overlap ou estouro",
+            "texto visivel com acentos e cedilha quando o idioma exigir",
             "componentes coerentes com o workflow real",
+            "terminal/CLI com hierarquia, status, erro, ajuda e confirmações quando aplicável",
         ],
     };
 }
@@ -197,20 +218,24 @@ function criarFailClosedAgentContext() {
     return [
         "Se não conseguir chamar Sema, pare e declare bloqueio em vez de editar código ou contrato.",
         "Se não houver contrato aplicável ou vínculo semântico do arquivo, inspecione o arquivo, descubra ou crie o .sema aplicável e vincule antes do código.",
-        "Em IDE local, rode sema --version; se falhar, pare. A IA não acessa o painel Sema: peça ao humano para instalar a CLI pelo painel. Depois rode sema preflight <comando> --json; só continue com use_cli_local; não use MCP remoto, sema_sync, sema_contratos_sincronizar nem sema mcp-client para workspace local.",
-        "Em web/remoto sem workspace, use sema_chat_contexto e sema_sync inline com contrato, código selecionado, documentação e índice; se falhar, pare.",
-        `Se arquivos_codigo.conteudo ou conteudo inline passar de ${LIMITE_CARACTERES_PAYLOAD_INLINE_MCP} caracteres, não aumente timeout para forçar: divida por responsabilidade ou use anexo/caminho de servidor autorizado.`,
+        "Em IDE local, rode sema --version; se falhar, pare. A IA não acessa o painel Sema: peça ao humano para instalar a CLI pelo painel. Depois rode sema preflight <comando> --json; só continue com use_cli_local; não use fonte externa de workspace para substituir a CLI local.",
+        "Se não houver workspace local em disco, pare bloqueado e peça o fluxo apropriado; não invente caminho nem substitua a CLI local por ferramenta paralela.",
+        `Se arquivos_codigo.conteudo ou conteudo inline passar de ${LIMITE_CARACTERES_PAYLOAD_INLINE} caracteres, não aumente timeout para forçar: divida por responsabilidade ou use anexo/caminho de servidor autorizado.`,
         "Se for criar ou corrigir .sema, use sema_exemplos antes de escrever sintaxe.",
         "Se a resposta humana estiver em PT-BR, use vocabulário Sema canônico e preserve acentos mesmo que a DSL use ASCII.",
         "Se um arquivo de código tiver SEMA-GOVERNED, consulte Sema e o contrato aplicável antes de editar.",
-        `Se código ou contrato governado passar de ${LIMITE_AVISO_LINHAS_ORCAMENTO_SEMANTICO} linhas, planeje divisão; se passar de ${LIMITE_BLOQUEIO_LINHAS_ORCAMENTO_SEMANTICO}, pare e divida antes de concluir. Documentação Markdown não entra nesse limite de código.`,
-        "Se código ou contrato governado passar do orçamento, divida por responsabilidade real; não fatie em partes artificiais para enganar limite.",
+        `Se codigo governado passar de ${LIMITE_AVISO_LINHAS_CODIGO_GOVERNADO} linhas, planeje divisao; se passar de ${LIMITE_BLOQUEIO_LINHAS_CODIGO_GOVERNADO}, pare e divida antes de concluir. Documentacao Markdown nao entra nesse limite de codigo.`,
+        `Se contrato .sema passar de ${LIMITE_AVISO_LINHAS_CONTRATO_SEMA} linhas, planeje split por dominio/capacidade; acima de ${LIMITE_BLOQUEIO_LINHAS_CONTRATO_SEMA}, criacao e edicao ficam bloqueadas. Nao use parte_1/parte_2 e nao remova guarantees, tests ou vinculos so para caber.`,
+        "Um mesmo arquivo de codigo pode ser governado por varios contratos .sema via vinculos; Sema Codigo deve preservar essa rastreabilidade.",
         "Se score, achados ou decisaoAgente parecerem bons, trate como sinal de triagem e confira evidência concreta no contrato e no código.",
         "Se validar artefato inline com 100/100, ainda preserve cabeçalho SEMA-GOVERNED no arquivo físico sincronizado.",
-        "Se o MCP retornar caminho Linux como /srv/sema/projetos, trate como espelho remoto autorizado, não como pasta local do usuário.",
+        "Se `sema drift` retornar sucesso:false, `vinculos_quebrados`, `rotas_divergentes` ou impls quebradas, a mudanca nao pode ser declarada concluida; corrija contrato/codigo e rode drift de novo.",
+        "Se a tarefa tiver site, sistema, app, UI, painel, jogo, CLI/TUI ou terminal, nao conclua sem acabamento moderno, contextual e evidenciado; em UI mobile estreita (ex. 390px), `document.documentElement.scrollWidth <= document.documentElement.clientWidth` precisa ser verdadeiro.",
+        "Se texto visivel PT-BR perder acento ou cedilha em termos como descricao, lancamentos, saude ou alimentacao, trate como defeito bloqueante quando houver i18n/idioma declarado.",
+        "Se aparecer caminho que não pertence ao workspace local aberto pelo usuário, pare e confirme a fonte antes de agir.",
         "Se uma chamada Sema estourar por timeout local, aumente o timeout e tente de novo; timeout do agente não libera ação sem Sema.",
         "Se a plataforma bloquear ou alertar política, trate como bloqueio externo ou falso positivo possível; explique sem tentar contornar filtro.",
-        "Se a tarefa tiver UI e você não conseguir garantir um padrão visual moderno mínimo, pare e peça revisão em vez de entregar interface genérica.",
+        "Se a tarefa tiver experiência de uso e você não conseguir garantir padrão moderno, contextual e não genérico, pare e peça revisão em vez de entregar coisa engessada.",
     ];
 }
 export function criarAgentContextPack(guiaPorCapacidade) {
@@ -280,7 +305,7 @@ export function criarAgentContextPack(guiaPorCapacidade) {
             incluirTextoBrutoQuando: "a IA precisa confirmar regras locais obrigatórias e prioridades do projeto",
         },
         {
-            caminho: "docs/comandos.md",
+            caminho: "docs/commands.md",
             tipo: "docs",
             prioridade: 9,
             obrigatorio: true,
@@ -295,26 +320,18 @@ export function criarAgentContextPack(guiaPorCapacidade) {
             quandoUsar: "antes de criar ou corrigir arquivo .sema, profile, Author, workflow, ops, game, legal ou research",
             incluirTextoBrutoQuando: "a IA vai escrever sintaxe Sema ou comparar um contrato com formato oficial",
         },
-        {
-            caminho: "docs/AGENT_STARTER.md",
-            tipo: "docs",
-            prioridade: 11,
-            obrigatorio: false,
-            quandoUsar: "onboarding de agente novo ou explicação curta do fluxo",
-            incluirTextoBrutoQuando: "o agente remoto não conhece Sema ainda",
-        },
         {
             caminho: ARQUIVO_DOC_AGENTES_CAPACIDADE,
             tipo: "docs",
-            prioridade: 12,
+            prioridade: 11,
             obrigatorio: false,
             quandoUsar: "configurar Copilot, Cline, Roo Code, OpenCode ou outro agente com disciplina variável",
             incluirTextoBrutoQuando: "a IA precisa entender tiers fraca/média/forte e política de idioma",
         },
         {
-            caminho: "docs/sintaxe.md",
+            caminho: "docs/syntax.md",
             tipo: "docs",
-            prioridade: 13,
+            prioridade: 12,
             obrigatorio: false,
             quandoUsar: "dúvida de gramática, blocos ou formato do DSL",
             incluirTextoBrutoQuando: "a IA vai editar contrato e os exemplos não bastam",
@@ -322,7 +339,7 @@ export function criarAgentContextPack(guiaPorCapacidade) {
         {
             caminho: "contratos/",
             tipo: "contrato",
-            prioridade: 14,
+            prioridade: 13,
             obrigatorio: true,
             quandoUsar: "antes de qualquer implementação ou alteração de comportamento",
             incluirTextoBrutoQuando: "a tarefa toca uma capacidade governada por contrato",
@@ -340,31 +357,33 @@ export function criarAgentContextPack(guiaPorCapacidade) {
             "SEMA_BRIEF.micro.txt",
             "SEMA_INDEX.json",
             "AGENTS.md",
-            "docs/comandos.md",
+            "docs/commands.md",
             "exemplos/",
         ],
         regrasObrigatorias: [
             "Contrato vem antes da ação.",
             "Leia SEMA_BOOT.md antes de qualquer outro artefato de IA.",
             "Leia AGENTS.md antes de editar código, contrato, docs operacionais, release ou deploy.",
-            "Leia docs/comandos.md antes de escolher comando Sema, interpretar bloqueio do Guard ou usar --saida de sema compilar.",
-            "Em IDE local, rode sema --version; se falhar, pare. A IA não acessa o painel Sema: peça ao humano para instalar a CLI pelo painel. Depois chame sema preflight <comando> --json e use a CLI somente com use_cli_local; não use MCP remoto, sema_sync, sema_contratos_sincronizar nem sema mcp-client para workspace local; em web/remoto sem workspace, use sema_chat_contexto e sema_sync inline.",
+            "Leia docs/commands.md antes de escolher comando Sema, interpretar bloqueio do Guard ou usar --saida de sema compilar.",
+            "Em IDE local, rode sema --version; se falhar, pare. A IA não acessa o painel Sema: peça ao humano para instalar a CLI pelo painel. Depois chame sema preflight <comando> --json e use a CLI somente com use_cli_local; não use fonte externa de workspace para substituir a CLI local.",
             "Antes de editar, chame sema_inspecionar no contrato aplicável e rode sema_drift e sema_impacto.",
             "Use exemplos oficiais antes de criar ou corrigir sintaxe .sema.",
             "Use SEMA_INDEX.json para escolher contrato, módulo e arquivos prováveis antes de abrir código cru.",
             "Valide .sema alterado e rode drift antes de concluir.",
+            "Conclusao so e valida se `sema drift --json` retornar sucesso:true, sem `vinculos_quebrados`, sem `rotas_divergentes` e sem impls quebradas.",
             "Quando faltar contrato aplicável ou vínculo semântico do arquivo, inspecione o arquivo, crie/edite o contrato aplicável e vincule antes do código.",
             "Sema não contorna políticas da plataforma; ele governa contrato, escopo, drift, evidência e qualidade.",
             "Responda no idioma do usuário; em PT-BR, use vocabulário Sema canônico e preserve acentos, cedilha, pontuação e símbolos humanos.",
             "Use pontuação composta, achados e decisaoAgente como sinais de triagem; abaixo de 80 bloqueia, o alvo evolui 0.5 ponto até 100, e toda pontuação exige contrato, código e evidência.",
             "Mantenha o cabeçalho SEMA-GOVERNED em código gerado ou governado e volte ao contrato antes de editar.",
             "Validação inline não dispensa cabeçalho SEMA-GOVERNED no arquivo físico sincronizado.",
-            `Payload inline MCP acima de ${LIMITE_CARACTERES_PAYLOAD_INLINE_MCP} caracteres deve ser dividido por responsabilidade ou enviado por transporte autorizado; não é timeout para escalar.`,
-            `Não crie nem conclua código ou contrato governado acima de ${LIMITE_BLOQUEIO_LINHAS_ORCAMENTO_SEMANTICO} linhas; acima de ${LIMITE_AVISO_LINHAS_ORCAMENTO_SEMANTICO}, planeje divisão por responsabilidade. Documentação Markdown não entra nesse limite de código.`,
-            "Divida código ou contrato grande por responsabilidade real, como HTML, CSS, estado, renderização, cálculo e dados; não gere index_p1/index_p2 sem fronteira semântica.",
-            "Caminho Linux retornado pelo MCP remoto é espelho governado do Sema; não confunda com o checkout local do usuário.",
+            `Payload inline acima de ${LIMITE_CARACTERES_PAYLOAD_INLINE} caracteres deve ser dividido por responsabilidade ou enviado por transporte autorizado; não é timeout para escalar.`,
+            `Nao crie nem conclua codigo governado acima de ${LIMITE_BLOQUEIO_LINHAS_CODIGO_GOVERNADO} linhas; acima de ${LIMITE_AVISO_LINHAS_CODIGO_GOVERNADO}, planeje divisao por responsabilidade. Documentacao Markdown nao entra nesse limite de codigo.`,
+            `Nao crie nem edite contrato .sema acima de ${LIMITE_BLOQUEIO_LINHAS_CONTRATO_SEMA} linhas; acima de ${LIMITE_AVISO_LINHAS_CONTRATO_SEMA}, planeje split por dominio/capacidade.`,
+            "Divida contratos .sema por capacidade real, nunca parte_1/parte_2; varios contratos podem apontar para o mesmo arquivo de codigo por vinculos.",
+            "Caminho fora do workspace local aberto pelo usuário não substitui o checkout local.",
             "Se uma chamada Sema estourar por timeout local, aumente o timeout e tente novamente; não trate lentidão como sessão inativa.",
-            "Se a tarefa tiver UI, trate design moderno como requisito governado por capacidade.",
+            "Se a tarefa tiver site, sistema, app, UI, painel, jogo, CLI/TUI ou terminal, trate acabamento moderno, contextual, responsividade real ou ergonomia de comando como requisito governado.",
         ],
         proibicoes: [
             "Não inventar sintaxe Sema fora da gramática e dos exemplos oficiais.",
@@ -373,32 +392,35 @@ export function criarAgentContextPack(guiaPorCapacidade) {
             "Não tratar a pasta --saida de sema compilar como entrega final; entrega são os arquivos alvo/vínculos do contrato.",
             "Não sincronizar segredos, .env, node_modules, builds, caches, uploads ou artefatos privados fora do escopo.",
             "Não publicar, deployar ou remover capacidade sem contrato, drift e verificação.",
-            "Não assumir repositório público, GitHub Release pública, leitura local pelo MCP ou acesso da IA ao painel; em IDE local prove CLI com sema --version, em web/remoto use sync inline.",
+            "Não assumir repositório público, GitHub Release pública, fonte externa de workspace ou acesso da IA ao painel; em IDE local prove CLI com sema --version.",
             "Não usar a estética ASCII da DSL nem inglês de produto como desculpa para fugir do vocabulário Sema em PT-BR.",
             "Não remover SEMA-GOVERNED nem substituir drift por comentário dentro do código.",
             "Não copiar o contrato inteiro para comentário de código; mantenha descrição humana curta.",
-            "Não tratar orçamento semântico como sugestão; código ou contrato governado grande deve ser dividido antes de concluir.",
-            "Não fatiar código ou contrato grande em partes sem responsabilidade real para passar no limite.",
+            "Nao tratar orcamento semantico como sugestao; codigo governado ou contrato .sema grande deve ser dividido antes de concluir.",
+            "Nao fatiar codigo ou contrato grande em partes sem responsabilidade real para passar no limite.",
             "Não tratar score 100, regex ou presença de palavra-chave como prova suficiente de governança; pontuação abaixo do piso ou do alvo evolutivo bloqueia conclusão.",
+            "Nao dizer que drift passou limpo quando o JSON trouxe sucesso:false, vinculos_quebrados, rotas_divergentes ou impls quebradas.",
             "Não tratar validação inline como dispensa de cabeçalho SEMA-GOVERNED no arquivo físico.",
-            `Não tentar resolver payload inline acima de ${LIMITE_CARACTERES_PAYLOAD_INLINE_MCP} caracteres aumentando timeout.`,
-            `Não culpar o limite de ${LIMITE_BLOQUEIO_LINHAS_ORCAMENTO_SEMANTICO} linhas por arquitetura monolítica escolhida pela IA.`,
+            `Não tentar resolver payload inline acima de ${LIMITE_CARACTERES_PAYLOAD_INLINE} caracteres aumentando timeout.`,
+            `Nao culpar o limite de ${LIMITE_BLOQUEIO_LINHAS_CODIGO_GOVERNADO} linhas para codigo ou ${LIMITE_BLOQUEIO_LINHAS_CONTRATO_SEMA} linhas para .sema por arquitetura monolitica escolhida pela IA.`,
             "Não tratar timeout definido pelo agente como falha do Sema ou permissão para pular gate.",
             "Não usar Sema para contornar política, segurança, permissões, termos ou filtros da plataforma.",
-            "Não entregar interface genérica, cinza, com cara de template antigo ou sem estados visuais quando a tarefa envolve UI.",
+            "Não entregar site, app, painel ou terminal genérico, engessado, com cara de template antigo, sem domínio, sem estados ou sem ergonomia real.",
+            "Nao declarar UI responsiva sem teste mobile/desktop; scroll horizontal em 390px bloqueia fechamento.",
         ],
         prioridades: [
             "Menor artefato suficiente primeiro.",
-            "IDE local: sema --version, preflight, resumo, docs-impacto, inspecionar, drift e impacto pela CLI; se sema não existir, pare. A IA não acessa o painel Sema: peça ao humano instalar pelo painel; sem MCP remoto, sema_sync, sema_contratos_sincronizar ou sema mcp-client para workspace; web/remoto: sema_chat_contexto e sema_sync inline.",
+            "IDE local: sema --version, preflight, resumo, docs-impacto, inspecionar, drift e impacto pela CLI; se sema não existir, pare. A IA não acessa o painel Sema: peça ao humano instalar pelo painel; sem fonte externa de workspace.",
             "Contrato, índice e AGENTS complementam o contexto Sema; não substituem chamada Sema.",
             "Exemplos oficiais antes de nova sintaxe.",
             "Diagnóstico estruturado antes de opinião livre.",
             "Compatibilidade com políticas da plataforma antes de reformular ou continuar após alerta externo.",
             "Sinal sem evidência vira ritual; evidência concreta antes de concluir aderência.",
             "Retry progressivo em timeout antes de declarar bloqueio.",
+            "Fechamento honesto: drift JSON verde antes de dizer concluido; sucesso:false, vinculo quebrado ou rota divergente ainda e bloqueio.",
             "Separar limite de transporte inline de lentidão real: payload grande demais exige split/transporte correto, não retry infinito.",
             "Orçamento semântico, divisão por responsabilidade e cabeçalho governado antes de gravar ou finalizar código.",
-            "Design visual por capacidade quando houver UI.",
+            "Acabamento visual/terminal por capacidade quando houver experiência de uso, com prova de viewport mobile sem overflow horizontal ou smoke check de comando.",
             "Se risco ou escopo estiver ambíguo, parar e pedir contrato/contexto.",
         ],
         fontes,

package/dist/agentContextTipos.d.ts

@@ -86,11 +86,11 @@ export interface AgentContextPack {
 export declare const ARQUIVO_SEMA_BOOT = "SEMA_BOOT.md";
 export declare const ARQUIVO_SEMA_SMALL_MODEL = "SEMA_SMALL_MODEL.md";
 export declare const ARQUIVO_AGENT_CONTEXT_PACK = "AGENT_CONTEXT_PACK.json";
-export declare const ARQUIVO_DOC_AGENTES_CAPACIDADE = "docs/agentes-por-capacidade.md";
+export declare const ARQUIVO_DOC_AGENTES_CAPACIDADE = "docs/ai-integration.md";
 export declare const ARQUIVOS_CANONICOS_IA_RAIZ: readonly ["SEMA_BOOT.md", "llms.txt", "AGENT_CONTEXT_PACK.json", "SEMA_SMALL_MODEL.md", "SEMA_BRIEF.md", "SEMA_INDEX.json", "AGENTS.md", "README.md", "llms-full.txt"];
 export declare const CAPACIDADES_IA_OPERACIONAIS: readonly ["fraca", "media", "forte"];
 export declare const ALIASES_CAPACIDADE_IA: Record<CapacidadeIaLegada, CapacidadeIa>;
 export declare const MARCADOR_SEMA_AGENT_ENTRYPOINT_INICIO = "<!-- sema:agent-entrypoint:start -->";
 export declare const MARCADOR_SEMA_AGENT_ENTRYPOINT_FIM = "<!-- sema:agent-entrypoint:end -->";
-export declare const DOCUMENTOS_SUPORTE_IA: readonly ["docs/agentes-por-capacidade.md", "docs/AGENT_STARTER.md", "docs/integracao-com-ia.md", "docs/fluxo-pratico-ia-sema.md", "docs/como-ensinar-a-sema-para-ia.md", "docs/persistencia-vendor-first.md", "docs/sintaxe.md", "docs/cli.md", "docs/comandos.md", "docs/mcp.md", "docs/profiles.md", "docs/profiles-author-agents-flow.md", "docs/testes.md", "docs/documentacao.md", "docs/deploy.md", "docs/env.md", "docs/rollback.md", "docs/extensao-vscode.md"];
+export declare const DOCUMENTOS_SUPORTE_IA: readonly ["docs/ai-integration.md", "docs/ai-workflow.md", "docs/ai-onboarding.md", "docs/syntax.md", "docs/cli.md", "docs/commands.md", "docs/profiles.md", "docs/testing.md", "docs/documentation.md", "docs/deploy.md", "docs/env.md", "docs/rollback.md"];
 export declare const EXEMPLOS_OFICIAIS_AGENT_CONTEXT: readonly ["exemplos/calculadora.sema", "exemplos/pagamento.sema", "exemplos/profile_software.sema", "exemplos/profile_workflow_n8n.sema", "exemplos/profile_ops.sema", "exemplos/profile_game.sema", "exemplos/profile_legal.sema", "exemplos/profile_research.sema", "exemplos/author_obra_comum.sema"];

package/dist/agentContextTipos.js

@@ -3,7 +3,7 @@
 export const ARQUIVO_SEMA_BOOT = "SEMA_BOOT.md";
 export const ARQUIVO_SEMA_SMALL_MODEL = "SEMA_SMALL_MODEL.md";
 export const ARQUIVO_AGENT_CONTEXT_PACK = "AGENT_CONTEXT_PACK.json";
-export const ARQUIVO_DOC_AGENTES_CAPACIDADE = "docs/agentes-por-capacidade.md";
+export const ARQUIVO_DOC_AGENTES_CAPACIDADE = "docs/ai-integration.md";
 export const ARQUIVOS_CANONICOS_IA_RAIZ = [
     ARQUIVO_SEMA_BOOT,
     "llms.txt",
@@ -24,23 +24,17 @@ export const MARCADOR_SEMA_AGENT_ENTRYPOINT_INICIO = "<!-- sema:agent-entrypoint
 export const MARCADOR_SEMA_AGENT_ENTRYPOINT_FIM = "<!-- sema:agent-entrypoint:end -->";
 export const DOCUMENTOS_SUPORTE_IA = [
     ARQUIVO_DOC_AGENTES_CAPACIDADE,
-    "docs/AGENT_STARTER.md",
-    "docs/integracao-com-ia.md",
-    "docs/fluxo-pratico-ia-sema.md",
-    "docs/como-ensinar-a-sema-para-ia.md",
-    "docs/persistencia-vendor-first.md",
-    "docs/sintaxe.md",
+    "docs/ai-workflow.md",
+    "docs/ai-onboarding.md",
+    "docs/syntax.md",
     "docs/cli.md",
-    "docs/comandos.md",
-    "docs/mcp.md",
+    "docs/commands.md",
     "docs/profiles.md",
-    "docs/profiles-author-agents-flow.md",
-    "docs/testes.md",
-    "docs/documentacao.md",
+    "docs/testing.md",
+    "docs/documentation.md",
     "docs/deploy.md",
     "docs/env.md",
     "docs/rollback.md",
-    "docs/extensao-vscode.md",
 ];
 export const EXEMPLOS_OFICIAIS_AGENT_CONTEXT = [
     "exemplos/calculadora.sema",