@semacode/cli 1.5.8 → 1.5.9

package/AGENTS.md

@@ -19,7 +19,7 @@ Pense como IA, nao como humano. Voce nao esta "programando" — esta consumindo
 ## MCP
 
 O servidor MCP do Sema roda localmente via: npx -y @semacode/mcp
-Use as ferramentas: sema_resumo, sema_validar, sema_drift, sema_impacto, sema_renomear_semantico, sema_inspecionar, sema_ir, sema_verificar, sema_contexto_ia, sema_prompt_ia, sema_sync_ai_entrypoints, sema_instalar_exemplos.
+Use as ferramentas: sema_resumo, sema_validar, sema_drift, sema_impacto, sema_renomear_semantico, sema_inspecionar, sema_ir, sema_verificar, sema_contexto_ia, sema_prompt_ia, sema_sync_ai_entrypoints, sema_instalar_exemplos, sema_docs_impacto, sema_finalizar_mudanca.
 
 ## Contratos e exemplos
 

package/README.md

@@ -4,6 +4,8 @@
 
 Ela valida contratos `.sema`, mede `drift` entre contrato e codigo vivo, importa legado, gera codigo derivado, produz contexto IA-first e agora governa persistencia vendor-first para `postgres`, `mysql`, `sqlite`, `mongodb` e `redis`.
 
+Tambem resolve documentacao obrigatoria por intencao para impedir IA de agir sem ler ou criar docs relacionadas.
+
 ## Instalar
 
 Global:
@@ -44,6 +46,7 @@ Projeto que ja usa Sema:
 sema inspecionar . --json
 sema resumo contratos/pedidos.sema --micro --para mudanca
 sema drift contratos/pedidos.sema --json
+sema docs-impacto --intencao "alterar pedidos" --arquivo contratos/pedidos.sema --json
 sema contexto-ia contratos/pedidos.sema --saida ./.tmp/contexto --json
 ```
 
@@ -90,6 +93,8 @@ O tarball publico da CLI inclui:
 - `sema resumo <arquivo-ou-pasta> --micro --para onboarding`
 - `sema prompt-curto <arquivo-ou-pasta> --curto --para mudanca`
 - `sema contexto-ia <arquivo.sema> --saida <diretorio> --json`
+- `sema docs-impacto --intencao <acao> [--arquivo <caminho>] [--criar-ausentes] --json`
+- `sema finalizar-mudanca --intencao <acao> [--doc-lida <caminho>] --json`
 - `sema compilar <arquivo-ou-pasta> --alvo <typescript|python|dart|lua> --saida <diretorio>`
 - `sema verificar <arquivo-ou-pasta> --saida <diretorio>`
 

package/SEMA_BRIEF.curto.txt

@@ -5,5 +5,5 @@ ENTRADA_IA: llms.txt -> SEMA_BRIEF.curto.txt -> SEMA_INDEX.json -> AGENTS.md ->
 TOP_MODULOS: app.pedidos, sema.produto.ergonomia_e_dominio, sema.produto.geradores_web, sema.produto.governanca_ia, sema.produto.linguagem_composta, sema.produto.persistencia_vendor_first
 TOP_RISCOS: assistir_renomeacao_semantica:alto, carregar_configuracao_de_persistencia:medio, consultar_scorecard_compatibilidade:medio, converter_bloco_composto_para_ir:alto, converter_persistencia_para_ir_canonico:alto, criar_pedido:alto (+22)
 TOP_LACUNAS: sem_impl, vinculo_quebrado
-TOP_ARQUIVOS: C:\GitHub\Sema\pacotes\cli\src\drift.ts, C:\GitHub\Sema\pacotes\cli\src\importador.ts, C:\GitHub\Sema\pacotes\cli\src\index.ts, C:\GitHub\Sema\pacotes\cli\src\projeto.ts, C:\GitHub\Sema\pacotes\editor-vscode\extension.js, C:\GitHub\Sema\pacotes\gerador-css\src\index.ts (+10)
-GERADO_EM: 2026-05-02T19:48:48.122Z
+TOP_ARQUIVOS: C:\GitHub\Sema\pacotes\cli\src\docs.ts, C:\GitHub\Sema\pacotes\cli\src\drift.ts, C:\GitHub\Sema\pacotes\cli\src\importador.ts, C:\GitHub\Sema\pacotes\cli\src\index.ts, C:\GitHub\Sema\pacotes\cli\src\projeto.ts, C:\GitHub\Sema\pacotes\editor-vscode\extension.js (+11)
+GERADO_EM: 2026-05-02T20:39:52.980Z

package/SEMA_BRIEF.md

@@ -2,7 +2,7 @@
 
 Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto sem ter que catar o repo inteiro feito barata tonta.
 
-- Gerado em: `2026-05-02T19:48:48.122Z`
+- Gerado em: `2026-05-02T20:39:52.980Z`
 - Modulos: `6`
 
 ## Entrada canonica para IA
@@ -42,10 +42,10 @@ Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto
 - Lacunas: sem_impl, vinculo_quebrado
 
 ### sema.produto.governanca_ia
-- Faz: governa 2 superficie(s), 7 task(s) com foco em preparar briefing contextual
+- Faz: governa 2 superficie(s), 9 task(s) com foco em preparar briefing contextual
 - Publico: webhook:confirmar_contexto_publico, worker:preparar_briefing_contextual
-- Tocar: C:\GitHub\Sema\pacotes\cli\src\drift.ts, C:\GitHub\Sema\pacotes\cli\src\index.ts, C:\GitHub\Sema\pacotes\cli\src\projeto.ts, C:\GitHub\Sema\pacotes\editor-vscode\extension.js (+2)
-- Score: 92 | Confianca: alta | Risco: alto
+- Tocar: C:\GitHub\Sema\pacotes\cli\src\docs.ts, C:\GitHub\Sema\pacotes\cli\src\drift.ts, C:\GitHub\Sema\pacotes\cli\src\index.ts, C:\GitHub\Sema\pacotes\cli\src\projeto.ts (+3)
+- Score: 93 | Confianca: alta | Risco: alto
 - Lacunas: sem_impl, vinculo_quebrado
 
 ### sema.produto.linguagem_composta

package/SEMA_BRIEF.micro.txt

@@ -4,4 +4,4 @@ ENTRADA_IA: llms.txt -> SEMA_BRIEF.micro.txt -> SEMA_INDEX.json -> AGENTS.md
 TOP_MODULOS: app.pedidos, sema.produto.ergonomia_e_dominio, sema.produto.geradores_web (+3)
 TOP_RISCOS: assistir_renomeacao_semantica:alto, carregar_configuracao_de_persistencia:medio, consultar_scorecard_compatibilidade:medio (+25)
 TOP_LACUNAS: sem_impl, vinculo_quebrado
-GERADO_EM: 2026-05-02T19:48:48.122Z
+GERADO_EM: 2026-05-02T20:39:52.980Z

package/SEMA_INDEX.json

@@ -1,7 +1,7 @@
 {
   "comando": "resumo-projeto",
-  "geradoEm": "2026-05-02T19:48:48.122Z",
-  "cliVersao": "1.5.7",
+  "geradoEm": "2026-05-02T20:39:52.980Z",
+  "cliVersao": "1.5.9",
   "baseProjeto": "C:\\GitHub\\Sema",
   "totalModulos": 6,
   "entradaCanonica": {
@@ -43,7 +43,13 @@
       "docs/como-ensinar-a-sema-para-ia.md",
       "docs/persistencia-vendor-first.md",
       "docs/sintaxe.md",
-      "docs/cli.md"
+      "docs/cli.md",
+      "docs/mcp.md",
+      "docs/documentacao.md",
+      "docs/deploy.md",
+      "docs/env.md",
+      "docs/rollback.md",
+      "docs/extensao-vscode.md"
     ],
     "guiaPorCapacidade": {
       "pequena": {
@@ -164,7 +170,7 @@
   },
   "modulos": [
     {
-      "geradoEm": "2026-05-02T19:48:48.122Z",
+      "geradoEm": "2026-05-02T20:39:52.980Z",
       "arquivo": "C:\\GitHub\\Sema\\contratos\\pedidos.sema",
       "modulo": "app.pedidos",
       "perfilCompatibilidade": "publico",
@@ -237,7 +243,7 @@
       ]
     },
     {
-      "geradoEm": "2026-05-02T19:48:48.122Z",
+      "geradoEm": "2026-05-02T20:39:52.980Z",
       "arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\ergonomia_e_dominio.sema",
       "modulo": "sema.produto.ergonomia_e_dominio",
       "perfilCompatibilidade": "interno",
@@ -340,7 +346,7 @@
       ]
     },
     {
-      "geradoEm": "2026-05-02T19:48:48.122Z",
+      "geradoEm": "2026-05-02T20:39:52.980Z",
       "arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\geradores_web.sema",
       "modulo": "sema.produto.geradores_web",
       "perfilCompatibilidade": "interno",
@@ -437,33 +443,33 @@
       ]
     },
     {
-      "geradoEm": "2026-05-02T19:48:48.122Z",
+      "geradoEm": "2026-05-02T20:39:52.980Z",
       "arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\governanca_ia.sema",
       "modulo": "sema.produto.governanca_ia",
       "perfilCompatibilidade": "publico",
-      "scoreSemantico": 92,
+      "scoreSemantico": 93,
       "confiancaGeral": "alta",
       "riscoOperacional": "alto",
-      "faz": "governa 2 superficie(s), 7 task(s) com foco em preparar briefing contextual",
+      "faz": "governa 2 superficie(s), 9 task(s) com foco em preparar briefing contextual",
       "tarefasPrincipais": [
         "mapear_projeto_sem_adivinhacao",
         "normalizar_saida_sem_ruido",
         "materializar_exemplos_oficiais",
-        "medir_drift_contra_codigo_vivo",
-        "mapear_impacto_semantico",
-        "assistir_renomeacao_semantica"
+        "resolver_documentacao_obrigatoria_para_mudanca",
+        "validar_leitura_documental_da_mudanca",
+        "medir_drift_contra_codigo_vivo"
       ],
       "entradasChave": [
         "mapear_projeto_sem_adivinhacao(entrada, explicito)",
         "normalizar_saida_sem_ruido(estrutura_desejada)",
         "materializar_exemplos_oficiais(base_projeto, preservar_existentes)",
-        "medir_drift_contra_codigo_vivo(contrato_alvo, codigo_vivo, escopo_real, ignorar_worktrees)"
+        "resolver_documentacao_obrigatoria_para_mudanca(base_projeto, intencao, arquivos_alvo, criar_ausentes)"
       ],
       "saidasChave": [
         "mapear_projeto_sem_adivinhacao(base_resolvida, origens_coerentes, codigo_vivo_detectado)",
         "normalizar_saida_sem_ruido(estrutura_canonica, alias_confuso)",
         "materializar_exemplos_oficiais(exemplos_disponiveis, arquivos_preservados, origem_canonica_resolvida)",
-        "medir_drift_contra_codigo_vivo(impls_resolvidas, rotas_resolvidas, ambiguidades_explicitas, escopo_aplicado)"
+        "resolver_documentacao_obrigatoria_para_mudanca(docs_obrigatorias_resolvidas, leitura_obrigatoria_emitida, docs_ausentes_detectadas, docs_criadas_quando_autorizado)"
       ],
       "superficiesPublicas": [
         "webhook:confirmar_contexto_publico",
@@ -475,16 +481,19 @@
         "arquivos_afetados existe",
         "arquivos_preservados existe",
         "base_resolvida existe",
+        "bloqueio_emitido_quando_falta_leitura existe",
         "casos_especiais_reduzidos existe",
-        "codigo_relacionado_mapeado existe",
-        "codigo_vivo_detectado existe"
+        "codigo_relacionado_mapeado existe"
       ],
       "efeitos": [],
       "erros": [
+        "documentacao_ausente",
+        "leitura_obrigatoria_nao_comprovada",
         "simbolo_ambiguo"
       ],
       "entidadesAfetadas": [],
       "arquivosProvaveis": [
+        "C:\\GitHub\\Sema\\pacotes\\cli\\src\\docs.ts",
         "C:\\GitHub\\Sema\\pacotes\\cli\\src\\drift.ts",
         "C:\\GitHub\\Sema\\pacotes\\cli\\src\\index.ts",
         "C:\\GitHub\\Sema\\pacotes\\cli\\src\\projeto.ts",
@@ -545,6 +554,7 @@
       "consumerBridges": [],
       "ancoragensVinculo": [],
       "arquivosProvaveisEditar": [
+        "C:\\GitHub\\Sema\\pacotes\\cli\\src\\docs.ts",
         "C:\\GitHub\\Sema\\pacotes\\cli\\src\\drift.ts",
         "C:\\GitHub\\Sema\\pacotes\\cli\\src\\index.ts",
         "C:\\GitHub\\Sema\\pacotes\\cli\\src\\projeto.ts",
@@ -554,7 +564,7 @@
       ]
     },
     {
-      "geradoEm": "2026-05-02T19:48:48.122Z",
+      "geradoEm": "2026-05-02T20:39:52.980Z",
       "arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\linguagem_composta.sema",
       "modulo": "sema.produto.linguagem_composta",
       "perfilCompatibilidade": "interno",
@@ -660,7 +670,7 @@
       ]
     },
     {
-      "geradoEm": "2026-05-02T19:48:48.122Z",
+      "geradoEm": "2026-05-02T20:39:52.980Z",
       "arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\persistencia_vendor_first.sema",
       "modulo": "sema.produto.persistencia_vendor_first",
       "perfilCompatibilidade": "interno",

package/dist/docs.d.ts

@@ -0,0 +1,56 @@
+type TipoDocumentoMudanca = "raiz" | "documentacao" | "runbook" | "pacote" | "contrato";
+export interface DocumentoObrigatorioMudanca {
+    caminho: string;
+    relativo: string;
+    tipo: TipoDocumentoMudanca;
+    motivo: string;
+    existe: boolean;
+    criado: boolean;
+    obrigatorio: boolean;
+    conteudo?: string;
+    truncado?: boolean;
+    template?: string;
+}
+export interface BloqueioDocumentacaoMudanca {
+    tipo: "documentacao_ausente" | "leitura_obrigatoria_nao_comprovada";
+    severidade: 4 | 5;
+    caminho: string;
+    mensagem: string;
+}
+export interface ResultadoDocumentacaoObrigatoria {
+    sucesso: boolean;
+    baseProjeto: string;
+    intencao: string;
+    categorias: string[];
+    arquivosAlvo: string[];
+    leituraObrigatoria: DocumentoObrigatorioMudanca[];
+    docsAusentes: DocumentoObrigatorioMudanca[];
+    docsCriadas: DocumentoObrigatorioMudanca[];
+    bloqueios: BloqueioDocumentacaoMudanca[];
+    instrucoes: string[];
+}
+export interface ResultadoVerificacaoDocumentacaoMudanca {
+    sucesso: boolean;
+    baseProjeto: string;
+    intencao: string;
+    categorias: string[];
+    docsLidas: string[];
+    leituraObrigatoria: DocumentoObrigatorioMudanca[];
+    docsNaoLidas: DocumentoObrigatorioMudanca[];
+    docsAusentes: DocumentoObrigatorioMudanca[];
+    diagnosticos: BloqueioDocumentacaoMudanca[];
+    instrucoes: string[];
+}
+export declare function resolverDocumentacaoObrigatoria(opcoes: {
+    baseProjeto?: string;
+    intencao: string;
+    arquivosAlvo?: string[];
+    criarAusentes?: boolean;
+}): Promise<ResultadoDocumentacaoObrigatoria>;
+export declare function verificarDocumentacaoMudanca(opcoes: {
+    baseProjeto?: string;
+    intencao: string;
+    arquivosAlvo?: string[];
+    docsLidas?: string[];
+}): Promise<ResultadoVerificacaoDocumentacaoMudanca>;
+export {};