@semacode/cli 2.3.1 → 3.5.0

package/dist/distribuicao/skillIntentPolicy.js

@@ -0,0 +1,115 @@
+// SEMA-GOVERNED: sema.produto.distribuicao_global.skill.intencoes
+// Descrição: materializa a matriz de intenção da skill sem executar mutações.
+import { versaoSemanticaValida } from "./versaoSemantica.js";
+export const INTENCOES_SKILL_SEMA = [
+    "INFORMAR",
+    "INSTALAR_GLOBAL",
+    "ATUALIZAR_GLOBAL",
+    "REPARAR_GLOBAL",
+    "ADOTAR_WORKSPACE",
+];
+function versaoGlobalValidada(versao) {
+    if (versao === undefined || versao === "latest") {
+        return { solicitada: "latest", resolverLatest: true };
+    }
+    if (versaoSemanticaValida(versao)) {
+        return { solicitada: versao, resolverLatest: false };
+    }
+    throw new Error("VERSAO_GLOBAL_DEVE_SER_SEMVER_EXATA_OU_LATEST");
+}
+const ACOES_RESOLVER_CLI_INSTALADA = [
+    "provar_cli_path_com_versao_e_skill",
+    "provar_launcher_gerenciado_com_versao_e_skill",
+    "preferir_launcher_gerenciado_se_path_stale_ou_sem_skill",
+];
+const ACOES_PROVAR_AMBAS_CLI = [
+    "provar_cli_path_com_versao_e_skill",
+    "provar_launcher_gerenciado_com_versao_e_skill",
+];
+export function planejarIntencaoSkillSema(entrada) {
+    if (["INSTALAR_GLOBAL", "ATUALIZAR_GLOBAL"].includes(entrada.intencao)) {
+        const versao = versaoGlobalValidada(entrada.versaoSolicitada);
+        const acoesInstalacao = versao.resolverLatest
+            ? [
+                "npm_view_version:@semacode/cli@latest",
+                "validar_semver_exata_resolvida",
+                "npm_install_global:@semacode/cli@SEMVER_EXATA_RESOLVIDA",
+            ]
+            : [`npm_install_global:@semacode/cli@${versao.solicitada}`];
+        return {
+            instalar_pacote_global: true,
+            sincronizar_distribuicao_se_necessario: true,
+            mutar_workspace: false,
+            bloqueado_por_autorizacao_adocao: false,
+            resolver_latest_para_semver_exata: versao.resolverLatest,
+            provar_path_e_launcher_gerenciado: true,
+            exigir_prova_versao: true,
+            exigir_status_final_ready: true,
+            acoes_ordenadas: [
+                ...acoesInstalacao,
+                ...ACOES_RESOLVER_CLI_INSTALADA,
+                "provar_versao_instalada",
+                "consultar_status_distribuicao",
+                "sincronizar_distribuicao_se_necessario",
+                "consultar_status_final_ready",
+            ],
+        };
+    }
+    if (entrada.intencao === "REPARAR_GLOBAL") {
+        const cliDisponivel = entrada.cliDisponivel;
+        return {
+            instalar_pacote_global: false,
+            sincronizar_distribuicao_se_necessario: cliDisponivel,
+            mutar_workspace: false,
+            bloqueado_por_autorizacao_adocao: false,
+            resolver_latest_para_semver_exata: false,
+            provar_path_e_launcher_gerenciado: true,
+            exigir_prova_versao: false,
+            exigir_status_final_ready: cliDisponivel,
+            acoes_ordenadas: cliDisponivel
+                ? [
+                    ...ACOES_RESOLVER_CLI_INSTALADA,
+                    "consultar_status_distribuicao",
+                    "sincronizar_distribuicao_se_necessario",
+                    "consultar_status_final_ready",
+                ]
+                : [
+                    ...ACOES_PROVAR_AMBAS_CLI,
+                    "declarar_cli_indisponivel_apos_path_e_launcher_gerenciado_invalidos",
+                ],
+        };
+    }
+    if (entrada.intencao === "ADOTAR_WORKSPACE") {
+        const autorizado = entrada.adocaoAutorizada;
+        return {
+            instalar_pacote_global: false,
+            sincronizar_distribuicao_se_necessario: false,
+            mutar_workspace: autorizado,
+            bloqueado_por_autorizacao_adocao: !autorizado,
+            resolver_latest_para_semver_exata: false,
+            provar_path_e_launcher_gerenciado: false,
+            exigir_prova_versao: false,
+            exigir_status_final_ready: false,
+            acoes_ordenadas: autorizado
+                ? [
+                    "descobrir_explicar_flow_project_adoption",
+                    "iniciar_template_base",
+                    "sync_codex",
+                    "ler_agents_e_boot",
+                ]
+                : ["pedir_autorizacao_adocao"],
+        };
+    }
+    return {
+        instalar_pacote_global: false,
+        sincronizar_distribuicao_se_necessario: false,
+        mutar_workspace: false,
+        bloqueado_por_autorizacao_adocao: false,
+        resolver_latest_para_semver_exata: false,
+        provar_path_e_launcher_gerenciado: false,
+        exigir_prova_versao: false,
+        exigir_status_final_ready: false,
+        acoes_ordenadas: ["responder_sem_mutar"],
+    };
+}
+//# sourceMappingURL=skillIntentPolicy.js.map

package/dist/distribuicao/tipos.d.ts

@@ -0,0 +1,50 @@
+export declare const ESTADOS_DISTRIBUICAO_GLOBAL: readonly ["READY", "MISSING", "STALE", "BROKEN_TARGET", "PERMISSION_DENIED"];
+export type EstadoDistribuicaoGlobal = typeof ESTADOS_DISTRIBUICAO_GLOBAL[number];
+export interface OpcoesAmbienteDistribuicaoGlobal {
+    /** Plataforma usada para escolher o formato do launcher. */
+    plataforma?: NodeJS.Platform;
+    /** Home explícita. A implementação nunca consulta outro diretório quando este valor é informado. */
+    diretorioUsuario?: string;
+    /** Executável absoluto do Node que será embutido no launcher. */
+    executavelNode?: string;
+    /** Raiz absoluta do pacote @semacode/cli instalado. */
+    raizPacote?: string;
+}
+export type CodigoDiagnosticoDistribuicaoGlobal = "AMBIENTE_INVALIDO" | "CAMINHO_FORA_DA_HOME" | "COMPONENTE_NAO_DIRETORIO" | "CONTEUDO_NAO_GERENCIADO" | "DESTINO_ALTERADO" | "DESTINO_AUSENTE" | "DESTINO_DESATUALIZADO" | "DESTINO_PRONTO" | "ERRO_PERMISSAO" | "EXECUTAVEL_NODE_INVALIDO" | "LIMPEZA_PENDENTE" | "LOCK_PERDIDO" | "LOCK_TIMEOUT" | "PACOTE_INVALIDO" | "PERMISSAO_EXECUCAO_INVALIDA" | "RECIBO_INVALIDO" | "ROLLBACK_FALHOU" | "SYMLINK_OU_JUNCTION" | "TARGET_CLI_INVALIDO";
+export interface ResultadoLauncherGlobal {
+    estado: EstadoDistribuicaoGlobal;
+    alterado: boolean;
+    destino_simbolico: "$HOME/.sema/bin/sema" | "$HOME/.sema/bin/sema.cmd";
+    codigo: CodigoDiagnosticoDistribuicaoGlobal;
+    node_absoluto: boolean;
+    entrypoint_absoluto: boolean;
+    recibo_valido: boolean;
+    independente_path: boolean;
+    fallback_simbolico: "$HOME/.sema/bin/sema-managed.ps1" | null;
+}
+export type IdentificadorDestinoSkillGlobal = "agents" | "claude";
+export interface ResultadoDestinoSkillGlobal {
+    id: IdentificadorDestinoSkillGlobal;
+    estado: EstadoDistribuicaoGlobal;
+    alterado: boolean;
+    destino_simbolico: "$HOME/.agents/skills/sema" | "$HOME/.claude/skills/sema";
+    codigo: CodigoDiagnosticoDistribuicaoGlobal;
+}
+export interface ResultadoSkillGlobal {
+    estado: EstadoDistribuicaoGlobal;
+    alterado: boolean;
+    origem_simbolica: "$PACKAGE_ROOT/skills/sema";
+    destino_agents: EstadoDistribuicaoGlobal;
+    destino_claude: EstadoDistribuicaoGlobal | "NOT_DETECTED";
+    espelho_claude_detectado: boolean;
+    ownership_valido: boolean;
+    digest_alinhado: boolean;
+    cache_plugin_intocado: true;
+    destinos: ResultadoDestinoSkillGlobal[];
+}
+export interface ResultadoDistribuicaoGlobal {
+    estado: EstadoDistribuicaoGlobal;
+    alterado: boolean;
+    launcher: ResultadoLauncherGlobal;
+    skill: ResultadoSkillGlobal;
+}

package/dist/distribuicao/tipos.js

@@ -0,0 +1,10 @@
+// SEMA-GOVERNED: sema.produto.distribuicao_global
+// Descrição: define o contrato público e injetável da distribuição local global da CLI e da skill Sema.
+export const ESTADOS_DISTRIBUICAO_GLOBAL = [
+    "READY",
+    "MISSING",
+    "STALE",
+    "BROKEN_TARGET",
+    "PERMISSION_DENIED",
+];
+//# sourceMappingURL=tipos.js.map

package/dist/distribuicao/versaoSemantica.d.ts

@@ -0,0 +1,3 @@
+export declare function versaoSemanticaValida(valor: unknown): valor is string;
+/** Retorna -1, 0 ou 1. Build metadata não participa da precedência SemVer. */
+export declare function compararVersoesSemanticas(a: string, b: string): -1 | 0 | 1;

package/dist/distribuicao/versaoSemantica.js

@@ -0,0 +1,62 @@
+// SEMA-GOVERNED: sema.produto.distribuicao_global
+// Descrição: valida versões SemVer de pacotes e recibos sem rede ou dependência externa.
+const PADRAO_SEMVER = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*))*))?(?:\+([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?$/u;
+function analisar(valor) {
+    if (valor.length > 256)
+        return null;
+    const match = valor.match(PADRAO_SEMVER);
+    if (!match)
+        return null;
+    return {
+        major: BigInt(match[1] ?? "0"),
+        minor: BigInt(match[2] ?? "0"),
+        patch: BigInt(match[3] ?? "0"),
+        prerelease: match[4]?.split(".") ?? null,
+    };
+}
+export function versaoSemanticaValida(valor) {
+    return typeof valor === "string" && analisar(valor) !== null;
+}
+function compararIdentificador(a, b) {
+    const numericoA = /^\d+$/u.test(a);
+    const numericoB = /^\d+$/u.test(b);
+    if (numericoA && numericoB) {
+        const inteiroA = BigInt(a);
+        const inteiroB = BigInt(b);
+        return inteiroA === inteiroB ? 0 : inteiroA > inteiroB ? 1 : -1;
+    }
+    if (numericoA !== numericoB)
+        return numericoA ? -1 : 1;
+    return a === b ? 0 : a > b ? 1 : -1;
+}
+/** Retorna -1, 0 ou 1. Build metadata não participa da precedência SemVer. */
+export function compararVersoesSemanticas(a, b) {
+    const versaoA = analisar(a);
+    const versaoB = analisar(b);
+    if (!versaoA || !versaoB)
+        throw new Error("VERSAO_SEMANTICA_INVALIDA");
+    for (const chave of ["major", "minor", "patch"]) {
+        if (versaoA[chave] !== versaoB[chave])
+            return versaoA[chave] > versaoB[chave] ? 1 : -1;
+    }
+    if (versaoA.prerelease === null || versaoB.prerelease === null) {
+        if (versaoA.prerelease === versaoB.prerelease)
+            return 0;
+        return versaoA.prerelease === null ? 1 : -1;
+    }
+    const limite = Math.max(versaoA.prerelease.length, versaoB.prerelease.length);
+    for (let indice = 0; indice < limite; indice += 1) {
+        const itemA = versaoA.prerelease[indice];
+        const itemB = versaoB.prerelease[indice];
+        if (itemA === undefined || itemB === undefined) {
+            if (itemA === itemB)
+                return 0;
+            return itemA === undefined ? -1 : 1;
+        }
+        const comparacao = compararIdentificador(itemA, itemB);
+        if (comparacao !== 0)
+            return comparacao;
+    }
+    return 0;
+}
+//# sourceMappingURL=versaoSemantica.js.map

package/dist/docs.part01.d.ts

@@ -19,9 +19,10 @@ export interface DocumentoObrigatorioMudanca {
     truncado?: boolean;
     template?: string;
     templatePendente?: boolean;
+    substancia?: boolean;
 }
 export interface BloqueioDocumentacaoMudanca {
-    tipo: "documentacao_ausente" | "leitura_obrigatoria_nao_comprovada" | "documentacao_template_cru" | "arquivo_monolitico" | "codigo_governado_sem_cabecalho";
+    tipo: "documentacao_ausente" | "leitura_obrigatoria_nao_comprovada" | "documentacao_template_cru" | "documentacao_sem_substancia" | "arquivo_monolitico" | "codigo_governado_sem_cabecalho";
     severidade: 4 | 5;
     caminho: string;
     mensagem: string;
@@ -74,6 +75,8 @@ export declare const REGRAS_DOCUMENTACAO: RegraDocumentacao[];
 export declare function inferirCategorias(intencao: string, arquivosAlvo: string[]): string[];
 export declare function criarTemplateDoc(doc: DocumentoPlanejado, intencao: string, categorias: string[], arquivosAlvo: string[]): string;
 export declare function documentoPareceTemplateCriadoPelaSema(conteudo: string): boolean;
+export declare const MINIMO_CARACTERES_SUBSTANCIA_DOC = 120;
+export declare function documentoTemSubstancia(conteudo: string): boolean;
 export declare function resumoConteudo(conteudo: string): {
     conteudo: string;
     truncado: boolean;

package/dist/docs.part01.js

@@ -289,6 +289,14 @@ export function documentoPareceTemplateCriadoPelaSema(conteudo) {
     ].some((placeholder) => texto.includes(placeholder));
     return criadoPelaSema && placeholderPendente;
 }
+export const MINIMO_CARACTERES_SUBSTANCIA_DOC = 120;
+export function documentoTemSubstancia(conteudo) {
+    const texto = normalizarTexto(conteudo)
+        .replace(/[#*_>`|-]/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+    return texto.length >= MINIMO_CARACTERES_SUBSTANCIA_DOC;
+}
 export function resumoConteudo(conteudo) {
     if (conteudo.length <= LIMITE_CONTEUDO_DOC) {
         return { conteudo, truncado: false };

package/dist/docs.part02.js

@@ -4,7 +4,7 @@ import { readFile } from "node:fs/promises";
 import path from "node:path";
 import { emitirDiagnosticosArquivosOrcamento } from "./driftOrcamento.js";
 import { escreverArquivoWorkspaceSeguro, validarDestinosEscritaWorkspace, } from "./workspaceWrite.js";
-import { REGRAS_DOCUMENTACAO, adicionarDocsRaizExistentes, adicionarReadmesDeArquivos, caminhoEstaDentro, caminhoExiste, criarTemplateDoc, documentoPareceTemplateCriadoPelaSema, inferirCategorias, listarArquivosRecursivo, normalizarRelativo, normalizarTexto, resumoConteudo, termosRelacionamentoContratos } from "./docs.part01.js";
+import { REGRAS_DOCUMENTACAO, adicionarDocsRaizExistentes, adicionarReadmesDeArquivos, caminhoEstaDentro, caminhoExiste, criarTemplateDoc, documentoPareceTemplateCriadoPelaSema, documentoTemSubstancia, inferirCategorias, listarArquivosRecursivo, normalizarRelativo, normalizarTexto, resumoConteudo, termosRelacionamentoContratos } from "./docs.part01.js";
 export async function adicionarContratosRelacionados(baseProjeto, intencao, arquivosAlvo, registrar) {
     const pastaContratos = path.join(baseProjeto, "contratos");
     if (!(await caminhoExiste(pastaContratos))) {
@@ -95,6 +95,7 @@ export async function resolverDocumentacaoObrigatoria(opcoes) {
             item.conteudo = conteudo.conteudo;
             item.truncado = conteudo.truncado;
             item.templatePendente = documentoPareceTemplateCriadoPelaSema(conteudoCompleto) || undefined;
+            item.substancia = documentoTemSubstancia(conteudoCompleto);
         }
         leituraObrigatoria.push(item);
     }
@@ -150,6 +151,7 @@ export async function verificarDocumentacaoMudanca(opcoes) {
     const setDocsLidas = new Set(docsLidas);
     const docsNaoLidas = impacto.leituraObrigatoria.filter((doc) => doc.existe && !setDocsLidas.has(doc.relativo));
     const docsTemplatePendentes = impacto.leituraObrigatoria.filter((doc) => (doc.existe && doc.templatePendente && setDocsLidas.has(doc.relativo)));
+    const docsSemSubstancia = impacto.leituraObrigatoria.filter((doc) => (doc.existe && !doc.templatePendente && doc.substancia === false));
     const diagnosticosOrcamento = await emitirDiagnosticosArquivosOrcamento({
         baseProjeto,
         arquivos: opcoes.arquivosAlvo ?? [],
@@ -174,6 +176,12 @@ export async function verificarDocumentacaoMudanca(opcoes) {
             caminho: doc.relativo,
             mensagem: `Documentacao obrigatoria ainda e template cru criado pela Sema: ${doc.relativo}. Edite com procedimento, validacao e rollback reais antes de finalizar.`,
         })),
+        ...docsSemSubstancia.map((doc) => ({
+            tipo: "documentacao_sem_substancia",
+            severidade: 4,
+            caminho: doc.relativo,
+            mensagem: `Documentacao obrigatoria sem substancia: ${doc.relativo}. O conteudo esta praticamente vazio; preencha procedimento, validacao e rollback reais antes de finalizar.`,
+        })),
         ...diagnosticosOrcamento
             .filter((diagnostico) => diagnostico.bloqueia)
             .map((diagnostico) => ({

package/dist/drift.part01.d.ts

@@ -1,8 +1,8 @@
 import type { EngineBanco, NivelConfiancaSemantica, NivelRiscoSemantico, TipoRecursoPersistencia } from "@sema/nucleo";
 import type { ContextoProjetoCarregado } from "./projeto.js";
-import type { PoliticaCacheDrift } from "./driftCache.js";
-import type { MetricasCacheIncrementalDrift } from "./driftCacheIncremental.js";
 import type { MetricasCatalogoDrift, ObservadorOperacaoDrift } from "./driftCatalogo.js";
+import type { CoberturaEscopoDrift, EstrategiaEscopoDrift } from "./driftEscopo.js";
+import type { AvisoModoCacheDrift, ModoCacheDrift } from "./driftCacheModes.js";
 export type OrigemCodigoDrift = "ts" | "js" | "py" | "dart" | "lua" | "cs" | "java" | "go" | "rust" | "cpp" | "php";
 export type OrigemSimboloDrift = OrigemCodigoDrift | "sql";
 export interface SimboloResolvido {
@@ -13,7 +13,7 @@ export interface SimboloResolvido {
 }
 export type ConsumerFramework = "nextjs-consumer" | "react-vite-consumer" | "angular-consumer" | "flutter-consumer";
 export interface RotaResolvida {
-    origem: "nestjs" | "fastapi" | "flask" | "nextjs" | ConsumerFramework | "firebase" | "dotnet" | "java" | "go" | "rust" | "php";
+    origem: "nestjs" | "express" | "fastify" | "fastapi" | "flask" | "nextjs" | ConsumerFramework | "firebase" | "dotnet" | "java" | "go" | "rust" | "php";
     metodo: string;
     caminho: string;
     arquivo: string;
@@ -34,11 +34,12 @@ export interface OpcoesDriftLegado {
     escopo?: EscopoDriftReal;
     ignorarWorktrees?: boolean;
     ignorarConsumidoresLaterais?: boolean;
-    cache?: PoliticaCacheDrift;
-    observador?: ObservadorOperacaoDrift;
+    modoCache?: ModoCacheDrift;
+    avisosModoCache?: readonly AvisoModoCacheDrift[];
+    observador?: ObservadorOperacaoDrift | undefined;
 }
 export interface DiagnosticoDrift {
-    tipo: "impl_quebrado" | "task_sem_impl" | "rota_divergente" | "recurso_divergente" | "vinculo_quebrado" | "seguranca_frouxa" | "pontuacao_semantica_insuficiente" | "contrato_monolitico" | "codigo_monolitico" | "codigo_governado_sem_cabecalho" | "escopo_estreito_sem_vinculos";
+    tipo: "impl_quebrado" | "task_sem_impl" | "rota_divergente" | "recurso_divergente" | "vinculo_quebrado" | "seguranca_frouxa" | "pontuacao_semantica_insuficiente" | "contrato_monolitico" | "codigo_monolitico" | "codigo_governado_sem_cabecalho" | "escopo_estreito_sem_vinculos" | "escopo_estreito_ambiguo";
     modulo: string;
     task?: string;
     route?: string;
@@ -46,6 +47,7 @@ export interface DiagnosticoDrift {
     linhas?: number;
     severidade?: "aviso" | "erro";
     limite_bloqueio_linhas?: number;
+    frameworksEsperados?: string[];
     mensagem: string;
 }
 export interface RegistroImplDrift {
@@ -123,6 +125,11 @@ export interface ResumoTaskDrift {
     implsQuebrados: number;
     semImplementacao: boolean;
     scoreSemantico: number;
+    evidenciaVerificacao?: {
+        sucesso: boolean;
+        quantidadeTestes: number;
+        alvo: string;
+    };
     confiancaVinculo: NivelConfiancaSemantica;
     riscoOperacional: NivelRiscoSemantico;
     lacunas: string[];
@@ -164,28 +171,30 @@ export interface ConfiguracaoEscopoDriftAplicada {
     ignorarWorktrees: boolean;
     ignorarConsumidoresLaterais: boolean;
     termosEscopo: string[];
-    estrategia?: "arquivos_vinculados" | "projeto";
-    cobertura?: "completa" | "parcial";
+    estrategia?: EstrategiaEscopoDrift;
+    cobertura?: CoberturaEscopoDrift;
     arquivosPlanejados?: string[];
     arquivosDeclarados?: string[];
     arquivosInferidos?: string[];
     arquivosAusentes?: string[];
     bloqueios?: string[];
-    cache?: {
-        politica: PoliticaCacheDrift;
-        origem: "cache" | "calculado" | "nao_aplicavel";
-        chave?: string;
-        incremental?: MetricasCacheIncrementalDrift;
-        fasesMs?: {
-            planejamento: number;
-            catalogacao: number;
-            dependencias: number;
-            assinaturas: number;
-            indexacao: number;
-            total: number;
-        };
-    };
     catalogo?: MetricasCatalogoDrift;
+    cache?: EstadoCacheDriftAplicado;
+}
+export interface MetricasCacheDriftAplicado {
+    hits: number;
+    misses: number;
+    corruptos: number;
+    gravacoes: number;
+    errosGravacao: number;
+}
+export interface EstadoCacheDriftAplicado {
+    modo: ModoCacheDrift;
+    origem: "cache" | "calculado" | "indisponivel" | "nao_aplicavel";
+    schema: string;
+    workspaceId?: string;
+    metricas: MetricasCacheDriftAplicado;
+    avisos: readonly AvisoModoCacheDrift[];
 }
 export interface RegistroImpactoSemanticoArquivo {
     arquivo: string;
@@ -278,10 +287,9 @@ export declare function obterDiretoriosIgnoradosAtivos(): Set<string>;
 export declare function definirDiretoriosIgnoradosAtivos(diretorios: Set<string>): void;
 export declare function normalizarFragmentoArquivo(valor: string): string;
 export declare function normalizarEscopoDrift(valor?: string): EscopoDriftReal;
-export type OpcoesDriftLegadoResolvidas = Required<Omit<OpcoesDriftLegado, "observador">> & {
-    observador?: ObservadorOperacaoDrift;
+export declare function resolverOpcoesDrift(opcoes?: OpcoesDriftLegado): Omit<Required<OpcoesDriftLegado>, "observador"> & {
+    observador: ObservadorOperacaoDrift | undefined;
 };
-export declare function resolverOpcoesDrift(opcoes?: OpcoesDriftLegado): OpcoesDriftLegadoResolvidas;
 export declare function resolverDiretoriosIgnoradosAtivos(opcoes?: OpcoesDriftLegado): Set<string>;
 export declare function quebrarTermosEscopo(valor: string): string[];
 export declare function quebrarTermosModuloEscopo(nomeModulo: string): string[];

package/dist/drift.part01.js

@@ -91,7 +91,8 @@ export function resolverOpcoesDrift(opcoes) {
         escopo: normalizarEscopoDrift(opcoes?.escopo),
         ignorarWorktrees: opcoes?.ignorarWorktrees !== false,
         ignorarConsumidoresLaterais: opcoes?.ignorarConsumidoresLaterais !== false,
-        cache: opcoes?.cache === "refresh" || opcoes?.cache === "off" ? opcoes.cache : "auto",
+        modoCache: opcoes?.modoCache ?? "none",
+        avisosModoCache: opcoes?.avisosModoCache ?? [],
         observador: opcoes?.observador,
     };
 }

package/dist/drift.part04.d.ts

@@ -1,8 +1,17 @@
 import ts from "typescript";
 import type { IrModulo, IrSuperficie, IrTask, IrVinculo, NivelConfiancaSemantica, NivelRiscoSemantico } from "@sema/nucleo";
 import { ResultadoDrift, SimboloResolvido } from "./drift.part01.js";
+import type { OrigemCodigoDrift } from "./drift.part01.js";
 import { type PoliticaPontuacaoSemantica } from "./driftScore.js";
-import type { CatalogoDrift } from "./driftCatalogo.js";
+export type EventoLeituraCompartilhadaDrift = "extractor.run" | "ast.create";
+export interface AdaptadorLeituraCompartilhadaDrift {
+    listarPorRaiz(raiz: string, extensoes: readonly string[]): readonly string[] | Promise<readonly string[]>;
+    lerTexto(arquivo: string): Promise<string>;
+    emitir?(tipo: EventoLeituraCompartilhadaDrift, arquivo?: string): void;
+}
+export declare function chaveCaminhoCanonicoDrift(caminho: string): string;
+export declare function deduplicarRaizesSobrepostasDrift(diretorios: readonly string[]): string[];
+export declare function encontrarCandidatosFisicosImplementacaoDrift(simbolos: readonly SimboloResolvido[], origem: OrigemCodigoDrift, caminhoDeclarado: string): SimboloResolvido[];
 export declare function resolverArquivoOuSimboloAncora(vinculos: IrVinculo[], simbolos: SimboloResolvido[], mapaImpl: Map<string, SimboloResolvido>, arquivos: string[]): {
     arquivo?: string;
     simbolo?: string;
@@ -15,7 +24,19 @@ export declare function encontrarAncoraSuperficie(ir: IrModulo, superficie: IrSu
 } | undefined;
 export declare function calcularRiscoOperacional(task: IrTask): NivelRiscoSemantico;
 export declare function calcularConfiancaTask(task: IrTask, implsValidos: number, implsQuebrados: number, vinculosValidos: number, vinculosQuebrados: number): NivelConfiancaSemantica;
-export declare function calcularScoreTask(task: IrTask, implsValidos: number, implsQuebrados: number, vinculosValidos: number, vinculosQuebrados: number, semImplementacao: boolean): number;
+export interface EvidenciaVerificacaoDrift {
+    sucesso: boolean;
+    quantidadeTestes: number;
+    alvo: string;
+}
+export declare function carregarEvidenciaVerificacaoDrift(opcoes: {
+    caminhoContrato: string;
+    nomeModulo: string;
+    alvo: string;
+    framework: string;
+    estrutura: string;
+}): Promise<EvidenciaVerificacaoDrift | undefined>;
+export declare function calcularScoreTask(task: IrTask, implsValidos: number, implsQuebrados: number, vinculosValidos: number, vinculosQuebrados: number, semImplementacao: boolean, evidenciaVerificada?: EvidenciaVerificacaoDrift): number;
 export declare function resumirLacunasTask(task: IrTask, semImplementacao: boolean, implsQuebrados: number, vinculosQuebrados: number, guardrails: {
     publica: boolean;
     sensivel: boolean;
@@ -28,7 +49,7 @@ export declare function resumirLacunasTask(task: IrTask, semImplementacao: boole
     dadosSensiveis: boolean;
     efeitoPrivilegiado: boolean;
     exigeSegredos: boolean;
-}): string[];
+}, evidenciaVerificada?: EvidenciaVerificacaoDrift): string[];
 export declare function resumirOperacional(resultado: Omit<ResultadoDrift, "comando" | "sucesso">, politicaPontuacao?: PoliticaPontuacaoSemantica): ResultadoDrift["resumo_operacional"];
 export declare function paraIdentificadorModulo(valor: string): string;
 export declare function extrairTextoLiteral(expr?: ts.Expression): string | undefined;
@@ -38,9 +59,9 @@ export declare function lerDecorator(node: ts.Node, nomes: string[]): {
     argumentos: ts.NodeArray<ts.Expression>;
 } | undefined;
 export declare function juntarCaminhoHttp(base: string | undefined, sufixo: string | undefined): string;
-export declare function listarArquivosRecursivos(diretorio: string, extensoes: string[], catalogo?: CatalogoDrift): Promise<string[]>;
+export declare function listarArquivosRecursivos(diretorio: string, extensoes: string[], adaptadorLeitura?: AdaptadorLeituraCompartilhadaDrift): Promise<string[]>;
 export declare const EXTENSOES_ARQUIVOS_RASTREAVEIS_DRIFT: string[];
-export declare function indexarArquivosRastreaveis(diretorios: string[], catalogo?: CatalogoDrift): Promise<string[]>;
+export declare function indexarArquivosRastreaveis(diretorios: string[], adaptadorLeitura?: AdaptadorLeituraCompartilhadaDrift): Promise<string[]>;
 export declare function caminhosSimbolicos(baseDiretorio: string, arquivo: string): string[];
 export declare function registrarSimboloTypeScript(simbolos: Map<string, SimboloResolvido>, basesSimbolicas: string[], arquivo: string, nome: string, nomeClasse?: string, origem?: "ts" | "js"): void;
 export declare function desembrulharExpressaoTypeScript(expr: ts.Expression): ts.Expression;