@semacode/cli 1.5.45 → 1.5.47

package/AGENT_CONTEXT_PACK.json

@@ -10,26 +10,28 @@
     "SEMA_BRIEF.micro.txt",
     "SEMA_INDEX.json",
     "AGENTS.md",
+    "docs/comandos.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.",
     "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.",
-    "Quando faltar contrato aplicável, crie ou edite o contrato antes do código.",
+    "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 262144 caracteres deve ser dividido por responsabilidade ou enviado por transporte autorizado; não é timeout para escalar.",
-    "Não crie nem conclua arquivo acima de 500 linhas; acima de 300, planeje divisão por responsabilidade.",
-    "Divida arquivo 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.",
+    "Não crie nem conclua código ou contrato governado acima de 2000 linhas; acima de 1000, 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.",
     "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."
@@ -38,18 +40,19 @@
     "Não inventar sintaxe Sema fora da gramática e dos exemplos oficiais.",
     "Não tratar README, texto livre ou código como fonte superior ao contrato.",
     "Não substituir contexto Sema por AGENTS.md, README.md, busca local, inferência pelo nome do projeto ou bom senso sem preflight/autorização Sema.",
+    "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 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; arquivo grande deve ser dividido antes de concluir.",
-    "Não fatiar arquivo grande em partes sem responsabilidade real para passar no limite.",
+    "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.",
     "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.",
     "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 262144 caracteres aumentando timeout.",
-    "Não culpar o limite de 500 linhas por arquitetura monolítica escolhida pela IA.",
+    "Não culpar o limite de 2000 linhas por arquitetura monolítica 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."
@@ -133,10 +136,18 @@
       "quandoUsar": "antes de editar código, contrato, docs operacionais, release ou deploy",
       "incluirTextoBrutoQuando": "a IA precisa confirmar regras locais obrigatórias e prioridades do projeto"
     },
+    {
+      "caminho": "docs/comandos.md",
+      "tipo": "docs",
+      "prioridade": 9,
+      "obrigatorio": true,
+      "quandoUsar": "antes de escolher comando Sema, interpretar --saida de sema compilar ou destravar Sema Codigo",
+      "incluirTextoBrutoQuando": "a IA precisa entender comandos, gates, saida gerada e proximo passo governado"
+    },
     {
       "caminho": "exemplos/",
       "tipo": "exemplos",
-      "prioridade": 9,
+      "prioridade": 10,
       "obrigatorio": true,
       "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"
@@ -144,7 +155,7 @@
     {
       "caminho": "docs/AGENT_STARTER.md",
       "tipo": "docs",
-      "prioridade": 10,
+      "prioridade": 11,
       "obrigatorio": false,
       "quandoUsar": "onboarding de agente novo ou explicação curta do fluxo",
       "incluirTextoBrutoQuando": "o agente remoto não conhece Sema ainda"
@@ -152,7 +163,7 @@
     {
       "caminho": "docs/agentes-por-capacidade.md",
       "tipo": "docs",
-      "prioridade": 11,
+      "prioridade": 12,
       "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"
@@ -160,7 +171,7 @@
     {
       "caminho": "docs/sintaxe.md",
       "tipo": "docs",
-      "prioridade": 12,
+      "prioridade": 13,
       "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"
@@ -168,7 +179,7 @@
     {
       "caminho": "contratos/",
       "tipo": "contrato",
-      "prioridade": 13,
+      "prioridade": 14,
       "obrigatorio": true,
       "quandoUsar": "antes de qualquer implementação ou alteração de comportamento",
       "incluirTextoBrutoQuando": "a tarefa toca uma capacidade governada por contrato"
@@ -194,6 +205,7 @@
     "SEMA_BRIEF.curto.txt": "o módulo alvo ainda não está claro pelo micro",
     "SEMA_INDEX.json": "a IA precisa mapear módulos, lacunas, riscos ou arquivos prováveis",
     "AGENTS.md": "a IA precisa confirmar regras locais obrigatórias e prioridades do projeto",
+    "docs/comandos.md": "a IA precisa entender comandos, gates, saida gerada e proximo passo governado",
     "exemplos/": "a IA vai escrever sintaxe Sema ou comparar um contrato com formato oficial",
     "docs/AGENT_STARTER.md": "o agente remoto não conhece Sema ainda",
     "docs/agentes-por-capacidade.md": "a IA precisa entender tiers fraca/média/forte e política de idioma",
@@ -341,12 +353,12 @@
   },
   "politicaCodigoGovernado": {
     "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. Acima de 300 linhas gera diagnóstico de refatoração; acima de 500 linhas bloqueia drift, finalização, geração e snapshot. Payload inline MCP acima de 262144 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 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 1000 linhas geram diagnóstico de refatoração; acima de 2000 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 262144 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.",
     "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 arquivo acima de 500 linhas nem envie payload inline acima de 262144 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 300+ linhas como refatoração provável; se o payload inline passar de 262144 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 de 500 linhas e finalizar-mudanca. Contexto grande não autoriza monólito nem payload inline acima de 262144 caracteres."
+      "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 2000 linhas nem envie payload inline acima de 262144 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 1000+ linhas em código ou contrato governado como refatoração provável; se o payload inline passar de 262144 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 2000 linhas e finalizar-mudanca. Contexto grande não autoriza monólito nem payload inline acima de 262144 caracteres."
     },
     "formatosPorAlvo": {
       "typescript": "// SEMA-GOVERNED",
@@ -439,15 +451,15 @@
   },
   "failClosed": [
     "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, crie ou edite o .sema antes do código.",
+    "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 262144 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 um arquivo passar de 300 linhas, planeje divisão; se passar de 500, pare e divida antes de concluir.",
-    "Se um arquivo passar do orçamento, divida por responsabilidade real; não fatie em partes artificiais para enganar limite.",
+    "Se código ou contrato governado passar de 1000 linhas, planeje divisão; se passar de 2000, 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 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.",

package/SEMA_BRIEF.curto.txt

@@ -7,11 +7,12 @@ ENTRADA_IA: SEMA_BOOT.md -> llms.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.cu
 POLITICA_PLATAFORMA: O Sema governa contrato, escopo, drift, evidência e qualidade do projeto. Ele não pede, não autoriza e não contorna políticas da plataforma, termos de uso, permissões, segurança ou leis. Se um cliente, modelo ou classificador bloquear a mensagem, trate como bloqueio externo ou falso positivo possível: explique de forma neutra, preserve a intenção legítima de governança e não tente burlar filtros.
 TIMEOUT_SEMA: Timeout definido pelo agente não é falha do Sema. Se `sema resumo`, `inspecionar`, `drift` ou `sync-ai-entrypoints` estourar por timeout local, aumente o timeout e tente de novo com escopo menor quando possível. Escale 120s -> 300s -> 600s antes de declarar bloqueio.
 CODIGO_GOVERNADO: SEMA-GOVERNED -> docs-impacto e drift antes de alterar comportamento
-ORCAMENTO_SEMANTICO: acima de 300 linhas exige refatoracao planejada; acima de 500 bloqueia finalizar-mudanca, drift, geracao e snapshot
+ORCAMENTO_SEMANTICO: codigo/contrato governado acima de 1000 linhas exige refatoracao planejada; acima de 2000 bloqueia finalizar-mudanca, drift, geracao e snapshot; Markdown/documentacao nao entra no limite de codigo
 PAYLOAD_MCP: conteudo inline acima de 262144 caracteres deve virar arquivos logicos, anexo, caminho de servidor autorizado ou manifesto; nao aumente timeout para empurrar o mesmo payload
 DESIGN_VISUAL: 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. 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.
 TOP_MODULOS: sema.produto.artes_produto, sema.produto.author.fluxos, sema.produto.author.modelos_2, sema.produto.author.modelos, sema.produto.author.superficies, sema.produto.author.tarefas_2 (+86)
-TOP_RISCOS: adaptar_copy_multicanal:medio, altera_persistencia, analisar_drift_ferramenta:medio, analisar_foto_original:medio, analisar_job_freela:medio, aplicar_vocabulario_canonico_ia:medio (+190)
-TOP_LACUNAS: execucao_implicita, persistencia:public.sema_monthly_balances:materializado:desconhecida, persistencia:public.sema_usage_events:materializado:desconhecida, persistencia:runner_postgres:materializado:desconhecida
-TOP_ARQUIVOS: C:\GitHub\Sema\deploy\caddy\sema-site.Caddyfile, C:\GitHub\Sema\docs\agentes-por-capacidade.md, C:\GitHub\Sema\docs\auth.md, C:\GitHub\Sema\docs\cli.md, C:\GitHub\Sema\docs\controle-comercial-supabase.md, C:\GitHub\Sema\docs\da-sema-para-codigo.md (+149)
-GERADO_EM: 2026-06-08T13:27:19.198Z
+TOP_RISCOS: adaptar_copy_multicanal:medio, altera_persistencia, analisar_drift_ferramenta:medio, analisar_foto_original:medio, analisar_job_freela:medio, aplicar_vocabulario_canonico_ia:medio (+191)
+TOP_LACUNAS: execucao_implicita, persistencia:arquivo_config:materializado:desconhecida, persistencia:contrato_inicial:materializado:desconhecida, persistencia:exemplos_oficiais:materializado:desconhecida, persistencia:FerramentaGovernanca:materializado:desconhecida, persistencia:kit_ia:materializado:desconhecida
+TOP_ARQUIVOS: C:\GitHub\Sema\deploy\caddy\sema-site.Caddyfile, C:\GitHub\Sema\docs\agentes-por-capacidade.md, C:\GitHub\Sema\docs\auth.md, C:\GitHub\Sema\docs\cli.md, C:\GitHub\Sema\docs\controle-comercial-supabase.md, C:\GitHub\Sema\docs\da-sema-para-codigo.md (+153)
+TOP_ARQUIVOS_FONTE: vinculo_contrato
+GERADO_EM: 2026-06-10T06:08:26.735Z