@semacode/cli 1.5.48 → 1.5.53

package/dist/contexto.js

@@ -1,112 +1,79 @@
 // SEMA-GOVERNED: sema.governanca_ia_contexto
-// Descricao: codigo governado pelo Sema; consulte contratos/sema/governanca_ia_contexto.sema antes de editar.
-/**
- * Gerador de pacote de contexto para chats web (ChatGPT, Lovable, etc.).
- *
- * A CLI lê contratos e código selecionado do disco local e gera um pacote
- * compacto que o usuário cola no chat. Isso elimina o sync manual — a CLI
- * faz o trabalho pesado de I/O local e entrega um payload pronto.
- *
- * Contrato: contratos/sema/mcp_client_bridge.sema — task gerar_pacote_contexto_para_chat
- */
+// Descricao: gera um pacote local de contexto Sema sem depender de servico externo.
 import { readFile, mkdir, writeFile } from "node:fs/promises";
 import path from "node:path";
-// ---------------------------------------------------------------------------
-// Constantes
-// ---------------------------------------------------------------------------
-const LIMITE_TAMANHO_INLINE = 100_000; // 100KB
+const LIMITE_TAMANHO_INLINE = 100_000;
 const PADROES_SEGREDO = [
-    /(?:api[_-]?key|secret|token|password|senha)\s*[:=]\s*["']?[A-Za-z0-9_\-]{16,}/gi,
-    /\bsk-[A-Za-z0-9_\-]{20,}\b/g,
-    /\beyJ[A-Za-z0-9_\-]+\.[A-Za-z0-9_\-]+\.[A-Za-z0-9_\-]+\b/g,
+    /(?:api[_-]?key|secret|token|password|senha)\s*[:=]\s*["']?[A-Za-z0-9_-]{16,}/gi,
+    /\bsk-[A-Za-z0-9_-]{20,}\b/g,
+    /\beyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\b/g,
 ];
-// ---------------------------------------------------------------------------
-// Gerar pacote de contexto para chat
-// ---------------------------------------------------------------------------
 export async function gerarPacoteContextoChat(entrada, cwd = process.cwd()) {
     if (!entrada.contratos || entrada.contratos.length === 0) {
-        throw new Error("Nenhum contrato informado. Use --contratos <arquivo1.sema> <arquivo2.sema>");
+        throw new Error("No contract was provided. Use --contratos <file1.sema> <file2.sema>.");
     }
-    // Ler contratos
     const contratosConteudo = [];
     for (const contrato of entrada.contratos) {
         const absoluto = path.resolve(cwd, contrato);
         const conteudo = await readFile(absoluto, "utf8");
         contratosConteudo.push({ caminho: contrato, conteudo });
     }
-    // Ler código selecionado (se houver)
     const codigoConteudo = [];
-    if (entrada.codigoSelecionado) {
-        for (const arquivo of entrada.codigoSelecionado) {
-            try {
-                const absoluto = path.resolve(cwd, arquivo);
-                let conteudo = await readFile(absoluto, "utf8");
-                conteudo = sanitizarConteudo(conteudo);
-                codigoConteudo.push({ caminho: arquivo, conteudo });
-            }
-            catch {
-                // Arquivo não existe — ignora silenciosamente
-            }
+    for (const arquivo of entrada.codigoSelecionado ?? []) {
+        try {
+            const absoluto = path.resolve(cwd, arquivo);
+            const conteudo = sanitizarConteudo(await readFile(absoluto, "utf8"));
+            codigoConteudo.push({ caminho: arquivo, conteudo });
+        }
+        catch {
+            // Missing selected files are ignored because this helper is best-effort context assembly.
         }
     }
-    // Montar resumo
-    const modulos = contratosConteudo.map((c) => extrairModulo(c.conteudo)).filter(Boolean);
-    const tarefas = contratosConteudo.flatMap((c) => extrairTarefas(c.conteudo));
-    const rotas = contratosConteudo.flatMap((c) => extrairRotas(c.conteudo));
+    const modulos = contratosConteudo.map((contrato) => extrairModulo(contrato.conteudo)).filter(Boolean);
+    const tarefas = contratosConteudo.flatMap((contrato) => extrairTarefas(contrato.conteudo));
+    const rotas = contratosConteudo.flatMap((contrato) => extrairRotas(contrato.conteudo));
     const resumo = [
-        `# Contexto Sema para Chat`,
-        ``,
-        `**Módulos:** ${modulos.join(", ") || "nenhum"}`,
-        `**Tarefas:** ${tarefas.length}`,
-        `**Rotas:** ${rotas.length}`,
-        `**Arquivos de código:** ${codigoConteudo.length}`,
-        ``,
-        `## Contratos`,
-        ...contratosConteudo.map((c) => `### ${c.caminho}\n\`\`\`sema\n${c.conteudo}\n\`\`\``),
-        ``,
+        "# Sema Local Context",
+        "",
+        `Modules: ${modulos.join(", ") || "none"}`,
+        `Tasks: ${tarefas.length}`,
+        `Routes: ${rotas.length}`,
+        `Selected code files: ${codigoConteudo.length}`,
+        "",
+        "## Contracts",
+        ...contratosConteudo.map((contrato) => `### ${contrato.caminho}\n\`\`\`sema\n${contrato.conteudo}\n\`\`\``),
+        "",
     ].join("\n");
-    // Código selecionado (resumido)
     const codigoResumido = codigoConteudo.length > 0
         ? [
-            `## Código Selecionado`,
-            ...codigoConteudo.map((c) => {
-                const ext = path.extname(c.caminho).slice(1) || "txt";
-                return `### ${c.caminho}\n\`\`\`${ext}\n${c.conteudo}\n\`\`\``;
+            "## Selected Code",
+            ...codigoConteudo.map((arquivo) => {
+                const ext = path.extname(arquivo.caminho).slice(1) || "txt";
+                return `### ${arquivo.caminho}\n\`\`\`${ext}\n${arquivo.conteudo}\n\`\`\``;
             }),
-            ``,
+            "",
         ].join("\n")
         : "";
-    // IR resumida
     const irResumida = [
-        `## IR Resumida`,
-        `- Módulos: ${modulos.join(", ") || "nenhum"}`,
-        `- Tarefas: ${tarefas.map((t) => `\`${t}\``).join(", ") || "nenhuma"}`,
-        `- Rotas: ${rotas.map((r) => `\`${r}\``).join(", ") || "nenhuma"}`,
-        ``,
+        "## IR Summary",
+        `- Modules: ${modulos.join(", ") || "none"}`,
+        `- Tasks: ${tarefas.map((tarefa) => `\`${tarefa}\``).join(", ") || "none"}`,
+        `- Routes: ${rotas.map((rota) => `\`${rota}\``).join(", ") || "none"}`,
+        "",
     ].join("\n");
-    // Drift resumido (placeholder — a CLI faz drift real via `sema drift`)
     const driftResumido = entrada.incluirDrift
-        ? [
-            `## Drift`,
-            `⚠️ Drift real requer \`sema drift\` CLI.`,
-            `Este pacote contém contratos e código para o MCP executar drift remoto.`,
-            ``,
-        ].join("\n")
-        : `## Drift\nNão incluído (use --drift para incluir).\n`;
-    // Impact map (placeholder)
+        ? "## Drift\nRun `sema drift` locally for the authoritative drift result.\n"
+        : "## Drift\nNot included. Run `sema drift` locally when drift evidence is required.\n";
     const impactMap = entrada.incluirImpacto
-        ? tarefas.map((t) => `- \`${t}\`: contratos/${t}.sema → implementação`)
+        ? tarefas.map((tarefa) => `- \`${tarefa}\`: local contract and linked implementation must be inspected with \`sema impacto\`.`)
         : [];
-    // Docs relevantes
     const docsRelevantes = [
         "AGENTS.md",
-        "docs/mcp.md",
         "docs/cli.md",
-        "docs/sintaxe.md",
+        "docs/syntax.md",
+        "docs/documentation.md",
     ];
-    // Checksum simples
-    const conteudoTotal = contratosConteudo.map((c) => c.conteudo).join("");
-    const checksum = checksumSimples(conteudoTotal);
+    const checksum = checksumSimples(contratosConteudo.map((contrato) => contrato.conteudo).join(""));
     const pacote = {
         contratos: entrada.contratos,
         resumo,
@@ -116,7 +83,6 @@ export async function gerarPacoteContextoChat(entrada, cwd = process.cwd()) {
         docsRelevantes,
         checksum,
     };
-    // Montar texto inline completo
     const inlineTexto = [
         `<!-- SEMA_CONTEXT_PACK v1 checksum=${checksum} -->`,
         resumo,
@@ -124,20 +90,19 @@ export async function gerarPacoteContextoChat(entrada, cwd = process.cwd()) {
         irResumida,
         driftResumido,
         impactMap.length > 0 ? `## Impact Map\n${impactMap.join("\n")}\n` : "",
-        `## Docs Relevantes`,
-        `Leia estes arquivos antes de agir:`,
-        ...docsRelevantes.map((d) => `- \`${d}\``),
-        ``,
-        `## Instruções para o Agente`,
-        `1. Leia os contratos acima — eles são a fonte da verdade`,
-        `2. Código selecionado é contexto adicional, não substitui o contrato`,
-        `3. Antes de qualquer ação: crie, edite ou remova o .sema aplicável`,
-        `4. Use \`sema_docs_impacto\` com sua intenção declarada`,
-        `5. Finalize com \`sema_finalizar_mudanca\``,
+        "## Relevant Docs",
+        "Read these files before acting:",
+        ...docsRelevantes.map((doc) => `- \`${doc}\``),
+        "",
+        "## Agent Instructions",
+        "1. Read the contracts above. They are the source of truth.",
+        "2. Treat selected code as context, not as a substitute for the contract.",
+        "3. Run `sema docs-impacto` with the declared intention before changing files.",
+        "4. Run `sema drift` and `sema impacto` locally before editing governed code.",
+        "5. Close with `sema finalizar-mudanca` and concrete evidence.",
     ].join("\n");
     const tamanhoBytes = Buffer.byteLength(inlineTexto, "utf8");
     const prontoParaChat = tamanhoBytes <= LIMITE_TAMANHO_INLINE;
-    // Gerar arquivos se solicitado
     const arquivosGerados = [];
     if (entrada.formatoSaida === "arquivo" || entrada.formatoSaida === "ambos") {
         const pastaSaida = path.resolve(cwd, ".tmp", "sema-contexto-chat");
@@ -145,7 +110,6 @@ export async function gerarPacoteContextoChat(entrada, cwd = process.cwd()) {
         const arquivoContexto = path.join(pastaSaida, "SEMA_CONTEXT_CHAT.md");
         await writeFile(arquivoContexto, inlineTexto, "utf8");
         arquivosGerados.push(arquivoContexto);
-        // Também gerar JSON estruturado
         const arquivoJson = path.join(pastaSaida, "contexto-chat.json");
         await writeFile(arquivoJson, JSON.stringify({ pacote, tamanhoBytes, prontoParaChat }, null, 2), "utf8");
         arquivosGerados.push(arquivoJson);
@@ -158,40 +122,26 @@ export async function gerarPacoteContextoChat(entrada, cwd = process.cwd()) {
         inlineTexto: entrada.formatoSaida === "inline" || entrada.formatoSaida === "ambos" ? inlineTexto : undefined,
     };
 }
-// ---------------------------------------------------------------------------
-// Helpers de extração
-// ---------------------------------------------------------------------------
 function extrairModulo(conteudo) {
     const match = conteudo.match(/^module\s+([\w.]+)\s*\{/m);
     return match ? match[1] : null;
 }
 function extrairTarefas(conteudo) {
-    const tarefas = [];
-    const regex = /^\s*task\s+(\w+)\s*\{/gm;
-    let match;
-    while ((match = regex.exec(conteudo)) !== null) {
-        tarefas.push(match[1]);
-    }
-    return tarefas;
+    return [...conteudo.matchAll(/^\s*task\s+(\w+)\s*\{/gm)].map((match) => match[1]);
 }
 function extrairRotas(conteudo) {
-    const rotas = [];
-    const regex = /^\s*route\s+(\w+)\s*\{/gm;
-    let match;
-    while ((match = regex.exec(conteudo)) !== null) {
-        rotas.push(match[1]);
-    }
-    return rotas;
+    return [...conteudo.matchAll(/^\s*route\s+(\w+)\s*\{/gm)].map((match) => match[1]);
 }
 function sanitizarConteudo(conteudo) {
+    let sanitizado = conteudo;
     for (const padrao of PADROES_SEGREDO) {
-        conteudo = conteudo.replace(padrao, "[REDACTED]");
+        sanitizado = sanitizado.replace(padrao, "[REDACTED]");
     }
-    return conteudo;
+    return sanitizado;
 }
 function checksumSimples(texto) {
     let hash = 0;
-    for (let i = 0; i < texto.length; i++) {
+    for (let i = 0; i < texto.length; i += 1) {
         hash = ((hash << 5) - hash + texto.charCodeAt(i)) | 0;
     }
     return Math.abs(hash).toString(16).padStart(8, "0");

package/dist/docs.part01.js

@@ -146,7 +146,7 @@ export const REGRAS_DOCUMENTACAO = [
         categoria: "author",
         padroes: [/\bauthor\b/, /autoral/, /obra/, /cliche/, /estilo/, /personagem/, /narrativa/, /sensibility/, /sensitivity/],
         docs: [
-            { relativo: "docs/profiles-author-agents-flow.md", tipo: "documentacao", motivo: "profile Author, agents, flow e guardrails autorais", permitirCriacao: false },
+            { relativo: "docs/profiles.md", tipo: "documentacao", motivo: "Author profile and local validation guardrails", permitirCriacao: false },
         ],
     },
     {
@@ -154,7 +154,6 @@ export const REGRAS_DOCUMENTACAO = [
         padroes: [/\bprofiles\b/, /\bworkflow\b/, /\bn8n\b/, /\bops\b/, /\bgame\b/, /\blegal\b/, /\bresearch\b/, /pesquisa/, /juridic/, /orquestracao/, /automacao/],
         docs: [
             { relativo: "docs/profiles.md", tipo: "documentacao", motivo: "profiles oficiais, gates e fronteiras de adapter", permitirCriacao: false },
-            { relativo: "docs/scorecard-compatibilidade.md", tipo: "documentacao", motivo: "scorecard de compatibilidade para runtimes e adapters", permitirCriacao: false },
         ],
     },
     {
@@ -162,23 +161,21 @@ export const REGRAS_DOCUMENTACAO = [
         padroes: [/(^|[^a-z0-9])auth([^a-z0-9]|$)/, /autentic/, /login/, /permiss/, /autoriz/, /token/, /oauth/, /seguranca/],
         docs: [
             { relativo: "docs/auth.md", tipo: "documentacao", motivo: "regras de autenticacao, autorizacao e tokens", permitirCriacao: true },
-            { relativo: "docs/seguranca.md", tipo: "documentacao", motivo: "politicas de seguranca afetadas pela mudanca", permitirCriacao: true },
+            { relativo: "docs/security.md", tipo: "documentacao", motivo: "politicas de seguranca afetadas pela mudanca", permitirCriacao: true },
         ],
     },
     {
         categoria: "persistencia",
         padroes: [/banco/, /database/, /persist/, /migration/, /migracao/, /prisma/, /postgres/, /redis/, /mongodb/],
         docs: [
-            { relativo: "docs/persistencia-vendor-first.md", tipo: "documentacao", motivo: "regras de persistencia vendor-first", permitirCriacao: false },
             { relativo: "docs/database.md", tipo: "runbook", motivo: "operacao de banco, migracoes e validacao de dados", permitirCriacao: true },
         ],
     },
     {
-        categoria: "mcp",
-        padroes: [/\bmcp\b/, /tool/, /ferramenta/, /server/, /streamable/, /sse/],
+        categoria: "integracao_ia",
+        padroes: [/tool/, /ferramenta/, /agent/, /agente/, /copilot/, /cursor/, /cline/, /roo/, /opencode/],
         docs: [
-            { relativo: "docs/integracao-com-ia.md", tipo: "documentacao", motivo: "integracao do Sema com agentes IA", permitirCriacao: false },
-            { relativo: "docs/mcp.md", tipo: "documentacao", motivo: "runbook do MCP privado e ferramentas remotas", permitirCriacao: true },
+            { relativo: "docs/ai-integration.md", tipo: "documentacao", motivo: "integracao do Sema com agentes IA", permitirCriacao: false },
         ],
     },
     {
@@ -189,20 +186,12 @@ export const REGRAS_DOCUMENTACAO = [
             { relativo: "docs/cli.md", tipo: "documentacao", motivo: "guia operacional dos comandos da CLI", permitirCriacao: false },
         ],
     },
-    {
-        categoria: "extensao",
-        padroes: [/vscode/, /extension/, /extensao/, /editor/, /\blsp\b/, /language server/],
-        docs: [
-            { relativo: "pacotes/editor-vscode/README.md", tipo: "pacote", motivo: "documentacao publica da extensao VS Code", permitirCriacao: false },
-            { relativo: "docs/extensao-vscode.md", tipo: "documentacao", motivo: "runbook da extensao VS Code", permitirCriacao: true },
-        ],
-    },
     {
         categoria: "contrato",
         padroes: [/contrato/, /\.sema/, /semant/, /\bsema\b/, /drift/, /governanca/],
         docs: [
-            { relativo: "docs/sintaxe.md", tipo: "documentacao", motivo: "sintaxe e blocos de contrato Sema", permitirCriacao: false },
-            { relativo: "docs/fluxo-pratico-ia-sema.md", tipo: "documentacao", motivo: "fluxo IA-first antes de editar contratos", permitirCriacao: false },
+            { relativo: "docs/syntax.md", tipo: "documentacao", motivo: "sintaxe e blocos de contrato Sema", permitirCriacao: false },
+            { relativo: "docs/ai-workflow.md", tipo: "documentacao", motivo: "fluxo IA-first antes de editar contratos", permitirCriacao: false },
         ],
     },
     {
@@ -216,7 +205,7 @@ export const REGRAS_DOCUMENTACAO = [
         categoria: "testes",
         padroes: [/teste/, /testar/, /qa/, /validacao/, /regressao/],
         docs: [
-            { relativo: "docs/testes.md", tipo: "runbook", motivo: "estrategia de testes e regressao", permitirCriacao: true },
+            { relativo: "docs/testing.md", tipo: "runbook", motivo: "estrategia de testes e regressao", permitirCriacao: true },
         ],
     },
     {
@@ -224,7 +213,7 @@ export const REGRAS_DOCUMENTACAO = [
         padroes: [/doc/, /readme/, /manual/, /runbook/, /onboarding/],
         docs: [
             { relativo: "docs/README.md", tipo: "documentacao", motivo: "indice de documentacao do projeto", permitirCriacao: false },
-            { relativo: "docs/documentacao.md", tipo: "documentacao", motivo: "politica de atualizacao documental", permitirCriacao: true },
+            { relativo: "docs/documentation.md", tipo: "documentacao", motivo: "politica de atualizacao documental", permitirCriacao: true },
         ],
     },
 ];
@@ -240,56 +229,46 @@ export function criarTemplateDoc(doc, intencao, categorias, arquivosAlvo) {
     const linhas = [
         `# ${titulo}`,
         "",
-        "## English",
-        "",
         "This document was created by Sema because an AI declared an intention that requires operational reading before action.",
         "",
-        "## Português",
-        "",
-        "Documento criado pela Sema porque uma IA declarou uma intenção que exige leitura operacional antes de agir.",
-        "",
-        "## Español",
-        "",
-        "Documento creado por Sema porque una IA declaró una intención que exige lectura operativa antes de actuar.",
-        "",
-        "## Intenção",
+        "## Intention",
         "",
-        intencao || "Descrever a intenção operacional antes de executar a mudança.",
+        intencao || "Describe the operational intention before making the change.",
         "",
-        "## Escopo",
+        "## Scope",
         "",
         arquivosAlvo.length > 0
             ? arquivosAlvo.map((arquivo) => `- ${arquivo}`).join("\n")
-            : "- Declarar os arquivos, serviços ou contratos afetados.",
+            : "- Declare the affected files, services, or contracts.",
         "",
-        "## Leitura obrigatória antes de agir",
+        "## Required Reading Before Action",
         "",
-        "- Ler este documento inteiro.",
-        "- Ler contratos .sema relacionados antes de editar código.",
-        "- Ler README, runbooks e docs de pacote envolvidos.",
+        "- Read this whole document.",
+        "- Read related `.sema` contracts before editing code.",
+        "- Read the involved README, runbooks, and package docs.",
         "",
-        "## Procedimento",
+        "## Procedure",
         "",
-        "- Descrever os comandos ou passos seguros.",
-        "- Declarar pré-condições, variáveis e dependências.",
-        "- Registrar como validar sucesso.",
+        "- Describe the safe commands or steps.",
+        "- Declare preconditions, variables, and dependencies.",
+        "- Record how success will be validated.",
         "",
-        "## Validação",
+        "## Validation",
         "",
-        "- Listar comandos de build, teste, verificação ou smoke test.",
-        "- Registrar evidências esperadas.",
+        "- List build, test, verification, or smoke-check commands.",
+        "- Record expected evidence.",
         "",
         "## Rollback",
         "",
-        "- Descrever como desfazer a mudança.",
-        "- Declarar sinais que exigem rollback.",
+        "- Describe how to undo the change.",
+        "- Declare signals that require rollback.",
         "",
-        "## Atualização documental",
+        "## Documentation Update",
         "",
-        "- Atualizar este arquivo quando o fluxo operacional mudar.",
-        "- Atualizar docs e contratos relacionados na mesma mudança.",
+        "- Update this file when the operational flow changes.",
+        "- Update related docs and contracts in the same change.",
         "",
-        `Categorias inferidas: ${categorias.join(", ")}`,
+        `Inferred categories: ${categorias.join(", ")}`,
         "",
     ];
     return `${linhas.join("\n")}\n`;

package/dist/drift.part14.js

@@ -1,8 +1,23 @@
+// SEMA-GOVERNED: sema.governanca_ia_contexto
+// Descricao: analisa modulos selecionados no drift; consulte contratos/sema/governanca_ia_contexto.sema antes de editar.
+import { existsSync } from "node:fs";
+import path from "node:path";
 import { escolherArquivoPorVinculo, escolherSimboloPorVinculo } from "./drift.part03.js";
 import { calcularRiscoOperacional, encontrarAncoraSuperficie } from "./drift.part04.js";
 import { resolverPersistenciaLocalPorTask } from "./drift.part08.js";
 import { escolherRotasEsperadas, normalizarCaminhoRota, ordenarCandidatos, sugerirCandidatosParaImpl, sugerirCandidatosParaTaskSemImpl } from "./drift.part09.js";
 import { coletarVinculosIr, extrairRecursosEsperados, resolverRecursoEsperado } from "./drift.part10.js";
+function escolherArquivoDeclarado(contexto, arquivosConhecidos, valor) {
+    const resolucaoIndexada = escolherArquivoPorVinculo(arquivosConhecidos, valor);
+    if (resolucaoIndexada.status !== "nao_encontrado") {
+        return resolucaoIndexada;
+    }
+    const caminhoExplicito = path.resolve(contexto.baseProjeto, valor);
+    if (existsSync(caminhoExplicito)) {
+        return { arquivo: caminhoExplicito, confianca: "alta", status: "resolvido" };
+    }
+    return resolucaoIndexada;
+}
 export function analisarModulosSelecionadosDrift(estado) {
     const { contexto, mapaImpl, todosSimbolos, mapaRecursos, todosRecursos, todasRotasIndexadas, todosArquivosConhecidos, implsValidos, implsQuebrados, vinculosValidos, vinculosQuebrados, rotasDivergentes, recursosValidos, recursosDivergentes, diagnosticos, tasksResumo, taskPorChave, guardrailsPorTask, resumoVinculosPorTask, arquivosAncoraHerdadosPorTask, } = estado;
     for (const item of contexto.modulosSelecionados) {
@@ -292,7 +307,7 @@ export function analisarModulosSelecionadosDrift(estado) {
                 registro.simbolo = resolucaoSimbolo.simbolo?.simbolo;
             }
             else if (arquivoDeclarado) {
-                const resolucaoArquivo = escolherArquivoPorVinculo(todosArquivosConhecidos, arquivoDeclarado);
+                const resolucaoArquivo = escolherArquivoDeclarado(contexto, todosArquivosConhecidos, arquivoDeclarado);
                 registro.status = resolucaoArquivo.status;
                 registro.confianca = resolucaoArquivo.confianca;
                 registro.arquivo = resolucaoArquivo.arquivo;
@@ -319,14 +334,14 @@ export function analisarModulosSelecionadosDrift(estado) {
                     registro.simbolo = rota.simbolo;
                 }
                 else {
-                    const resolucaoArquivo = escolherArquivoPorVinculo(todosArquivosConhecidos, superficieDeclarada);
+                    const resolucaoArquivo = escolherArquivoDeclarado(contexto, todosArquivosConhecidos, superficieDeclarada);
                     registro.status = resolucaoArquivo.status;
                     registro.confianca = resolucaoArquivo.confianca;
                     registro.arquivo = resolucaoArquivo.arquivo;
                 }
             }
             else {
-                const resolucaoArquivo = escolherArquivoPorVinculo(todosArquivosConhecidos, itemVinculo.vinculo.valor);
+                const resolucaoArquivo = escolherArquivoDeclarado(contexto, todosArquivosConhecidos, itemVinculo.vinculo.valor);
                 registro.status = resolucaoArquivo.status;
                 registro.confianca = resolucaoArquivo.confianca;
                 registro.arquivo = resolucaoArquivo.arquivo;

package/dist/driftOrcamento.js

@@ -112,8 +112,7 @@ export function arquivoEhMigracaoHistoricaImutavel(caminho) {
     const normalizado = caminho.replace(/\\/g, "/").toLowerCase();
     const partes = normalizado.split("/").filter(Boolean);
     const nome = partes.at(-1) ?? "";
-    return partes.includes("supabase")
-        && partes.includes("migrations")
+    return partes.includes("migrations")
         && /^\d{14}_.+\.sql$/.test(nome);
 }
 export function tipoArquivoOrcamento(caminho) {

package/dist/index.d.ts

@@ -1,11 +1,5 @@
 #!/usr/bin/env node
 export * from "./index.part01.js";
-export * from "./index.part02.js";
-export * from "./index.part03.js";
-export * from "./index.part04.js";
-export * from "./index.part05.js";
-export * from "./index.part06.js";
-export * from "./index.part07.js";
 export * from "./index.part08.js";
 export { iniciarProfileAuthor, comandoAuthor, criarAuthorBriefing, revisarClichesAuthor } from "./profileAuthorCommand.js";
 export { validarProfileSemantico } from "./profileCommand.js";

package/dist/index.js

@@ -3,12 +3,6 @@
 // Descricao: CLI particionada; consulte contratos/sema/governanca_ia_contexto.sema antes de editar.
 import { principal } from "./index.part08.js";
 export * from "./index.part01.js";
-export * from "./index.part02.js";
-export * from "./index.part03.js";
-export * from "./index.part04.js";
-export * from "./index.part05.js";
-export * from "./index.part06.js";
-export * from "./index.part07.js";
 export * from "./index.part08.js";
 export { iniciarProfileAuthor, comandoAuthor, criarAuthorBriefing, revisarClichesAuthor } from "./profileAuthorCommand.js";
 export { validarProfileSemantico } from "./profileCommand.js";

package/dist/index.part01.d.ts

@@ -2,7 +2,7 @@ import { compilarCodigo, type IrModulo } from "@sema/nucleo";
 import { analisarDriftLegado, type OpcoesDriftLegado } from "./drift.js";
 import { type GuiaCapacidadeIaMap } from './agentContextTipos.js';
 import { criarBriefingAgente, resumirDriftPorModulo } from "./index.part03.js";
-export type Comando = "iniciar" | "init" | "dev" | "sync" | "chat" | "runner" | "author" | "profile" | "validar" | "ast" | "ir" | "compilar" | "gerar" | "testar" | "diagnosticos" | "verificar" | "inspecionar" | "drift" | "impacto" | "renomear-semantico" | "importar" | "doctor" | "formatar" | "ajuda-ia" | "starter-ia" | "sync-ai-entrypoints" | "instalar-exemplos" | "preflight" | "mcp-instalar-chave" | "rule-packs" | "docs-impacto" | "finalizar-mudanca" | "resumo" | "prompt-curto" | "prompt-ia" | "prompt-ia-ui" | "prompt-ia-react" | "prompt-ia-sema-primeiro" | "exemplos-prompt-ia" | "contexto-ia";
+export type Comando = "iniciar" | "init" | "dev" | "sync" | "author" | "profile" | "validar" | "ast" | "ir" | "compilar" | "gerar" | "testar" | "diagnosticos" | "verificar" | "inspecionar" | "drift" | "impacto" | "renomear-semantico" | "importar" | "doctor" | "formatar" | "ajuda-ia" | "starter-ia" | "sync-ai-entrypoints" | "instalar-exemplos" | "preflight" | "rule-packs" | "docs-impacto" | "finalizar-mudanca" | "resumo" | "prompt-curto" | "prompt-ia" | "prompt-ia-ui" | "prompt-ia-react" | "prompt-ia-sema-primeiro" | "exemplos-prompt-ia" | "contexto-ia";
 export interface ResultadoFormatacaoArquivo {
     caminho: string;
     alterado: boolean;

package/dist/index.part01.js

@@ -109,9 +109,7 @@ export function ajuda() {
             "sema contexto-ia <arquivo.sema> [--saida <diretorio>] [--json]",
             "sema sync-ai-entrypoints [--json]",
             "sema instalar-exemplos [--json]",
-            "sema preflight [comando] [--operation-code <codigo>] [--project-id <uuid>] [--json]",
-            "sema mcp-instalar-chave --stdin [--endpoint <url>] [--control-plane-url <url>] [--dry-run] [--json]",
-            "sema chat doctor [--json]",
+            "sema preflight [comando] [--operation-code <codigo>] [--json]",
             "sema docs-impacto --intencao <acao> [--arquivo <caminho>] [--criar-ausentes] [--json]",
             "sema finalizar-mudanca --intencao <acao> [--arquivo <caminho>] [--doc-lida <caminho>] [--json]",
             "sema author briefing <arquivo.sema> [--json]",

package/dist/index.part04.js

@@ -8,7 +8,7 @@ import { analisarDriftLegado, } from "./drift.js";
 import { resolverDocumentacaoObrigatoria, verificarDocumentacaoMudanca, } from "./docs.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 { ARQUIVO_AGENT_CONTEXT_PACK, ARQUIVO_DOC_AGENTES_CAPACIDADE, ARQUIVO_SEMA_BOOT, ARQUIVO_SEMA_SMALL_MODEL, } from './agentContextTipos.js';
-import { criarGuiaCapacidadeIa, LIMITE_CARACTERES_PAYLOAD_INLINE_MCP } from './agentContextPack.js';
+import { criarGuiaCapacidadeIa, LIMITE_CARACTERES_PAYLOAD_INLINE } from './agentContextPack.js';
 import { criarEntradaCanonicaProjeto } from './agentContext.js';
 import { renderizarDocumentoAgentesPorCapacidade, renderizarSemaBoot, renderizarSemaSmallModel, } from './agentEntryPoints.js';
 import { carregarModulos } from './carregarModulos.js';
@@ -113,7 +113,7 @@ export async function gerarResumoProjetoIa(entrada, pastaSaidaOpcional, escrever
         `TIMEOUT_SEMA: timeout local nao e falha; retry progressivo ${agentContextPack.politicaTimeoutResumo.escalonamentoSegundos.map((segundos) => `${segundos}s`).join(" -> ")}; escopar arquivo se projeto inteiro for lento`,
         `CODIGO_GOVERNADO: ${agentContextPack.politicaCodigoGovernado.marcador} -> chamar Sema antes de editar codigo gerado; validacao inline nao dispensa cabecalho fisico`,
         `ORCAMENTO_SEMANTICO: codigo aviso>${LIMITE_AVISO_LINHAS_CODIGO_GOVERNADO} bloqueio>${LIMITE_BLOQUEIO_LINHAS_CODIGO_GOVERNADO}; .sema aviso>${LIMITE_AVISO_LINHAS_CONTRATO_SEMA} bloqueio>${LIMITE_BLOQUEIO_LINHAS_CONTRATO_SEMA}; .sema por capacidade, nunca parte_1/parte_2; docs Markdown fora do limite de codigo`,
-        `PAYLOAD_MCP: inline>${LIMITE_CARACTERES_PAYLOAD_INLINE_MCP} caracteres nao e timeout; modularize por responsabilidade ou use anexo/caminho autorizado`,
+        `PAYLOAD_INLINE: inline>${LIMITE_CARACTERES_PAYLOAD_INLINE} caracteres nao e timeout; modularize por responsabilidade ou use anexo/caminho autorizado`,
         `SINAL_VS_RITUAL: score/achados/decisaoAgente sao triagem; exigir evidencia concreta alem de palavra-chave ou regex`,
         `DESIGN_VISUAL: se houver UI, moderno obrigatorio; fraca=padrao seguro responsivo; media=tokens+estados; forte=screenshot+assets+microinteracoes`,
         `TOP_MODULOS: ${resumirListaTexto(modulos.map((modulo) => modulo.modulo), 3)}`,
@@ -138,7 +138,7 @@ export async function gerarResumoProjetoIa(entrada, pastaSaidaOpcional, escrever
         `TIMEOUT_SEMA: ${agentContextPack.politicaTimeoutResumo.regra} Escale ${agentContextPack.politicaTimeoutResumo.escalonamentoSegundos.map((segundos) => `${segundos}s`).join(" -> ")} antes de declarar bloqueio.`,
         `CODIGO_GOVERNADO: ${agentContextPack.politicaCodigoGovernado.marcador} -> docs-impacto e drift antes de alterar comportamento`,
         `ORCAMENTO_SEMANTICO: codigo governado acima de ${LIMITE_AVISO_LINHAS_CODIGO_GOVERNADO} linhas exige refatoracao e acima de ${LIMITE_BLOQUEIO_LINHAS_CODIGO_GOVERNADO} bloqueia; .sema acima de ${LIMITE_AVISO_LINHAS_CONTRATO_SEMA} diagnostica e acima de ${LIMITE_BLOQUEIO_LINHAS_CONTRATO_SEMA} bloqueia criacao, edicao, drift, geracao e snapshot; varios .sema podem governar o mesmo arquivo via vinculos`,
-        `PAYLOAD_MCP: conteudo inline acima de ${LIMITE_CARACTERES_PAYLOAD_INLINE_MCP} caracteres deve virar arquivos logicos, anexo, caminho de servidor autorizado ou manifesto; nao aumente timeout para empurrar o mesmo payload`,
+        `PAYLOAD_INLINE: conteudo inline acima de ${LIMITE_CARACTERES_PAYLOAD_INLINE} caracteres deve virar arquivos logicos, anexo, caminho de servidor autorizado ou manifesto; nao aumente timeout para empurrar o mesmo payload`,
         `DESIGN_VISUAL: ${agentContextPack.politicaDesignVisual.regra} Fraca=${agentContextPack.politicaDesignVisual.porCapacidade.fraca} Media=${agentContextPack.politicaDesignVisual.porCapacidade.media} Forte=${agentContextPack.politicaDesignVisual.porCapacidade.forte}`,
         `TOP_MODULOS: ${resumirListaTexto(modulos.map((modulo) => modulo.modulo), 6)}`,
         `TOP_RISCOS: ${resumirListaTexto(unicosOrdenados(modulos.flatMap((modulo) => modulo.riscosPrincipais)), 6)}`,
@@ -252,7 +252,7 @@ Antes de escolher arquivo de código, leia \`${ARQUIVO_SEMA_BOOT}\` e \`agent-co
 
 - Abra \`AGENTS.md\` antes de editar código, contrato, docs operacionais, release ou deploy.
 - Abra \`exemplos/\` antes de criar ou corrigir sintaxe \`.sema\`.
-- Abra \`docs/sintaxe.md\` quando exemplos não bastarem para resolver a gramática.
+- Abra \`docs/syntax.md\` quando exemplos não bastarem para resolver a gramática.
 - Abra \`contratos/\` antes de qualquer implementação ou mudança de comportamento.
 
 ## Timeout e retry

package/dist/index.part08.js

@@ -4,12 +4,9 @@ import path from "node:path";
 import { carregarConfiguracaoProjeto, resolverAlvoPadrao, resolverEstruturaSaidaPadrao, resolverFrameworkPadrao, resolverSaidaPadrao, } from "./projeto.js";
 import { REGISTRO_COMANDOS } from "./comandos.js";
 import * as billing from "./billing/index.js";
-import { ajudaRunnerValidacaoRemota, comandoRunnerValidacaoRemota, } from "./runnerValidacaoRemotaCli.js";
-import { comandoServidorRunnerValidacaoRemota } from "./runnerValidacaoRemotaServidor.js";
 import { comandoIniciar, comandoInstalarExemplos } from './initCommand.js';
 import { obterOpcao, obterPosicionais, possuiFlag } from './cliArgs.js';
 import { comandoAuthor, comandoProfile, criarPayloadRulePacks, normalizarProfileGovernanca, renderizarRulePacksTexto } from './profileAuthorCommand.js';
-import { comandoMcpInstalarChave } from './mcpInstalarChaveCommand.js';
 import { comandoDoctor } from './doctorCommand.js';
 import { normalizarFonteImportacao, normalizarTemplateIniciar, } from './geracaoCore.js';
 import { VERSAO_CLI, ajuda, obterArgumentos } from "./index.part01.js";
@@ -31,7 +28,7 @@ export async function principal() {
     const cwd = process.cwd();
     const posicionais = obterPosicionais(resto);
     let codigoSaida = 0;
-    // --- Comandos registrados via REGISTRO_COMANDOS (mcp-client, bridge-config, contexto-chat, etc.) ---
+    // --- Comandos registrados via REGISTRO_COMANDOS (guard, init, dev, sync) ---
     const handlerRegistrado = REGISTRO_COMANDOS[comando];
     if (handlerRegistrado) {
         codigoSaida = await handlerRegistrado(posicionais, resto, possuiFlag(resto, "--json"));
@@ -55,21 +52,6 @@ export async function principal() {
                 codigoSaida = 0;
             }
             break;
-        case "runner":
-            {
-                const subcomando = posicionais[0];
-                if (subcomando === "validar-remoto") {
-                    codigoSaida = await comandoRunnerValidacaoRemota(resto, cwd);
-                }
-                else if (subcomando === "servidor") {
-                    codigoSaida = await comandoServidorRunnerValidacaoRemota(resto, cwd);
-                }
-                else {
-                    console.log(ajudaRunnerValidacaoRemota());
-                    codigoSaida = subcomando ? 1 : 0;
-                }
-            }
-            break;
         case "validar":
             codigoSaida = possuiFlag(resto, "--json")
                 ? await comandoValidarJson(posicionais[0])
@@ -167,9 +149,6 @@ export async function principal() {
         case "preflight":
             codigoSaida = await billing.comandoPreflightCli(resto, possuiFlag(resto, "--json"));
             break;
-        case "mcp-instalar-chave":
-            codigoSaida = await comandoMcpInstalarChave(resto, possuiFlag(resto, "--json"));
-            break;
         case "docs-impacto":
             codigoSaida = await comandoDocsImpacto(posicionais, resto, possuiFlag(resto, "--json"));
             break;