@semacode/cli 3.12.2 → 4.0.0

package/dist/agentEntryPoints.js

@@ -201,7 +201,7 @@ Score composto, \`achados[]\` e \`decisaoAgente\` são sinais para guiar a próx
 - Consultas honestas: \`resumo\` e \`inspecionar\` usam \`--drift none\` por padrão; score, confiança, implementação, rotas e superfícies não observadas ficam nulos/não avaliados.
 - Se uma consulta executar drift explicitamente, \`payload.analiseDrift.sucesso\` expõe o resultado e uma falha solicitada retorna exit code diferente de zero.
 - Cache: \`sema drift\` usa \`fresh\` por padrão. \`--cache none\` ainda executa sem persistência; \`cache\` acelera extrações validadas, mas não é prova final.
-- Fechamento governado: se o \`payload\` de \`sema drift --cache fresh --json\` retornar \`sucesso:false\`, \`vinculos_quebrados\`, \`rotas_divergentes\` ou \`impls_quebrados\`, não diga que passou limpo. Corrija e rode drift de novo.
+- Fechamento governado: se o \`payload\` de \`sema drift --cache fresh --json\` retornar \`sucesso:false\`, \`vinculos_quebrados\`, \`rotas_divergentes\` ou \`impls_quebrados\`, não diga que passou limpo. Corrija e rode drift de novo. \`vinculos_fora_do_escopo\` é informativo: o arquivo existe no workspace fora dos \`diretoriosCodigo\`; siga o \`diretorioSugerido\` do registro para incluir o diretório no \`sema.config.json\` — não bloqueia fechamento.
 - Experiência governada: se a tarefa cria ou altera site, sistema, app, UI, painel, jogo, CLI/TUI ou terminal, prove acabamento moderno, contextual e não genérico. Em UI estreita (ex. 390px), \`document.documentElement.scrollWidth <= document.documentElement.clientWidth\` precisa ser verdadeiro.
 - Caminho fora do workspace local aberto pelo usuário não substitui a pasta local.
 
@@ -265,7 +265,7 @@ Leia isto primeiro se você tem pouco contexto, pouca memória, pouco tool use o
 15. Payload inline acima de ${LIMITE_CARACTERES_PAYLOAD_INLINE} caracteres não é lentidão: divida por responsabilidade; não aumente timeout para tentar passar limite de transporte.
 16. Se aparecer caminho que não pertence ao workspace local aberto pelo usuário, pare e confirme a fonte antes de agir.
 17. Se Sema estourar por timeout local: aumente o timeout e tente de novo. Não trate isso como falha do Sema.
-18. Para fechamento, rode \`sema drift --cache fresh --json\`; cache persistente só acelera navegação e não é prova final. Se o \`payload\` retornar \`sucesso:false\`, \`vinculos_quebrados\`, \`rotas_divergentes\` ou \`impls_quebrados\`, não conclua. Na 3.0.0, não procure campos de domínio no topo do envelope \`sema.cli.result/v1\` nem use \`ok\` como substituto do veredito do payload.
+18. Para fechamento, rode \`sema drift --cache fresh --json\`; cache persistente só acelera navegação e não é prova final. Se o \`payload\` retornar \`sucesso:false\`, \`vinculos_quebrados\`, \`rotas_divergentes\` ou \`impls_quebrados\`, não conclua. \`vinculos_fora_do_escopo\` é informativo com \`diretorioSugerido\` para o \`sema.config.json\`; não bloqueia fechamento. Na 3.0.0, não procure campos de domínio no topo do envelope \`sema.cli.result/v1\` nem use \`ok\` como substituto do veredito do payload.
 19. Se a tarefa tiver site, sistema, app, UI, painel, jogo, CLI/TUI ou terminal: aplique acabamento moderno, contextual, responsivo/ergonômico, com hierarquia clara, estados e evidência. Em UI, valide mobile/desktop e prove \`scrollWidth <= clientWidth\` em viewport estreito como 390px.
 20. Não substitua o contexto Sema por AGENTS.md, README.md, busca local, inferência por nome ou bom senso.
 
@@ -486,7 +486,7 @@ Sinal e evidência:
 - Score composto, \`achados[]\` e \`decisaoAgente\` orientam a ação; abaixo de 80 bloqueia, alvo evolui 0.5 ponto até 100, e nada substitui evidência concreta.
 - Palavra-chave ou regex passando não prova governança se contrato, código e comportamento não batem.
 - \`resumo\` e \`inspecionar\` usam \`--drift none\` por padrão; campos derivados nulos significam não avaliados, nunca zero.
-- \`sema drift --cache fresh --json\` com \`payload.sucesso:false\`, \`payload.vinculos_quebrados\`, \`payload.rotas_divergentes\` ou \`payload.impls_quebrados\` bloqueia fechamento. Cache persistente é aceleração, não prova final.
+- \`sema drift --cache fresh --json\` com \`payload.sucesso:false\`, \`payload.vinculos_quebrados\`, \`payload.rotas_divergentes\` ou \`payload.impls_quebrados\` bloqueia fechamento. \`payload.vinculos_fora_do_escopo\` é informativo com \`diretorioSugerido\` para os \`diretoriosCodigo\`; não bloqueia. Cache persistente é aceleração, não prova final.
 - Caminho fora do workspace local aberto pelo usuário não substitui a pasta local.
 
 Acabamento visual e terminal:
@@ -685,9 +685,9 @@ This is the minimum workflow for Codex in a local workspace.
 
 Contract edit rule: \`.sema\` has its own size budget. Above ${LIMITE_AVISO_LINHAS_CONTRATO_SEMA} lines, plan a split by domain/capability; above ${LIMITE_BLOQUEIO_LINHAS_CONTRATO_SEMA}, do not create or edit before splitting. Do not use parte_1/parte_2 and do not force a 1:1 contract-to-file relationship; several contracts can govern the same file through \`vinculos\`.
 
-Closing rule: the \`payload\` of \`sema drift --cache fresh --json\` must return \`sucesso:true\`. If it reports \`sucesso:false\`, \`vinculos_quebrados\`, \`rotas_divergentes\`, or \`impls_quebrados\`, the task is still blocked. Passing unit tests or a cache hit do not replace fresh green drift. In 3.0.0, \`ok\` describes the CLI result path and never replaces a command-specific domain verdict.
+Closing rule: the \`payload\` of \`sema drift --cache fresh --json\` must return \`sucesso:true\`. If it reports \`sucesso:false\`, \`vinculos_quebrados\`, \`rotas_divergentes\`, or \`impls_quebrados\`, the task is still blocked. Passing unit tests or a cache hit do not replace fresh green drift. \`vinculos_fora_do_escopo\` is informational: the file exists in the workspace outside the configured \`diretoriosCodigo\`, and each entry carries a \`diretorioSugerido\` to add to \`sema.config.json\`; it does not block closure. In 3.0.0, \`ok\` describes the CLI result path and never replaces a command-specific domain verdict.
 
-Focused drift rule: file and module scopes plan their physical file set before cataloging. They never fall back to a whole-project walk when no safe anchor exists. All indexers and semantic-budget checks reuse the same in-memory source read; a global walk is reserved for explicit \`--escopo projeto\`. Code discovery is deferred until that plan exists, homonymous candidates fail as ambiguous, and configured contract origins or code roots resolving outside the workspace are rejected before enumeration. \`inspecionar\`, \`impacto\`, and \`renomear-semantico\` preserve the same directed boundary. Missing unambiguous local dependencies make coverage partial and block success. In Python, an unresolved \`name\` from \`from module import name\` is not itself a missing file after \`module\` resolves: it may be an exported symbol, while a real child module is still included whenever its file exists.
+Focused drift rule: file and module scopes plan their physical file set before cataloging. They never fall back to a whole-project walk when no safe anchor exists. All indexers and semantic-budget checks reuse the same in-memory source read; a global walk is reserved for explicit \`--escopo projeto\`. Code discovery is deferred until that plan exists, homonymous candidates fail as ambiguous, and configured contract origins or code roots resolving outside the workspace are rejected before enumeration. \`inspecionar\`, \`impacto\`, and \`renomear-semantico\` preserve the same directed boundary. Missing unambiguous local dependencies make coverage partial and block success. In Python, an unresolved \`name\` from \`from module import name\` is not itself a missing file after \`module\` resolves: it may be an exported symbol, while a real child module is still included whenever its file exists.
 
 Cache rule: a closure gate should use \`sema drift <contrato> --escopo modulo --cache fresh --json\`. \`--cache none\` executes the same analysis without persistent-cache I/O, while \`--cache cache\` may reuse only extraction data whose schema, workspace identity, Git HEAD, plan, configuration, contracts, member paths, and strong content digests all match. Cache objects are stored in the operating system's user-cache directory, never below the workspace. A hit is acceleration, not evidence: final links, diagnostics, score, and success are always recalculated. Corruption or an unavailable cache degrades to an in-memory calculation.
 
@@ -752,7 +752,7 @@ Then read every required doc returned by \`docs-impacto\`.
 
 ## Contract and Discovery
 
-- \`sema iniciar --template <base|nestjs|fastapi|nextjs-api|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer|node-firebase-worker|aspnet-api|springboot-api|go-http-api|rust-axum-api|cpp-service-bridge> [--force]\`: creates a new Sema project and preserves existing files by default; \`--force\` is the only explicit overwrite path.
+- \`sema iniciar --template <base|nestjs|fastapi|nextjs-api|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer|node-firebase-worker|aspnet-api|springboot-api|go-http-api|rust-axum-api|cpp-service-bridge> [--force]\`: creates a new Sema project and preserves existing files by default; \`--force\` is the only explicit overwrite path. Inside a subfolder of an already governed workspace, the subfolder is registered under \`diretoriosCodigo\` of the ancestral \`sema.config.json\` (safe write, deduplicated) instead of creating a local config; if the parent config cannot be written, the scaffold proceeds and prints the exact line to add.
 - \`sema validar <arquivo-ou-pasta> --json\`: validates \`.sema\` contracts.
 - \`sema diagnosticos <arquivo.sema> --json\`: details errors and warnings.
 - \`sema formatar <arquivo-ou-pasta>\`: formats contracts.
@@ -772,9 +772,9 @@ Then read every required doc returned by \`docs-impacto\`.
 - \`sema verificar <arquivo-ou-pasta> --json\`: runs aggregated final verification.
 - \`sema finalizar-mudanca --intencao "<acao>" --doc-lida <arquivo> --json\`: proves documentation reading before closure.
 
-Honest closure: unwrap drift JSON and treat its command payload as the source of truth. \`payload.sucesso:false\`, non-empty \`payload.vinculos_quebrados\`, non-empty \`payload.rotas_divergentes\`, or non-empty \`payload.impls_quebrados\` mean the change is not complete yet. Do not report "clean drift" without a green payload.
+Honest closure: unwrap drift JSON and treat its command payload as the source of truth. \`payload.sucesso:false\`, non-empty \`payload.vinculos_quebrados\`, non-empty \`payload.rotas_divergentes\`, or non-empty \`payload.impls_quebrados\` mean the change is not complete yet. Do not report "clean drift" without a green payload. \`payload.vinculos_fora_do_escopo\` is informational: the file exists in the workspace outside \`diretoriosCodigo\`, and each entry carries a \`diretorioSugerido\` for \`sema.config.json\`.
 
-Focused drift exposes its planned, declared, inferred, and missing files plus catalog visit/read metrics in \`escopo_aplicado\`. A missing declared file or a missing unambiguous code-referenced dependency is a blocker reported as \`vinculo_quebrado\`; a missing inferred candidate derived from an \`impl\` symbol is informational under \`arquivosAusentesInferidos\` and never blocks an implementation that resolved. For Python \`from module import name\`, Sema still includes \`name\` when it resolves as a real submodule, but never reports the absent submodule candidate as a broken link after the parent module resolved because \`name\` may be a function, class, or variable. File and module scopes fail closed without a safe anchor, with homonymous implementation candidates, or with missing local dependencies; only \`--escopo projeto\` may walk every configured code root. Logical roots such as \`src\` are probed deterministically without a discovery walk. Configured contract origins and code roots are confined before enumeration, and \`inspecionar\`, \`impacto\`, and \`renomear-semantico\` reuse the same directed boundary without reopening arbitrary external paths.
+Focused drift exposes its planned, declared, inferred, and missing files plus catalog visit/read metrics in \`escopo_aplicado\`. A missing declared file or a missing unambiguous code-referenced dependency is a blocker reported as \`vinculo_quebrado\`; a missing inferred candidate derived from an \`impl\` symbol is informational under \`arquivosAusentesInferidos\` and never blocks an implementation that resolved. For Python \`from module import name\`, Sema still includes \`name\` when it resolves as a real submodule, but never reports the absent submodule candidate as a broken link after the parent module resolved because \`name\` may be a function, class, or variable. File and module scopes fail closed without a safe anchor, with homonymous implementation candidates, or with missing local dependencies; only \`--escopo projeto\` may walk every configured code root. Logical roots such as \`src\` are probed deterministically without a discovery walk. Configured contract origins and code roots are confined before enumeration, and \`inspecionar\`, \`impacto\`, and \`renomear-semantico\` reuse the same directed boundary without reopening arbitrary external paths.
 
 Drift analysis and cache modes are explicit:
 
@@ -877,7 +877,7 @@ Spatial model and render mode are orthogonal: \`THREE_D + HEADLESS\` is valid, w
 - Do not stop after \`sema compilar\` if the contract target files still do not exist.
 - Do not replace \`sema compilar\` with \`sema testar\` when the contract requires generated code.
 - Do not create a Markdown report to pretend a gate ran.
-- Do not say drift passed when the unwrapped \`sema drift --cache fresh --json\` payload returned \`sucesso:false\`, a non-empty \`vinculos_quebrados\`, \`rotas_divergentes\`, or \`impls_quebrados\` list.
+- Do not say drift passed when the unwrapped \`sema drift --cache fresh --json\` payload returned \`sucesso:false\`, a non-empty \`vinculos_quebrados\`, \`rotas_divergentes\`, or \`impls_quebrados\` list. \`vinculos_fora_do_escopo\` entries are informational scope hints, not broken links.
 - Do not declare a UI responsive without mobile/desktop proof; horizontal scroll at 390px blocks closure.
 
 Governed code policy: keep the \`SEMA-GOVERNED\` marker, split large code by real responsibility, preserve contract links, and never treat a generated output directory as the final delivery.

package/dist/cliGrammar.js

@@ -35,6 +35,7 @@ const ESTRUTURAS = new Set(["flat", "modulos", "backend"]);
 const ESCOPOS = new Set(["arquivo", "modulo", "projeto"]);
 const MODOS_CACHE = new Set(["none", "cache", "fresh", "off", "auto", "refresh"]);
 const MODOS_RESUMO = new Set(["resumo", "onboarding", "review", "mudanca", "bug", "arquitetura"]);
+const CAPACIDADES_IA = new Set(["fraca", "media", "forte"]);
 const MATURIDADES = new Set([
     "draft", "rascunho", "prototype", "prototipo", "production", "producao",
     "critical", "critico", "critica",
@@ -416,15 +417,22 @@ function validarInterativo(args) {
 }
 function validarResumo(args, promptCurto) {
     const parsed = parsearArgumentos(args, {
-        opcoes: promptCurto ? ["--para"] : ["--para", "--saida", "--drift", "--cache"],
-        flags: promptCurto ? ["--micro", "--curto", "--medio"] : ["--micro", "--curto", "--medio", "--raiz", "--com-drift"],
+        opcoes: promptCurto ? ["--para"] : ["--para", "--saida", "--drift", "--cache", "--pedido"],
+        flags: promptCurto ? ["--micro", "--curto", "--medio"] : ["--micro", "--curto", "--medio", "--raiz", "--com-drift", "--pacote", "--somente-pacote"],
         maxPosicionais: 1,
     });
     if (!parsed)
         return false;
     const tamanhos = ["--micro", "--curto", "--medio"].filter((flag) => parsed.flags.has(flag));
     const modo = valorOpcao(parsed, "--para");
-    return tamanhos.length <= 1 && (!modo || MODOS_RESUMO.has(modo)) && (promptCurto || validarModoCache(parsed, "--drift"));
+    const pacote = parsed.flags.has("--pacote");
+    const somentePacote = parsed.flags.has("--somente-pacote");
+    const pedido = valorOpcao(parsed, "--pedido");
+    const combinacaoPacoteValida = pacote === Boolean(pedido);
+    return tamanhos.length <= 1
+        && (!modo || MODOS_RESUMO.has(modo))
+        && (promptCurto || validarModoCache(parsed, "--drift"))
+        && (promptCurto ? !pacote && !pedido && !somentePacote : combinacaoPacoteValida && (!somentePacote || pacote));
 }
 function validarComandoBasico(comando, args) {
     const aliasesGeracao = { "-a": "--alvo", "-s": "--saida" };
@@ -433,7 +441,11 @@ function validarComandoBasico(comando, args) {
         case "ast":
         case "ir":
         case "diagnosticos": return parsearArgumentos(args, { minPosicionais: 1, maxPosicionais: 1 }) !== null;
-        case "contexto-ia": return parsearArgumentos(args, { opcoes: ["--saida"], minPosicionais: 1, maxPosicionais: 1 }) !== null;
+        case "contexto-ia": {
+            const parsed = parsearArgumentos(args, { opcoes: ["--saida", "--capacidade"], flags: ["--pacote"], minPosicionais: 1, maxPosicionais: 1 });
+            const capacidade = parsed ? valorOpcao(parsed, "--capacidade") : undefined;
+            return parsed !== null && (!capacidade || CAPACIDADES_IA.has(capacidade));
+        }
         case "compilar":
         case "testar": {
             const parsed = parsearArgumentos(args, { opcoes: ["--alvo", "--saida", "--estrutura", "--framework"], aliases: aliasesGeracao, minPosicionais: comando === "testar" ? 1 : 0, maxPosicionais: 1 });
@@ -458,7 +470,7 @@ function validarComandoBasico(comando, args) {
             return parsed !== null && validarModoCache(parsed, "--drift");
         }
         case "drift": {
-            const parsed = parsearArgumentos(args, { opcoes: ["--escopo", "--cache", "--drift"], flags: ["--incluir-worktrees", "--incluir-consumidores-laterais"], maxPosicionais: 1 });
+            const parsed = parsearArgumentos(args, { opcoes: ["--escopo", "--cache", "--drift"], flags: ["--incluir-worktrees", "--incluir-consumidores-laterais", "--pacote"], maxPosicionais: 1 });
             const escopo = parsed ? valorOpcao(parsed, "--escopo") : undefined;
             return parsed !== null && (!escopo || ESCOPOS.has(escopo)) && validarModoCache(parsed, "--cache");
         }

package/dist/cliHelpTexto.js

@@ -26,7 +26,7 @@ export function criarAjudaRaiz(versao) {
         renderizarSecaoAscii("Fluxos rápidos", [
             "[1] Projeto novo / produção inicial",
             "sema iniciar --template <base|nestjs|fastapi|nextjs-api|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer|node-firebase-worker|aspnet-api|springboot-api|go-http-api|rust-axum-api|cpp-service-bridge> [--force] [--com-exemplos]",
-            "Arquivos existentes são preservados; use --force somente para sobrescrita explícita. O starter de exemplos vem por padrão; --com-exemplos instala o pacote completo.",
+            "Arquivos existentes são preservados; use --force somente para sobrescrita explícita. O starter de exemplos vem por padrão; --com-exemplos instala o pacote completo. Em subpasta de workspace já governado, a subpasta é registrada nos diretoriosCodigo do sema.config.json ancestral em vez de criar config local.",
             "sema validar contratos/<modulo>.sema --json",
             "sema compilar <arquivo-ou-pasta> --alvo <typescript|python|php|dart|lua|javascript|html|css|dotnet|cpp> --saida <diretorio>",
             "sema verificar <arquivo-ou-pasta> [--saida <dir>] [--alvo <alvo>] [--sem-cache] --json",
@@ -102,6 +102,7 @@ export function criarAjudaRaiz(versao) {
             "fraca: sema resumo <arquivo> --micro --drift none --json (contrato compacto; implementação não avaliada)",
             "média: sema resumo <arquivo> --curto --drift none --json + sema drift <arquivo> --cache fresh --json",
             "forte: sema contexto-ia <arquivo.sema> --saida <diretorio> --json",
+            "context-pack: sema resumo <arquivo.sema> --micro --para mudanca --drift none --pacote --pedido \"<intenção>\" --json (seleção determinística para a IA)",
         ]),
         "",
         renderizarSecaoAscii("Comandos principais", [
@@ -110,7 +111,7 @@ export function criarAjudaRaiz(versao) {
             "pipelines: sema pipeline <listar|descrever> [id] [--json]",
             "todas as capacidades: sema capabilities [--json]",
             "distribuição global: sema skill <status|sync> [--json] (status é somente leitura; sync repara launcher e skill)",
-            "auditoria: sema drift <arquivo-ou-pasta> [--escopo <arquivo|modulo|projeto>] [--cache <none|cache|fresh>] [--incluir-worktrees] [--incluir-consumidores-laterais] [--json]",
+            "auditoria: sema drift <arquivo-ou-pasta> [--escopo <arquivo|modulo|projeto>] [--cache <none|cache|fresh>] [--incluir-worktrees] [--incluir-consumidores-laterais] [--pacote] [--json]",
             "modos: drift direto usa fresh por padrão; --cache none ainda executa sem cache persistente; resumo/inspecionar usam --drift none por padrão e não fabricam evidência",
             "impacto: sema impacto <arquivo-ou-pasta> --alvo <token> [--mudanca <descricao>] [--escopo <arquivo|modulo|projeto>] [--json]",
             "renomeação: sema renomear-semantico <arquivo-ou-pasta> --de <nome-atual> --para <nome-novo> [--escopo <arquivo|modulo|projeto>] [--json]",
@@ -133,14 +134,14 @@ export function criarAjudaRaiz(versao) {
         renderizarSecaoAscii("Ajuda IA-first", [
             "sema ajuda-ia",
             "sema starter-ia",
-            "sema resumo <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>] [--drift <none|cache|fresh>] [--saida <diretorio>] [--raiz] [--json]",
+            "sema resumo <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>] [--drift <none|cache|fresh>] [--saida <diretorio>] [--raiz] [--pacote --somente-pacote --pedido <intencao>] [--json]",
             "sema prompt-curto <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>] [--json]",
             "sema prompt-ia",
             "sema prompt-ia-ui",
             "sema prompt-ia-react",
             "sema prompt-ia-sema-primeiro",
             "sema exemplos-prompt-ia",
-            "sema contexto-ia <arquivo.sema> [--saida <diretorio>] [--json]",
+            "sema contexto-ia <arquivo.sema> [--saida <diretorio>] [--capacidade <fraca|media|forte>] [--pacote] [--json]",
             "sema sync-codex [--json]",
             "sema instalar-exemplos [--json]",
             "sema sessao [intencao] [entrada] [--json]",

package/dist/contextPack.d.ts

@@ -0,0 +1,75 @@
+import type { ResumoSemanticoModuloIa, TamanhoResumoIa } from "./index.part01.js";
+type ResumoEntrada = Partial<ResumoSemanticoModuloIa>;
+export type ContextPackPayload = {
+    geradoEm?: string;
+    arquivo?: string;
+    modulo?: string;
+    modo?: string;
+    tamanho?: string;
+    analiseDrift?: {
+        modo?: string;
+        executada?: boolean;
+        sucesso?: boolean | null;
+        aviso?: string | null;
+    };
+    guiaPorCapacidade?: unknown;
+    texto?: string;
+    resumo?: ResumoEntrada;
+};
+export type ContextPack = {
+    schema: "sema.ai.context-pack/v1";
+    selection: "deterministic_allowlist";
+    request: string;
+    source: {
+        command: "resumo";
+        mode: string;
+        size: string;
+        drift: string;
+        generatedAt: string | null;
+        contract: string | null;
+    };
+    context: {
+        module: string | null;
+        purpose: string | null;
+        relevantTasks: string[];
+        criticalRules: string[];
+        effects: string[];
+        entities: string[];
+        risks: string[];
+        likelyFiles: string[];
+        requiredChecks: string[];
+        minimumTests: string[];
+        compatibilityProfile: string | null;
+        knownGaps: string[];
+    };
+    authority: {
+        semaRemainsAuthority: true;
+        rawSummaryForwarded: false;
+        executionRequiresFreshValidation: true;
+        omitted: string[];
+    };
+    telemetry: {
+        packChars: number;
+        packEstimatedTokens: number;
+        estimateMethod: "chars_div_4";
+        selectedFields: string[];
+    };
+};
+export type ContextPackResult = {
+    pack: ContextPack;
+    rawSummaryChars: number;
+    rawSummaryEstimatedTokens: number;
+    rawSummaryEstimateMethod: "chars_div_4";
+    reductionPercent: number;
+};
+export declare function selecionarContexto(payload: ContextPackPayload, request: string): ContextPackResult;
+export declare function criarContextPackAPartirDoResumo(input: {
+    resumo: ResumoSemanticoModuloIa;
+    pedido: string;
+    modo: string;
+    tamanho: TamanhoResumoIa;
+    analiseDrift: ContextPackPayload["analiseDrift"];
+    guiaPorCapacidade: unknown;
+    texto: string;
+}): ContextPackResult;
+export {};

package/dist/contextPack.js

@@ -0,0 +1,130 @@
+function list(value) {
+    return Array.isArray(value)
+        ? value.filter((item) => typeof item === "string" && item.length > 0)
+        : [];
+}
+function text(value) {
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+function normalizedTokens(value) {
+    return value
+        .toLocaleLowerCase("pt-BR")
+        .normalize("NFD")
+        .replace(/[\u0300-\u036f]/g, "")
+        .split(/[^a-z0-9_]+/)
+        .filter((token) => token.length >= 4);
+}
+function selectRelevantTasks(tasks, request) {
+    const requestTokens = new Set(normalizedTokens(request));
+    const intentRoots = ["cancel", "notific", "export", "reagend", "registr", "consult"];
+    const rootedMatches = intentRoots
+        .filter((root) => [...requestTokens].some((token) => token.startsWith(root)))
+        .flatMap((root) => tasks.filter((task) => normalizedTokens(task).some((token) => token.startsWith(root))));
+    if (rootedMatches.length > 0)
+        return [...new Set(rootedMatches)];
+    const scored = tasks.map((task, index) => {
+        const taskTokens = normalizedTokens(task);
+        const score = taskTokens.reduce((total, token) => total + (requestTokens.has(token) ? 1 : 0), 0);
+        return { task, index, score };
+    });
+    const selected = scored
+        .filter((item) => item.score > 0)
+        .sort((a, b) => b.score - a.score || a.index - b.index)
+        .map((item) => item.task);
+    return selected.length > 0 ? selected : tasks.slice(0, 3);
+}
+function estimateTokens(chars) {
+    return Math.ceil(chars / 4);
+}
+export function selecionarContexto(payload, request) {
+    const resumo = payload.resumo ?? {};
+    const context = {
+        module: text(resumo.modulo) ?? text(payload.modulo),
+        purpose: text(resumo.faz),
+        relevantTasks: selectRelevantTasks(list(resumo.tarefasPrincipais), request),
+        criticalRules: list(resumo.regrasCriticas),
+        effects: list(resumo.efeitos),
+        entities: list(resumo.entidadesAfetadas),
+        risks: list(resumo.riscosPrincipais),
+        likelyFiles: list(resumo.arquivosProvaveis),
+        requiredChecks: list(resumo.checksSugeridos),
+        minimumTests: list(resumo.testesMinimos),
+        compatibilityProfile: text(resumo.perfilCompatibilidade),
+        knownGaps: list(resumo.lacunas),
+    };
+    const packWithoutTelemetry = {
+        schema: "sema.ai.context-pack/v1",
+        selection: "deterministic_allowlist",
+        request,
+        source: {
+            command: "resumo",
+            mode: text(payload.modo) ?? "mudanca",
+            size: text(payload.tamanho) ?? "micro",
+            drift: text(payload.analiseDrift?.modo) ?? "none",
+            generatedAt: text(resumo.geradoEm) ?? text(payload.geradoEm),
+            contract: text(resumo.arquivo) ?? text(payload.arquivo),
+        },
+        context,
+        authority: {
+            semaRemainsAuthority: true,
+            rawSummaryForwarded: false,
+            executionRequiresFreshValidation: true,
+            omitted: [
+                "cli_result_envelope",
+                "guiaPorCapacidade",
+                "texto_bruto_do_resumo",
+                "metadados_fora_do_escopo",
+            ],
+        },
+    };
+    const packChars = JSON.stringify(packWithoutTelemetry).length;
+    const selectedFields = [
+        "request",
+        "source.module",
+        "source.contract",
+        "context.module",
+        "context.purpose",
+        "context.relevantTasks",
+        "context.criticalRules",
+        "context.effects",
+        "context.entities",
+        "context.risks",
+        "context.likelyFiles",
+        "context.requiredChecks",
+        "context.minimumTests",
+        "context.compatibilityProfile",
+        "context.knownGaps",
+        "authority",
+    ];
+    const pack = {
+        ...packWithoutTelemetry,
+        telemetry: {
+            packChars,
+            packEstimatedTokens: estimateTokens(packChars),
+            estimateMethod: "chars_div_4",
+            selectedFields,
+        },
+    };
+    const rawSummaryChars = JSON.stringify(payload).length;
+    return {
+        pack,
+        rawSummaryChars,
+        rawSummaryEstimatedTokens: estimateTokens(rawSummaryChars),
+        rawSummaryEstimateMethod: "chars_div_4",
+        reductionPercent: rawSummaryChars === 0 ? 0 : Math.round((1 - packChars / rawSummaryChars) * 10000) / 100,
+    };
+}
+export function criarContextPackAPartirDoResumo(input) {
+    return selecionarContexto({
+        geradoEm: input.resumo.geradoEm,
+        arquivo: input.resumo.arquivo,
+        modulo: input.resumo.modulo,
+        modo: input.modo,
+        tamanho: input.tamanho,
+        analiseDrift: input.analiseDrift,
+        guiaPorCapacidade: input.guiaPorCapacidade,
+        texto: input.texto,
+        resumo: input.resumo,
+    }, input.pedido);
+}
+//# sourceMappingURL=contextPack.js.map

package/dist/drift.contrato.d.ts

@@ -19,6 +19,7 @@ export declare function executarDriftCheck(contratos: string[], codigoVivo: stri
     impls_quebrados: number;
     vinculos_validos: number;
     vinculos_quebrados: number;
+    vinculos_fora_do_escopo: number;
     score: number;
     piso_operacional: number;
     alvo_atual: number;

package/dist/drift.contrato.js

@@ -30,6 +30,7 @@ export function executarDriftCheck(contratos, codigoVivo) {
         impls_quebrados: implsQuebrados,
         vinculos_validos: vinculosValidos,
         vinculos_quebrados: vinculosQuebrados,
+        vinculos_fora_do_escopo: 0,
         score,
         piso_operacional: avaliacao.pontuacaoMinimaOperacional,
         alvo_atual: avaliacao.pontuacaoAlvoAtual,

package/dist/drift.part01.d.ts

@@ -39,7 +39,7 @@ export interface OpcoesDriftLegado {
     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" | "escopo_estreito_ambiguo" | "design_nao_declarado";
+    tipo: "impl_quebrado" | "task_sem_impl" | "rota_divergente" | "recurso_divergente" | "vinculo_quebrado" | "vinculo_fora_do_escopo" | "seguranca_frouxa" | "pontuacao_semantica_insuficiente" | "contrato_monolitico" | "codigo_monolitico" | "codigo_governado_sem_cabecalho" | "escopo_estreito_sem_vinculos" | "escopo_estreito_ambiguo" | "design_nao_declarado";
     modulo: string;
     task?: string;
     route?: string;
@@ -149,8 +149,9 @@ export interface RegistroVinculoDrift {
     valor: string;
     arquivo?: string;
     simbolo?: string;
-    status: "resolvido" | "parcial" | "nao_encontrado";
+    status: "resolvido" | "parcial" | "nao_encontrado" | "fora_do_escopo";
     confianca: NivelConfiancaSemantica;
+    diretorioSugerido?: string;
 }
 export interface RegistroPersistenciaRealDrift {
     modulo: string;
@@ -256,6 +257,7 @@ export interface ResultadoDrift {
     impls_quebrados: RegistroImplDrift[];
     vinculos_validos: RegistroVinculoDrift[];
     vinculos_quebrados: RegistroVinculoDrift[];
+    vinculos_fora_do_escopo: RegistroVinculoDrift[];
     rotas_divergentes: RegistroRotaDivergente[];
     recursos_validos: RegistroRecursoDrift[];
     recursos_divergentes: RegistroRecursoDrift[];

package/dist/drift.part11.js

@@ -10,7 +10,8 @@ import { calcularConfiancaTask, calcularRiscoOperacional, calcularScoreTask, car
 import { analisarPersistenciaReal, ordenarCandidatos } from "./drift.part09.js";
 import { simboloEhBridgeConsumer } from "./drift.part05.js";
 import { prepararIndicesDrift } from "./drift.part13.js";
-import { analisarModulosSelecionadosDrift } from "./drift.part14.js";
+import { sondarCaminhosDeclaradosExistentes } from "./driftEscopo.js";
+import { analisarModulosSelecionadosDrift, coletarCaminhosDeclaradosVinculosDrift } from "./drift.part14.js";
 import { resolverPoliticaPontuacaoSemantica } from "./driftScore.js";
 function arquivosVinculadosFisicamenteDrift(contexto, modulo, task) {
     const arquivos = new Set();
@@ -158,6 +159,7 @@ export async function analisarDriftLegado(contexto, opcoes) {
         const implsQuebrados = [];
         const vinculosValidos = [];
         const vinculosQuebrados = [];
+        const vinculosForaDoEscopo = [];
         const rotasDivergentes = [];
         const recursosValidos = [];
         const recursosDivergentes = [];
@@ -209,6 +211,12 @@ export async function analisarDriftLegado(contexto, opcoes) {
         for (const substituicao of substituicoesCaminho) {
             substituicao.implementacao.caminho = substituicao.temporario;
         }
+        // Sonda previa: distingue vinculo apontando para arquivo inexistente de
+        // arquivo existente fora dos diretoriosCodigo (informativo, nao bloqueante).
+        const caminhosDeclaradosVinculos = coletarCaminhosDeclaradosVinculosDrift(contexto);
+        const arquivosDeclaradosExistentes = caminhosDeclaradosVinculos.length > 0
+            ? await sondarCaminhosDeclaradosExistentes(caminhosDeclaradosVinculos, contexto.baseProjeto)
+            : new Map();
         try {
             analisarModulosSelecionadosDrift({
                 contexto,
@@ -222,6 +230,8 @@ export async function analisarDriftLegado(contexto, opcoes) {
                 implsQuebrados,
                 vinculosValidos,
                 vinculosQuebrados,
+                vinculosForaDoEscopo,
+                arquivosDeclaradosExistentes,
                 rotasDivergentes,
                 recursosValidos,
                 recursosDivergentes,
@@ -563,6 +573,7 @@ export async function analisarDriftLegado(contexto, opcoes) {
             impls_quebrados: implsQuebrados,
             vinculos_validos: vinculosValidos,
             vinculos_quebrados: vinculosQuebrados,
+            vinculos_fora_do_escopo: vinculosForaDoEscopo,
             rotas_divergentes: rotasDivergentes,
             recursos_validos: recursosValidos,
             recursos_divergentes: recursosDivergentes,

package/dist/drift.part14.d.ts

@@ -14,6 +14,7 @@ export interface GuardrailsTaskDrift {
     efeitoPrivilegiado: boolean;
     exigeSegredos: boolean;
 }
+export declare function coletarCaminhosDeclaradosVinculosDrift(contexto: ContextoProjetoCarregado): string[];
 export interface ResumoVinculosTaskDrift {
     validos: number;
     quebrados: number;
@@ -31,6 +32,8 @@ export interface EstadoAnaliseModulosDrift {
     implsQuebrados: RegistroImplDrift[];
     vinculosValidos: RegistroVinculoDrift[];
     vinculosQuebrados: RegistroVinculoDrift[];
+    vinculosForaDoEscopo: RegistroVinculoDrift[];
+    arquivosDeclaradosExistentes: ReadonlyMap<string, boolean>;
     rotasDivergentes: RegistroRotaDivergente[];
     recursosValidos: RegistroRecursoDrift[];
     recursosDivergentes: RegistroRecursoDrift[];