@semacode/cli 3.8.4 → 3.8.5

package/dist/docs.part01.d.ts

@@ -5,6 +5,7 @@ export interface DocumentoPlanejado {
     tipo: TipoDocumentoMudanca;
     motivo: string;
     permitirCriacao: boolean;
+    obrigatoriedade?: "bloqueante" | "recomendada";
 }
 export interface DocumentoObrigatorioMudanca {
     caminho: string;
@@ -20,6 +21,7 @@ export interface DocumentoObrigatorioMudanca {
     template?: string;
     templatePendente?: boolean;
     substancia?: boolean;
+    obrigatoriedade: "bloqueante" | "recomendada";
 }
 export interface BloqueioDocumentacaoMudanca {
     tipo: "documentacao_ausente" | "leitura_obrigatoria_nao_comprovada" | "documentacao_template_cru" | "documentacao_sem_substancia" | "arquivo_monolitico" | "codigo_governado_sem_cabecalho";
@@ -38,6 +40,7 @@ export interface ResultadoDocumentacaoObrigatoria {
     leituraObrigatoria: DocumentoObrigatorioMudanca[];
     docsAusentes: DocumentoObrigatorioMudanca[];
     docsCriadas: DocumentoObrigatorioMudanca[];
+    leituraRecomendada: DocumentoObrigatorioMudanca[];
     bloqueios: BloqueioDocumentacaoMudanca[];
     instrucoes: string[];
 }
@@ -45,6 +48,7 @@ export interface ResultadoVerificacaoDocumentacaoMudanca {
     sucesso: boolean;
     baseProjeto: string;
     intencao: string;
+    leituraRecomendada: DocumentoObrigatorioMudanca[];
     categorias: string[];
     docsLidas: string[];
     leituraObrigatoria: DocumentoObrigatorioMudanca[];

package/dist/docs.part02.js

@@ -51,7 +51,7 @@ export async function resolverDocumentacaoObrigatoria(opcoes) {
     await adicionarDocsRaizExistentes(baseProjeto, registrar);
     for (const regra of REGRAS_DOCUMENTACAO.filter((item) => categorias.includes(item.categoria))) {
         for (const doc of regra.docs) {
-            registrar(doc);
+            registrar({ ...doc, obrigatoriedade: "recomendada" });
         }
     }
     await adicionarReadmesDeArquivos(baseProjeto, arquivosAlvo, registrar);
@@ -87,6 +87,7 @@ export async function resolverDocumentacaoObrigatoria(opcoes) {
             criado,
             criacaoAutomatica: doc.permitirCriacao,
             obrigatorio: true,
+            obrigatoriedade: doc.obrigatoriedade ?? "bloqueante",
             template: existe ? undefined : template,
         };
         if (existe) {
@@ -101,7 +102,7 @@ export async function resolverDocumentacaoObrigatoria(opcoes) {
     }
     const docsAusentes = leituraObrigatoria.filter((doc) => !doc.existe);
     const docsCriadas = leituraObrigatoria.filter((doc) => doc.criado);
-    const bloqueios = docsAusentes.map((doc) => ({
+    const bloqueios = docsAusentes.filter((doc) => doc.obrigatoriedade !== "recomendada").map((doc) => ({
         tipo: "documentacao_ausente",
         severidade: 4,
         caminho: doc.relativo,
@@ -118,6 +119,9 @@ export async function resolverDocumentacaoObrigatoria(opcoes) {
         leituraObrigatoria,
         docsAusentes,
         docsCriadas,
+        leituraRecomendada: leituraObrigatoria
+            .filter((doc) => doc.obrigatoriedade === "recomendada")
+            .map(compactarDocumentoObrigatorio),
         bloqueios,
         instrucoes: [
             "A IA deve ler todos os itens de leituraObrigatoria antes de executar a mudanca.",
@@ -149,9 +153,9 @@ export async function verificarDocumentacaoMudanca(opcoes) {
     });
     const docsLidas = [...new Set((opcoes.docsLidas ?? []).map((doc) => normalizarDocLida(baseProjeto, doc)).filter(Boolean))];
     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 docsNaoLidas = impacto.leituraObrigatoria.filter((doc) => (doc.existe && doc.obrigatoriedade !== "recomendada" && !setDocsLidas.has(doc.relativo)));
+    const docsTemplatePendentes = impacto.leituraObrigatoria.filter((doc) => (doc.existe && doc.obrigatoriedade !== "recomendada" && doc.templatePendente && setDocsLidas.has(doc.relativo)));
+    const docsSemSubstancia = impacto.leituraObrigatoria.filter((doc) => (doc.existe && doc.obrigatoriedade !== "recomendada" && !doc.templatePendente && doc.substancia === false));
     const diagnosticosOrcamento = await emitirDiagnosticosArquivosOrcamento({
         baseProjeto,
         arquivos: opcoes.arquivosAlvo ?? [],
@@ -201,6 +205,7 @@ export async function verificarDocumentacaoMudanca(opcoes) {
         intencao: opcoes.intencao,
         categorias: impacto.categorias,
         docsLidas,
+        leituraRecomendada: impacto.leituraRecomendada,
         leituraObrigatoria: impacto.leituraObrigatoria.map(compactarDocumentoObrigatorio),
         docsNaoLidas: docsNaoLidas.map(compactarDocumentoObrigatorio),
         docsAusentes: impacto.docsAusentes.map(compactarDocumentoObrigatorio),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@semacode/cli",
-  "version": "3.8.4",
+  "version": "3.8.5",
   "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",