@semacode/cli 1.5.48 → 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: ("README.md" | "SEMA_BRIEF.md" | "SEMA_INDEX.json" | "SEMA_BOOT.md" | "llms.txt" | "AGENT_CONTEXT_PACK.json" | "SEMA_SMALL_MODEL.md" | "AGENTS.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

@@ -2,7 +2,7 @@
 // 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_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 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_MCP} caracteres nao e caso de aumentar timeout: divida por responsabilidade ou use anexo/caminho de servidor autorizado.`,
+        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 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_MCP} 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_MCP} caracteres.`,
+            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",
@@ -218,9 +218,9 @@ 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 rota remota, sincronização externa ou leitura por espelho para workspace local.",
+        "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_MCP} caracteres, não aumente timeout para forçar: divida por responsabilidade ou use anexo/caminho de servidor autorizado.`,
+        `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.",
@@ -232,7 +232,7 @@ function criarFailClosedAgentContext() {
         "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 de servidor como /srv/sema/projetos, trate como espelho governado, não como pasta local do usuário.",
+        "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 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.",
@@ -305,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,
@@ -320,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",
@@ -347,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",
@@ -365,15 +357,15 @@ 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 rota remota, sincronização externa ou leitura por espelho para workspace local.",
+            "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.",
@@ -385,11 +377,11 @@ export function criarAgentContextPack(guiaPorCapacidade) {
             "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 acima de ${LIMITE_CARACTERES_PAYLOAD_INLINE_MCP} caracteres deve ser dividido por responsabilidade ou enviado por transporte autorizado; não é timeout para escalar.`,
+            `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 de servidor ou espelho governado do Sema não é o checkout local do usuário.",
+            "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 site, sistema, app, UI, painel, jogo, CLI/TUI ou terminal, trate acabamento moderno, contextual, responsividade real ou ergonomia de comando como requisito governado.",
         ],
@@ -400,7 +392,7 @@ 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 por espelho ou acesso da IA ao painel; em IDE local prove CLI com sema --version.",
+            "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.",
@@ -409,7 +401,7 @@ export function criarAgentContextPack(guiaPorCapacidade) {
             "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 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.",
@@ -418,7 +410,7 @@ export function criarAgentContextPack(guiaPorCapacidade) {
         ],
         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 rota remota, sincronização externa ou leitura por espelho para workspace.",
+            "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.",

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",