@semacode/cli 4.0.0 → 4.1.0

package/dist/cliGrammar.js

@@ -428,11 +428,10 @@ function validarResumo(args, promptCurto) {
     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));
+        && (promptCurto ? !pacote && !pedido && !somentePacote : true);
 }
 function validarComandoBasico(comando, args) {
     const aliasesGeracao = { "-a": "--alvo", "-s": "--saida" };

package/dist/cliHelpTexto.js

@@ -102,7 +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)",
+            "context-pack: sema resumo <arquivo.sema> --micro --para mudanca --drift none --json (compactação determinística automática; use --pedido para focar a seleção)",
         ]),
         "",
         renderizarSecaoAscii("Comandos principais", [
@@ -134,7 +134,7 @@ 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] [--pacote --somente-pacote --pedido <intencao>] [--json]",
+            "sema resumo <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>] [--drift <none|cache|fresh>] [--saida <diretorio>] [--raiz] [--pedido <intencao>] [--somente-pacote] [--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",

package/dist/contextPack.d.ts

@@ -65,7 +65,7 @@ export type ContextPackResult = {
 export declare function selecionarContexto(payload: ContextPackPayload, request: string): ContextPackResult;
 export declare function criarContextPackAPartirDoResumo(input: {
     resumo: ResumoSemanticoModuloIa;
-    pedido: string;
+    pedido?: string;
     modo: string;
     tamanho: TamanhoResumoIa;
     analiseDrift: ContextPackPayload["analiseDrift"];

package/dist/contextPack.js

@@ -15,6 +15,8 @@ function normalizedTokens(value) {
         .filter((token) => token.length >= 4);
 }
 function selectRelevantTasks(tasks, request) {
+    if (request.startsWith("resumo:"))
+        return tasks.slice(0, 8);
     const requestTokens = new Set(normalizedTokens(request));
     const intentRoots = ["cancel", "notific", "export", "reagend", "registr", "consult"];
     const rootedMatches = intentRoots
@@ -115,6 +117,7 @@ export function selecionarContexto(payload, request) {
     };
 }
 export function criarContextPackAPartirDoResumo(input) {
+    const pedido = input.pedido?.trim() || `resumo:${input.tamanho}`;
     return selecionarContexto({
         geradoEm: input.resumo.geradoEm,
         arquivo: input.resumo.arquivo,
@@ -125,6 +128,6 @@ export function criarContextPackAPartirDoResumo(input) {
         guiaPorCapacidade: input.guiaPorCapacidade,
         texto: input.texto,
         resumo: input.resumo,
-    }, input.pedido);
+    }, pedido);
 }
 //# sourceMappingURL=contextPack.js.map

package/dist/index.part06.js

@@ -202,8 +202,8 @@ export async function comandoAjudaIa() {
     ]));
     console.log("");
     console.log(renderizarSecaoAscii("Capacidade de IA", [
-        "fraca: `sema resumo <arquivo> --micro --drift none --json` usa stdout compacto sem inventar evidência de implementação",
-        "média: `sema resumo <arquivo> --curto --drift none --json` + `sema drift <arquivo> --cache fresh --json`",
+        "fraca: `sema resumo <arquivo> --micro --drift none --json` já devolve o context-pack compacto sem inventar evidência de implementação",
+        "média: `sema resumo <arquivo> --curto --drift none --json` já compacta o resumo; use `sema drift <arquivo> --cache fresh --json` quando precisar de evidência do código",
         "forte: `sema contexto-ia <arquivo.sema> --saida <diretorio> --json` materializa o pacote completo",
     ]));
     console.log("");
@@ -214,7 +214,7 @@ export async function comandoAjudaIa() {
         "Use `sema interativo pipelines --json` para jogos, simulações e híbridos 3D, 2D, retro, texto, XR ou headless.",
         "Use `sema sync-codex` para regenerar o contexto governado do Codex na raiz.",
         "Use `sema instalar-exemplos` para materializar `exemplos/` oficiais sem sobrescrever arquivos locais.",
-        "Use `sema resumo <arquivo> --micro --para onboarding --drift none --json` para IA fraca; o resumo contratual vem no stdout e campos derivados ficam não avaliados.",
+        "Use `sema resumo <arquivo> --micro --para onboarding --drift none --json` para IA fraca; o context-pack é automático e campos derivados ficam não avaliados.",
         "Se `sema resumo` ou outro gate estourar timeout local, aumente o timeout e tente de novo; timeout do agente nao e falha do Sema.",
         "Use `sema prompt-curto <arquivo> --curto --para mudanca` para colar contexto em modelo gratuito.",
         "Use `sema prompt-ia`, `sema prompt-ia-ui`, `sema prompt-ia-react` e `sema prompt-ia-sema-primeiro` conforme a tarefa.",
@@ -290,8 +290,8 @@ export async function comandoResumo(entrada, args, emJson) {
     const tamanho = normalizarTamanhoResumo(args);
     const modo = normalizarModoResumo(obterOpcao(args, "--para"));
     const pedido = obterOpcao(args, "--pedido");
-    const pacoteSolicitado = possuiFlag(args, "--pacote");
     const somentePacote = possuiFlag(args, "--somente-pacote");
+    const pedidoExplícito = obterOpcao(args, "--pedido")?.trim();
     const pastaSaida = obterOpcao(args, "--saida");
     const escreverNaRaiz = possuiFlag(args, "--raiz");
     const alvo = entrada ? path.resolve(process.cwd(), entrada) : process.cwd();
@@ -304,22 +304,20 @@ export async function comandoResumo(entrada, args, emJson) {
         const texto = tamanho === "medio"
             ? renderizarResumoModuloMarkdown(resumoSemantico, modo, guiaPorCapacidade)
             : renderizarResumoModuloTexto(resumoSemantico, tamanho, modo);
-        const contextPack = pacoteSolicitado && pedido
-            ? criarContextPackAPartirDoResumo({
-                resumo: resumoSemantico,
-                pedido,
-                modo,
-                tamanho,
-                analiseDrift: {
-                    modo: contexto.drift.modo,
-                    executada: contexto.drift.executada,
-                    sucesso: contexto.drift.sucesso,
-                    aviso: contexto.drift.aviso,
-                },
-                guiaPorCapacidade,
-                texto,
-            })
-            : null;
+        const contextPack = criarContextPackAPartirDoResumo({
+            resumo: resumoSemantico,
+            pedido: pedidoExplícito,
+            modo,
+            tamanho,
+            analiseDrift: {
+                modo: contexto.drift.modo,
+                executada: contexto.drift.executada,
+                sucesso: contexto.drift.sucesso,
+                aviso: contexto.drift.aviso,
+            },
+            guiaPorCapacidade,
+            texto,
+        });
         let pastaResumo;
         let artefatosCompactos = [];
         if (pastaSaida) {
@@ -333,6 +331,10 @@ export async function comandoResumo(entrada, args, emJson) {
                 console.log(JSON.stringify(contextPack, null, 2));
                 return contexto.drift.sucesso === false ? 1 : 0;
             }
+            if (somentePacote) {
+                console.log(JSON.stringify(contextPack, null, 2));
+                return contexto.drift.sucesso === false ? 1 : 0;
+            }
             console.log(JSON.stringify({
                 comando: "resumo",
                 modo,
@@ -350,10 +352,7 @@ export async function comandoResumo(entrada, args, emJson) {
                     avisos: analiseDrift.avisos,
                     cache: contexto.drift.drift?.escopo_aplicado.cache ?? null,
                 },
-                guiaPorCapacidade,
-                resumo: resumoSemantico,
-                texto,
-                ...(contextPack ? { contextPack } : {}),
+                contextPack,
             }, null, 2));
             return contexto.drift.sucesso === false ? 1 : 0;
         }
@@ -361,34 +360,22 @@ export async function comandoResumo(entrada, args, emJson) {
             console.log(`Resumo IA-first gerado em ${pastaResumo}`);
             console.log("");
         }
-        if (contextPack) {
-            console.log(JSON.stringify(contextPack, null, 2));
-            return contexto.drift.sucesso === false ? 1 : 0;
-        }
-        console.log(texto);
+        console.log(JSON.stringify(contextPack, null, 2));
         return contexto.drift.sucesso === false ? 1 : 0;
     }
     const resumoProjeto = await gerarResumoProjetoIa(alvo, pastaSaida, escreverNaRaiz, analiseDrift);
-    const arquivoResumo = tamanho === "micro"
-        ? "SEMA_BRIEF.micro.txt"
-        : tamanho === "curto"
-            ? "SEMA_BRIEF.curto.txt"
-            : "SEMA_BRIEF.md";
-    const texto = await readFile(path.join(resumoProjeto.pastaSaida, arquivoResumo), "utf8");
     const indexTexto = await readFile(path.join(resumoProjeto.pastaSaida, "SEMA_INDEX.json"), "utf8").catch(() => "");
-    const indexPack = pacoteSolicitado && pedido
-        ? selecionarIndiceContexto({
-            modulos: resumoProjeto.modulos,
-            request: pedido,
-            baseProject: resumoProjeto.baseProjeto,
-            generatedAt: resumoProjeto.geradoEm,
-            mode: modo,
-            drift: resumoProjeto.analiseDrift.modo,
-            sourceIndexChars: indexTexto.length,
-        })
-        : null;
+    const indexPack = selecionarIndiceContexto({
+        modulos: resumoProjeto.modulos,
+        request: pedidoExplícito ?? `resumo:${tamanho}`,
+        baseProject: resumoProjeto.baseProjeto,
+        generatedAt: resumoProjeto.geradoEm,
+        mode: modo,
+        drift: resumoProjeto.analiseDrift.modo,
+        sourceIndexChars: indexTexto.length,
+    });
     if (emJson) {
-        if (somentePacote && indexPack) {
+        if (somentePacote) {
             console.log(JSON.stringify(indexPack, null, 2));
             return resumoProjeto.analiseDrift.sucesso === false ? 1 : 0;
         }
@@ -404,20 +391,13 @@ export async function comandoResumo(entrada, args, emJson) {
                 ...resumoProjeto.analiseDrift,
                 avisos: analiseDrift.avisos,
             },
-            guiaPorCapacidade: resumoProjeto.guiaPorCapacidade,
-            modulos: resumoProjeto.modulos,
-            texto,
-            ...(indexPack ? { indexPack } : {}),
+            indexPack,
         }, null, 2));
         return resumoProjeto.analiseDrift.sucesso === false ? 1 : 0;
     }
     console.log(`Resumo IA-first do projeto gerado em ${resumoProjeto.pastaSaida}`);
     console.log("");
-    if (indexPack) {
-        console.log(JSON.stringify(indexPack, null, 2));
-        return resumoProjeto.analiseDrift.sucesso === false ? 1 : 0;
-    }
-    console.log(texto);
+    console.log(JSON.stringify(indexPack, null, 2));
     return resumoProjeto.analiseDrift.sucesso === false ? 1 : 0;
 }
 //# sourceMappingURL=index.part06.js.map

package/dist/indexPack.d.ts

@@ -2,7 +2,7 @@ import type { ResumoSemanticoModuloIa } from "./index.part01.js";
 type EntradaIndice = Pick<ResumoSemanticoModuloIa, "arquivo" | "modulo" | "faz" | "tarefasPrincipais" | "regrasCriticas" | "efeitos" | "riscosPrincipais" | "lacunas" | "arquivosProvaveis" | "checksSugeridos" | "testesMinimos" | "arquivosProvaveisEditar">;
 export type IndexPack = {
     schema: "sema.ai.index-pack/v1";
-    selection: "deterministic_weighted_match";
+    selection: "deterministic_weighted_match" | "deterministic_summary_projection";
     request: string;
     source: {
         command: "resumo-projeto";

package/dist/indexPack.js

@@ -17,7 +17,9 @@ function tokens(value) {
 function correspondeToken(campo, pedido) {
     return tokens(campo).some((token) => [...pedido].some((alvo) => token.startsWith(alvo) || alvo.startsWith(token)));
 }
-function selecionarValores(values, requestTokens, maximo) {
+function selecionarValores(values, requestTokens, maximo, projetarResumoInteiro) {
+    if (projetarResumoInteiro)
+        return values.slice(0, maximo);
     return values
         .map((value, index) => ({
         value,
@@ -32,7 +34,7 @@ function selecionarValores(values, requestTokens, maximo) {
 function estimarTokens(chars) {
     return Math.ceil(chars / 4);
 }
-function compactarModulo(modulo, requestTokens) {
+function compactarModulo(modulo, requestTokens, projetarResumoInteiro) {
     const tarefas = lista(modulo.tarefasPrincipais);
     const regras = lista(modulo.regrasCriticas);
     const efeitos = lista(modulo.efeitos);
@@ -52,36 +54,40 @@ function compactarModulo(modulo, requestTokens) {
         ["lacunas", lacunas, 1],
         ["arquivos", [...arquivos, ...arquivosEditar], 1],
     ];
-    const relevanceScore = camposComPeso.reduce((total, [, values, weight]) => total + values.reduce((subtotal, value) => subtotal + (correspondeToken(value, requestTokens) ? weight : 0), 0), 0);
-    if (relevanceScore === 0)
+    const relevanceScore = projetarResumoInteiro ? 1 : camposComPeso.reduce((total, [, values, weight]) => total + values.reduce((subtotal, value) => subtotal + (correspondeToken(value, requestTokens) ? weight : 0), 0), 0);
+    if (!projetarResumoInteiro && relevanceScore === 0)
         return null;
     return {
         module: texto(modulo.modulo),
         contract: texto(modulo.arquivo),
         relevanceScore,
         purpose: texto(modulo.faz),
-        relevantTasks: selecionarValores(tarefas, requestTokens, 8),
-        criticalRules: selecionarValores(regras, requestTokens, 8),
-        effects: selecionarValores(efeitos, requestTokens, 6),
-        risks: selecionarValores(riscos, requestTokens, 6),
-        knownGaps: selecionarValores(lacunas, requestTokens, 6),
-        likelyFiles: selecionarValores(arquivos, requestTokens, 8),
-        filesToEdit: selecionarValores(arquivosEditar, requestTokens, 8),
-        requiredChecks: selecionarValores(checks, requestTokens, 6),
-        minimumTests: selecionarValores(testes, requestTokens, 6),
+        relevantTasks: selecionarValores(tarefas, requestTokens, 8, projetarResumoInteiro),
+        criticalRules: selecionarValores(regras, requestTokens, 8, projetarResumoInteiro),
+        effects: selecionarValores(efeitos, requestTokens, 6, projetarResumoInteiro),
+        risks: selecionarValores(riscos, requestTokens, 6, projetarResumoInteiro),
+        knownGaps: selecionarValores(lacunas, requestTokens, 6, projetarResumoInteiro),
+        likelyFiles: selecionarValores(arquivos, requestTokens, 8, projetarResumoInteiro),
+        filesToEdit: selecionarValores(arquivosEditar, requestTokens, 8, projetarResumoInteiro),
+        requiredChecks: selecionarValores(checks, requestTokens, 6, projetarResumoInteiro),
+        minimumTests: selecionarValores(testes, requestTokens, 6, projetarResumoInteiro),
     };
 }
 export function selecionarIndiceContexto(input) {
     const request = input.request.trim();
     const requestTokens = new Set(tokens(request));
+    const projetarResumoInteiro = request.length === 0 || request.startsWith("resumo:");
+    const selection = projetarResumoInteiro
+        ? "deterministic_summary_projection"
+        : "deterministic_weighted_match";
     const matches = input.modulos
-        .map((modulo) => compactarModulo(modulo, requestTokens))
+        .map((modulo) => compactarModulo(modulo, requestTokens, projetarResumoInteiro))
         .filter((item) => item !== null)
         .sort((a, b) => b.relevanceScore - a.relevanceScore || a.module.localeCompare(b.module, "pt-BR"))
-        .slice(0, 8);
+        .slice(0, projetarResumoInteiro ? input.modulos.length : 8);
     const base = {
         schema: "sema.ai.index-pack/v1",
-        selection: "deterministic_weighted_match",
+        selection,
         request,
         source: {
             command: "resumo-projeto",
@@ -99,7 +105,7 @@ export function selecionarIndiceContexto(input) {
             omitted: [
                 "SEMA_INDEX.json completo",
                 "agentContextPack duplicado",
-                "módulos sem correspondência literal ou estrutural no pedido",
+                "módulos e campos fora do orçamento da projeção compacta",
                 "catálogo e arquivos não relacionados ao pedido",
             ],
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@semacode/cli",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "Local-first semantic governance CLI for AI agents, proven with Claude, Codex, zCode (GLM) and Kimi: contracts, drift, impact, docs gates, and code generation.",
   "type": "module",
   "icon": "logo.png",