@semacode/cli 2.3.1 → 3.0.0

package/dist/initTemplatesBase.js

@@ -1,4 +1,4 @@
-// SEMA-GOVERNED: sema.produto.cli_init_templates
+// SEMA-GOVERNED: sema.produto.cli_init_templates, sema.produto.governanca_ia.drift.cache.modos
 // Descrição: contrato base e dispatcher dos templates Codex-native de inicialização.
 import { arquivosInitTemplatesBackend } from "./initTemplatesBackend.js";
 import { arquivosInitTemplatesWeb } from "./initTemplatesWeb.js";
@@ -8,54 +8,54 @@ export function arquivosBaseIniciar() {
     return [
         {
             caminhoRelativo: "contratos/pedidos.sema",
-            conteudo: `module app.pedidos {
-  entity Pedido {
-    fields {
-      id: Id
-      status: Texto
-      total: Decimal
-    }
-  }
-
-  task criar_pedido {
-    input {
-      cliente_id: Id required
-      total: Decimal required
-    }
-    output {
-      pedido_id: Id
-      status: Texto
-    }
-    rules {
-      total > 0
-    }
-    effects {
-      persistencia Pedido criticidade=alta
-      auditoria pedidos
-    }
-    guarantees {
-      pedido_id existe
-      status existe
-    }
-    tests {
-      caso "pedido valido" {
-        given {
-          cliente_id: "cli-1"
-          total: 10
-        }
-        expect {
-          sucesso: verdadeiro
-        }
-      }
-    }
-  }
-
-  route criar_pedido_publico {
-    metodo: POST
-    caminho: /pedidos
-    task: criar_pedido
-  }
-}
+            conteudo: `module app.pedidos {
+  entity Pedido {
+    fields {
+      id: Id
+      status: Texto
+      total: Decimal
+    }
+  }
+
+  task criar_pedido {
+    input {
+      cliente_id: Id required
+      total: Decimal required
+    }
+    output {
+      pedido_id: Id
+      status: Texto
+    }
+    rules {
+      total > 0
+    }
+    effects {
+      persistencia Pedido criticidade=alta
+      auditoria pedidos
+    }
+    guarantees {
+      pedido_id existe
+      status existe
+    }
+    tests {
+      caso "pedido valido" {
+        given {
+          cliente_id: "cli-1"
+          total: 10
+        }
+        expect {
+          sucesso: verdadeiro
+        }
+      }
+    }
+  }
+
+  route criar_pedido_publico {
+    metodo: POST
+    caminho: /pedidos
+    task: criar_pedido
+  }
+}
 `,
         },
     ];
@@ -64,39 +64,41 @@ function arquivosApoioIaIniciar() {
     return [
         {
             caminhoRelativo: "README.md",
-            conteudo: `# Projeto Sema
-
-Este projeto foi inicializado com Sema.
-
-## Entrada oficial do Codex
-
-Antes de alterar codigo, contrato ou documentacao:
-
-1. leia \`AGENTS.md\`;
-2. rode \`sema --version\`;
-3. rode \`sema resumo\`;
+            conteudo: `# Projeto Sema
+
+Este projeto foi inicializado com Sema.
+
+## Entrada oficial do Codex
+
+Antes de alterar codigo, contrato ou documentacao:
+
+1. leia \`AGENTS.md\`;
+2. rode \`sema --version\`; se o shell não localizar o comando, use \`$HOME/.sema/bin/sema\` no macOS/Linux; no Windows, PowerShell usa \`sema.ps1\` no PATH, cmd.exe usa \`sema.cmd\`, e o fallback absoluto é \`& "$env:SystemRoot\\System32\\WindowsPowerShell\\v1.0\\powershell.exe" -NoLogo -NoProfile -NonInteractive -ExecutionPolicy Bypass -File "$HOME\\.sema\\bin\\sema-managed.ps1" --version\`;
+3. rode \`sema resumo --drift none\` para contexto contratual; score, confiança e implementação ficam não avaliados;
 4. rode \`sema docs-impacto --intencao "<acao>" --json\`;
-5. leia \`docs/commands.md\` antes de escolher comando ou interpretar \`--saida\`;
-6. use \`sema descobrir recomendar --intencao "<objetivo>" --json\` quando não souber qual capacidade ou pipeline aplicar;
+5. leia \`docs/commands.md\` antes de escolher comando ou interpretar \`--saida\`;
+6. use \`sema descobrir recomendar --intencao "<objetivo>" --json\` quando não souber qual capacidade ou pipeline aplicar;
 7. use \`exemplos/\` e \`docs/syntax.md\` antes de criar ou corrigir \`.sema\`.
 
-## Estrutura criada
-
-- \`contratos/\`: contratos semanticamente governados.
-- \`AGENTS.md\`: entrypoint oficial do Codex.
-- \`exemplos/\`: exemplos oficiais da DSL Sema.
-- \`docs/commands.md\`: catalogo de comandos, pipelines, gates e regra de \`--saida\`.
-- \`docs/syntax.md\`: referencia curta para escrever \`.sema\`.
-- \`docs/ai-workflow.md\`: fluxo minimo para agentes.
-- \`SEMA_BOOT.md\`, \`SEMA_SMALL_MODEL.md\`, \`AGENT_CONTEXT_PACK.json\` e \`SEMA_INDEX.json\`: contexto IA-first.
-
-## Geracao
-
-O template base ja declara alvo JavaScript. Exemplo:
-
-\`\`\`bash
-sema compilar contratos/pedidos.sema --alvo javascript --saida ./generated/javascript
-\`\`\`
+Quando precisar comprovar o código vivo, rode \`sema drift <contrato.sema> --escopo modulo --cache fresh --json\`. Cache acelera navegação, mas não é prova final de fechamento.
+
+## Estrutura criada
+
+- \`contratos/\`: contratos semanticamente governados.
+- \`AGENTS.md\`: entrypoint oficial do Codex.
+- \`exemplos/\`: exemplos oficiais da DSL Sema.
+- \`docs/commands.md\`: catalogo de comandos, pipelines, gates e regra de \`--saida\`.
+- \`docs/syntax.md\`: referencia curta para escrever \`.sema\`.
+- \`docs/ai-workflow.md\`: fluxo minimo para agentes.
+- \`SEMA_BOOT.md\`, \`SEMA_SMALL_MODEL.md\`, \`AGENT_CONTEXT_PACK.json\` e \`SEMA_INDEX.json\`: contexto IA-first.
+
+## Geracao
+
+O template base ja declara alvo JavaScript. Exemplo:
+
+\`\`\`bash
+sema compilar contratos/pedidos.sema --alvo javascript --saida ./generated/javascript
+\`\`\`
 `,
         },
     ];

package/dist/pipelineConteudo/command.d.ts

@@ -1,3 +1,4 @@
+export { criarAjudaPipelineConteudo } from "./help.js";
 import { HEAD_GENESIS_LEDGER_CONTEUDO } from "./ledger.js";
 export declare function comandoPipelineConteudo(_posicionaisGlobais: string[], args: string[], emJson: boolean): Promise<number>;
 export { HEAD_GENESIS_LEDGER_CONTEUDO };

package/dist/pipelineConteudo/command.js

@@ -1,8 +1,10 @@
-// SEMA-GOVERNED: sema.produto.pipeline_conteudo.cli
+// SEMA-GOVERNED: sema.produto.pipeline_conteudo.cli, sema.produto.cli_invocacao_publica
 // Descrição: CLI declarativa do pipeline de conteúdo; não executa agentes, ferramentas ou publicação.
 import { appendFile, mkdir, readFile, writeFile } from "node:fs/promises";
 import { existsSync, realpathSync } from "node:fs";
 import path from "node:path";
+import { criarAjudaPipelineConteudo } from "./help.js";
+export { criarAjudaPipelineConteudo } from "./help.js";
 import { digestEnvelopeConteudo, hashCanonicoConteudo, } from "./canonical.js";
 import { CAPABILITIES_CONTEUDO_PADRAO, } from "./adapters.js";
 import { anexarEventoLedgerConteudo, HEAD_GENESIS_LEDGER_CONTEUDO, validarLedgerConteudo, validarPayloadEventoConteudo, } from "./ledger.js";
@@ -26,6 +28,7 @@ const OPCOES_COM_VALOR_CONTEUDO = new Set([
     "--revocation-digest",
 ]);
 const SUBCOMANDOS_CONTEUDO = new Set([
+    "ajuda",
     "capabilities",
     "validar",
     "planejar",
@@ -363,11 +366,15 @@ async function registrarEnvelopeLocal(args, ledgerArquivo) {
 }
 export async function comandoPipelineConteudo(_posicionaisGlobais, args, emJson) {
     const posicionais = posicionaisConteudo(args);
-    const subcomando = posicionais[0] ?? "capabilities";
+    const solicitouAjuda = args.includes("--help") || args.includes("-h") || posicionais[0] === "help" || posicionais[0] === "ajuda";
+    const subcomando = solicitouAjuda ? "ajuda" : posicionais[0] ?? "capabilities";
     const comandoPublico = SUBCOMANDOS_CONTEUDO.has(subcomando) ? subcomando : "desconhecido";
     try {
         let payload;
         switch (subcomando) {
+            case "ajuda":
+                payload = criarAjudaPipelineConteudo();
+                break;
             case "capabilities":
                 payload = {
                     sucesso: true,

package/dist/pipelineConteudo/help.d.ts

@@ -0,0 +1,2 @@
+export declare const USOS_PIPELINE_CONTEUDO: readonly ["sema conteudo capabilities --json", "sema conteudo validar <definition.json> --json", "sema conteudo planejar <definition.json> --alvos-arquivo <targets.json> --json", "sema conteudo validar-envelope --envelope-arquivo <envelope.json> --confianca-arquivo <trust.json> --trust-root-digest <sha256:...> --revocation-digest <sha256:...> --payload-type <type> --json", "sema conteudo registrar <ledger.ndjson> --envelope-arquivo <envelope.json> --politica-arquivo <policy-envelope.json> --confianca-arquivo <trust.json> --trust-root-digest <sha256:...> --revocation-digest <sha256:...> --ledger-id <id> --expected-head <sha256:...> --json", "sema conteudo status <definition.json> --politica-arquivo <policy-envelope.json> --confianca-arquivo <trust.json> --trust-root-digest <sha256:...> --revocation-digest <sha256:...> --ledger-arquivo <ledger.ndjson> --expected-head <sha256:...> --json", "sema conteudo projetar <definition.json> --politica-arquivo <policy-envelope.json> --confianca-arquivo <trust.json> --trust-root-digest <sha256:...> --revocation-digest <sha256:...> --ledger-arquivo <ledger.ndjson> --expected-head <sha256:...> --saida <manifest.json> --json"];
+export declare function criarAjudaPipelineConteudo(): Record<string, unknown>;

package/dist/pipelineConteudo/help.js

@@ -0,0 +1,33 @@
+// SEMA-GOVERNED: sema.produto.pipeline_conteudo.cli, sema.produto.cli_invocacao_publica
+// Descrição: renderiza a ajuda pública do pipeline de conteúdo sem carregar o runtime operacional.
+export const USOS_PIPELINE_CONTEUDO = [
+    "sema conteudo capabilities --json",
+    "sema conteudo validar <definition.json> --json",
+    "sema conteudo planejar <definition.json> --alvos-arquivo <targets.json> --json",
+    "sema conteudo validar-envelope --envelope-arquivo <envelope.json> --confianca-arquivo <trust.json> --trust-root-digest <sha256:...> --revocation-digest <sha256:...> --payload-type <type> --json",
+    "sema conteudo registrar <ledger.ndjson> --envelope-arquivo <envelope.json> --politica-arquivo <policy-envelope.json> --confianca-arquivo <trust.json> --trust-root-digest <sha256:...> --revocation-digest <sha256:...> --ledger-id <id> --expected-head <sha256:...> --json",
+    "sema conteudo status <definition.json> --politica-arquivo <policy-envelope.json> --confianca-arquivo <trust.json> --trust-root-digest <sha256:...> --revocation-digest <sha256:...> --ledger-arquivo <ledger.ndjson> --expected-head <sha256:...> --json",
+    "sema conteudo projetar <definition.json> --politica-arquivo <policy-envelope.json> --confianca-arquivo <trust.json> --trust-root-digest <sha256:...> --revocation-digest <sha256:...> --ledger-arquivo <ledger.ndjson> --expected-head <sha256:...> --saida <manifest.json> --json",
+];
+export function criarAjudaPipelineConteudo() {
+    const mensagem = [
+        "Sema Content Pipeline — controle AI-native multicanal e multiformato.",
+        "",
+        "Uso:",
+        ...USOS_PIPELINE_CONTEUDO.map((uso) => `  ${uso}`),
+        "",
+        "O runner é externo e avança somente pelos nextActions derivados pelo Sema.",
+        "Evidências entram como envelopes assinados; vereditos e transições não são escritos manualmente.",
+        "Não existe revisão humana nativa. Chaves privadas permanecem nos processos signatários independentes.",
+    ].join("\n");
+    return {
+        sucesso: true,
+        comando: "ajuda",
+        mensagem,
+        usos: USOS_PIPELINE_CONTEUDO,
+        nativeHumanReview: false,
+        runner: "external",
+        canonicalState: "signed_hash_chained_ledger",
+    };
+}
+//# sourceMappingURL=help.js.map

package/dist/profileAuthorCommand.js

@@ -1,9 +1,5 @@
-// SEMA-GOVERNED: sema.governanca_ia_contexto
-// Descricao: codigo governado pelo Sema; consulte contratos/sema/governanca_ia_contexto.sema antes de editar.
-// SEMA-GOVERNED
-// M?dulo: sema.produto.orcamento_semantico
-// Contrato: contratos/sema/orcamento_semantico.sema
-// Descricao: comandos de profiles semanticos e Author, com gates de score e decis?o de agente.
+// SEMA-GOVERNED: sema.governanca_ia_contexto, sema.produto.governanca_ia.drift.cache.modos
+// Descrição: comando Author com próximos passos explícitos de drift fresh.
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { formatarDiagnosticos, temErros } from "@sema/nucleo";
@@ -123,7 +119,7 @@ export async function criarAuthorBriefing(entrada, preset = null) {
             "sema author validar-narrativa <arquivo> --texto <texto> --json",
             "sema author validar-proibicoes <arquivo> --texto <texto> --json",
             "sema validar <arquivo> --json",
-            "sema drift <arquivo> --json",
+            "sema drift <arquivo> --cache fresh --json",
         ],
         diagnosticos: escolhido.resultado.diagnosticos,
     };

package/dist/profileCommand.js

@@ -1,9 +1,5 @@
-// SEMA-GOVERNED: sema.governanca_ia_contexto
-// Descricao: codigo governado pelo Sema; consulte contratos/sema/governanca_ia_contexto.sema antes de editar.
-// SEMA-GOVERNED
-// M?dulo: sema.produto.orcamento_semantico
-// Contrato: contratos/sema/orcamento_semantico.sema
-// Descricao: comando profile da CLI e renderiza??o de valida??o sem?ntica por profile.
+// SEMA-GOVERNED: sema.produto.orquestracao_profiles, sema.produto.governanca_ia.drift.cache.modos
+// Descrição: comando de profiles com fechamento explícito por drift fresh.
 import { readFile } from "node:fs/promises";
 import path from "node:path";
 import { temErros } from "@sema/nucleo";
@@ -98,7 +94,7 @@ export async function validarProfileSemantico(entrada, profile, opcoes) {
         checks: [
             `sema profile validar ${profile} <arquivo> --preset ${preset ?? "<opcional>"} --artefato-arquivo <artefato> --json`,
             "sema validar <arquivo> --json",
-            "sema drift <arquivo> --escopo modulo --json",
+            "sema drift <arquivo> --escopo modulo --cache fresh --json",
             "sema contexto-ia <arquivo>",
         ],
         diagnosticos: escolhido.resultado.diagnosticos,

package/dist/projetoCarregar.js

@@ -1,18 +1,33 @@
-// SEMA-GOVERNED: sema.produto.governanca_ia.contexto
-// Descrição: orquestra leitura de contratos, compila??o e sele??o de m?dulos do projeto.
+// SEMA-GOVERNED: sema.produto.governanca_ia.contexto, sema.produto.governanca_ia.drift.cache.modos
+// Descrição: orquestra leitura de contratos, compilação e seleção de módulos do projeto.
 import { stat } from 'node:fs/promises';
 import path from 'node:path';
 import { compilarProjeto, listarArquivosSema } from '@sema/nucleo';
-import { carregarFechamentoContratosSema, carregarFontesContratos } from './projetoCatalogo.js';
-import { carregarConfiguracaoProjeto, normalizarModoAdocao } from './projetoConfig.js';
+import { canonicalizarContratosNoProjeto, carregarFechamentoContratosSema, carregarFontesContratos, } from './projetoCatalogo.js';
+import { carregarConfiguracaoProjeto, normalizarFonteLegado, normalizarModoAdocao } from './projetoConfig.js';
 import { inferirFontesLegado } from './projetoLegado.js';
-import { inferirDiretoriosCodigo, listarArquivosDeOrigens, resolverBaseProjeto, resolverEntradaPadrao, resolverOrigensProjeto, } from './projetoOrigens.js';
+import { inferirDiretoriosCodigo, listarArquivosDeOrigens, resolverBaseProjeto, resolverDiretoriosCodigoConfigurados, resolverEntradaPadrao, resolverOrigensProjeto, resolverRaizesLogicasCodigoSemCaminhada, } from './projetoOrigens.js';
+async function resolverDiretoriosCodigoSemCaminhada(baseProjeto, configCarregada) {
+    const declarados = await resolverDiretoriosCodigoConfigurados(baseProjeto, configCarregada);
+    return declarados.length > 0
+        ? declarados
+        : resolverRaizesLogicasCodigoSemCaminhada(baseProjeto);
+}
+function resolverFontesLegadoDeclaradas(configCarregada) {
+    return [...new Set((configCarregada?.config.fontesLegado ?? [])
+            .map((fonte) => normalizarFonteLegado(fonte))
+            .filter((fonte) => Boolean(fonte)))]
+        .sort((a, b) => a.localeCompare(b, "pt-BR"));
+}
 export async function carregarProjeto(entrada, cwd, opcoes = {}) {
     const entradaBase = entrada ? path.resolve(cwd, entrada) : cwd;
     const configCarregada = await carregarConfiguracaoProjeto(entradaBase);
     const entradaResolvida = entrada ? path.resolve(cwd, entrada) : await resolverEntradaPadrao(cwd, configCarregada);
     const baseProjeto = await resolverBaseProjeto(entradaResolvida, configCarregada);
     const infoEntrada = await stat(entradaResolvida);
+    if (infoEntrada.isFile() && path.extname(entradaResolvida).toLowerCase() !== ".sema") {
+        throw new Error(`Entrada de contrato precisa terminar em .sema: ${entradaResolvida}`);
+    }
     const escopo = opcoes.escopo ?? (infoEntrada.isFile() ? "modulo" : "projeto");
     const carregarProjetoCompleto = !infoEntrada.isFile() || escopo === "projeto";
     const origensBase = infoEntrada.isFile()
@@ -27,27 +42,30 @@ export async function carregarProjeto(entrada, cwd, opcoes = {}) {
     if (infoEntrada.isFile()) {
         arquivosDescobertosSet.add(path.resolve(entradaResolvida));
     }
-    const arquivosDescobertos = [...arquivosDescobertosSet]
-        .sort((a, b) => a.localeCompare(b, "pt-BR"));
-    const possuiDiretoriosCodigoExplicitos = Boolean(configCarregada?.config.diretoriosCodigo?.length);
-    const possuiFontesLegadoExplicitas = Boolean(configCarregada?.config.fontesLegado?.length);
-    const diretoriosCodigo = carregarProjetoCompleto || possuiDiretoriosCodigoExplicitos
-        ? await inferirDiretoriosCodigo(baseProjeto, configCarregada)
-        : [];
-    const fontesLegado = carregarProjetoCompleto || possuiFontesLegadoExplicitas
-        ? await inferirFontesLegado(diretoriosCodigo, baseProjeto, configCarregada)
-        : [];
+    const arquivosDescobertos = await canonicalizarContratosNoProjeto(baseProjeto, [...arquivosDescobertosSet]);
+    const entradaContrato = infoEntrada.isFile()
+        ? (await canonicalizarContratosNoProjeto(baseProjeto, [entradaResolvida]))[0]
+        : undefined;
+    // Escopos estreitos recebem apenas raizes logicas declaradas (ou a raiz local)
+    // para que o planner decida o que pode ser tocado antes de qualquer caminhada.
+    const adiarDescobertaCodigo = opcoes.adiarDescobertaCodigo === true;
+    const diretoriosCodigo = adiarDescobertaCodigo
+        ? await resolverDiretoriosCodigoSemCaminhada(baseProjeto, configCarregada)
+        : await inferirDiretoriosCodigo(baseProjeto, configCarregada);
+    const fontesLegado = adiarDescobertaCodigo
+        ? resolverFontesLegadoDeclaradas(configCarregada)
+        : await inferirFontesLegado(diretoriosCodigo, baseProjeto, configCarregada);
     const modoAdocao = normalizarModoAdocao(configCarregada?.config.modoAdocao);
     const arquivosSelecionados = carregarProjetoCompleto && escopo === "projeto"
         ? new Set(arquivosDescobertos.map((arquivo) => path.resolve(arquivo)))
         : infoEntrada.isFile()
-            ? new Set([path.resolve(entradaResolvida)])
+            ? new Set([entradaContrato])
             : new Set((configCarregada && path.resolve(entradaResolvida) === path.resolve(configCarregada.baseDiretorio)
                 ? arquivosDescobertos
                 : await listarArquivosSema(entradaResolvida)).map((arquivo) => path.resolve(arquivo)));
     const fontes = carregarProjetoCompleto
         ? await carregarFontesContratos(arquivosDescobertos)
-        : (await carregarFechamentoContratosSema([entradaResolvida], arquivosDescobertos)).fontes;
+        : (await carregarFechamentoContratosSema([entradaContrato], arquivosDescobertos)).fontes;
     const resultadoProjeto = compilarProjeto(fontes);
     const resultados = new Map(resultadoProjeto.modulos.map((modulo) => [path.resolve(modulo.caminho), modulo]));
     const modulosCarregados = fontes.map((fonte) => ({

package/dist/projetoCatalogo.d.ts

@@ -3,5 +3,6 @@ export interface FechamentoContratosSema {
     fontes: FonteProjeto[];
     dependenciasNaoResolvidas: string[];
 }
+export declare function canonicalizarContratosNoProjeto(baseProjeto: string, arquivos: string[]): Promise<string[]>;
 export declare function carregarFontesContratos(arquivos: string[]): Promise<FonteProjeto[]>;
 export declare function carregarFechamentoContratosSema(arquivosAlvo: string[], arquivosDescobertos: string[]): Promise<FechamentoContratosSema>;

package/dist/projetoCatalogo.js

@@ -1,7 +1,32 @@
 // SEMA-GOVERNED: sema.produto.governanca_ia.contexto
 // Descricao: descobre contratos por caminho e carrega apenas o fechamento transitivo de uses do alvo.
 import path from "node:path";
-import { lerArquivoTexto, parsear, tokenizar, } from "@sema/nucleo";
+import { realpath } from "node:fs/promises";
+import { listarCandidatosUseRelativo, lerArquivoTexto, parsear, tokenizar, } from "@sema/nucleo";
+function caminhoEstaContido(base, alvo) {
+    const relativo = path.relative(base, alvo);
+    return relativo === "" || (relativo !== ".."
+        && !relativo.startsWith(`..${path.sep}`)
+        && !path.isAbsolute(relativo));
+}
+function chaveCaminhoReal(caminho) {
+    return process.platform === "win32" ? caminho.toLocaleLowerCase("en-US") : caminho;
+}
+export async function canonicalizarContratosNoProjeto(baseProjeto, arquivos) {
+    const baseReal = await realpath(path.resolve(baseProjeto));
+    const canonicos = new Map();
+    for (const arquivo of arquivos) {
+        const caminhoReal = await realpath(path.resolve(arquivo));
+        if (!caminhoEstaContido(baseReal, caminhoReal)) {
+            throw new Error(`Contrato resolve fora da base do projeto: ${arquivo}`);
+        }
+        if (path.extname(caminhoReal).toLowerCase() !== ".sema") {
+            throw new Error(`Entrada de contrato precisa terminar em .sema: ${arquivo}`);
+        }
+        canonicos.set(chaveCaminhoReal(caminhoReal), caminhoReal);
+    }
+    return [...canonicos.values()].sort((a, b) => a.localeCompare(b, "pt-BR"));
+}
 function normalizarChaveArquivo(valor) {
     return valor
         .normalize("NFD")
@@ -40,7 +65,7 @@ export async function carregarFechamentoContratosSema(arquivosAlvo, arquivosDesc
         .sort((a, b) => a.localeCompare(b, "pt-BR"));
     const indiceSufixos = criarIndiceSufixos(descobertos);
     const leituras = new Map();
-    const caminhoPorModulo = new Map();
+    const caminhosPorModulo = new Map();
     const lerContrato = (arquivo) => {
         const caminho = path.resolve(arquivo);
         const existente = leituras.get(caminho);
@@ -52,7 +77,9 @@ export async function carregarFechamentoContratosSema(arquivosAlvo, arquivosDesc
             const resultadoLexer = tokenizar(codigo, caminho);
             const resultadoParser = parsear(resultadoLexer.tokens);
             if (resultadoParser.modulo) {
-                caminhoPorModulo.set(resultadoParser.modulo.nome, caminho);
+                const caminhos = caminhosPorModulo.get(resultadoParser.modulo.nome) ?? new Set();
+                caminhos.add(caminho);
+                caminhosPorModulo.set(resultadoParser.modulo.nome, caminhos);
             }
             return {
                 fonte: { caminho, codigo },
@@ -62,30 +89,42 @@ export async function carregarFechamentoContratosSema(arquivosAlvo, arquivosDesc
         leituras.set(caminho, leitura);
         return leitura;
     };
-    const resolverArquivoModulo = async (nomeModulo) => {
-        const jaConhecido = caminhoPorModulo.get(nomeModulo);
-        if (jaConhecido) {
-            return jaConhecido;
-        }
-        const tentados = new Set();
-        for (const chave of chavesSufixoModulo(nomeModulo)) {
-            for (const candidato of indiceSufixos.get(chave) ?? []) {
-                tentados.add(candidato);
-                const contrato = await lerContrato(candidato);
-                if (contrato.modulo?.nome === nomeModulo) {
-                    return candidato;
+    const resolverArquivoModulo = async (nomeModulo, moduloAtual) => {
+        const nomesCandidatos = [
+            nomeModulo,
+            ...listarCandidatosUseRelativo(moduloAtual, nomeModulo),
+        ];
+        for (const nomeCandidato of nomesCandidatos) {
+            const tentados = new Set();
+            const encontrados = new Set(caminhosPorModulo.get(nomeCandidato) ?? []);
+            for (const chave of chavesSufixoModulo(nomeCandidato)) {
+                for (const candidato of indiceSufixos.get(chave) ?? []) {
+                    tentados.add(candidato);
+                    const contrato = await lerContrato(candidato);
+                    if (contrato.modulo?.nome === nomeCandidato) {
+                        encontrados.add(candidato);
+                    }
                 }
             }
-        }
-        // Fallback raro para workspaces que nao seguem a convencao modulo -> nome do arquivo.
-        // Ele so acontece depois que todos os sufixos deterministas falharam.
-        for (const candidato of descobertos) {
-            if (tentados.has(candidato)) {
-                continue;
+            // Fallback raro para workspaces que nao seguem a convencao modulo -> nome do arquivo.
+            // Ele so acontece quando o indice deterministico nao encontrou o modulo desta prioridade.
+            if (encontrados.size === 0) {
+                for (const candidato of descobertos) {
+                    if (tentados.has(candidato)) {
+                        continue;
+                    }
+                    const contrato = await lerContrato(candidato);
+                    if (contrato.modulo?.nome === nomeCandidato) {
+                        encontrados.add(candidato);
+                    }
+                }
+            }
+            if (encontrados.size > 1) {
+                const caminhos = [...encontrados].sort((a, b) => a.localeCompare(b, "pt-BR"));
+                throw new Error(`Modulo Sema ambiguo "${nomeCandidato}" em: ${caminhos.join(", ")}`);
             }
-            const contrato = await lerContrato(candidato);
-            if (contrato.modulo?.nome === nomeModulo) {
-                return candidato;
+            if (encontrados.size === 1) {
+                return [...encontrados][0];
             }
         }
         return undefined;
@@ -106,7 +145,7 @@ export async function carregarFechamentoContratosSema(arquivosAlvo, arquivosDesc
             .filter((use) => use.origem === "sema")
             .map((use) => use.caminho) ?? [];
         for (const use of usesSema) {
-            const dependencia = await resolverArquivoModulo(use);
+            const dependencia = await resolverArquivoModulo(use, contrato.modulo.nome);
             if (!dependencia) {
                 dependenciasNaoResolvidas.add(use);
                 continue;

package/dist/projetoOrigens.d.ts

@@ -1,4 +1,6 @@
 import type { ConfiguracaoProjetoCarregada } from './projetoTipos.js';
+export declare function resolverRaizesLogicasCodigoSemCaminhada(baseProjeto: string): string[];
+export declare function resolverDiretoriosCodigoConfigurados(baseProjeto: string, configCarregada?: ConfiguracaoProjetoCarregada): Promise<string[]>;
 export declare function resolverEntradaPadrao(cwd: string, configCarregada?: ConfiguracaoProjetoCarregada): Promise<string>;
 export declare function listarArquivosDeOrigens(origens: string[]): Promise<string[]>;
 export declare function resolverBaseProjeto(entradaResolvida: string, configCarregada?: ConfiguracaoProjetoCarregada): Promise<string>;