@semacode/cli 1.0.0 → 1.1.0

package/AGENTS.md

@@ -0,0 +1,50 @@
+# AGENTS.md
+
+Sema e IA-first. Este repositorio nao foi desenhado para ergonomia humana como objetivo principal.
+
+Se voce for uma IA, nao comece pelo codigo cru. Comece pela trilha canonica:
+
+1. `llms.txt`
+2. `SEMA_BRIEF.md`
+3. `SEMA_INDEX.json`
+4. `README.md`
+5. `docs/AGENT_STARTER.md`
+
+Roteamento por capacidade:
+
+- IA pequena ou gratuita: `llms.txt` -> `SEMA_BRIEF.micro.txt` -> `SEMA_INDEX.json` -> `README.md`
+- IA media: `llms.txt` -> `SEMA_BRIEF.curto.txt` -> `SEMA_INDEX.json` -> `README.md` -> `docs/AGENT_STARTER.md`
+- IA grande ou com tool use: `llms-full.txt` -> `SEMA_BRIEF.md` -> `SEMA_INDEX.json` -> `README.md` -> `docs/AGENT_STARTER.md`
+
+Fontes de verdade:
+
+1. artefatos Sema gerados ou versionados na raiz
+2. JSON da CLI
+3. docs oficiais
+4. exemplos oficiais
+5. codigo vivo
+
+Regras:
+
+- trate a Sema como camada semantica para IA operar backend vivo com menos adivinhacao
+- preserve contrato, vinculo, execucao, erro, efeito, garantia, score, confianca e lacunas
+- se existir artefato Sema para a tarefa, use-o antes de abrir o codigo
+- nao trate texto solto como mais confiavel que `drift`, `ir`, `diagnosticos` ou `briefing`
+- se a IA for pequena, nao tente carregar AST e IR de cara
+- nao invente sintaxe fora da gramatica oficial
+
+Comandos minimos:
+
+- `sema resumo <arquivo-ou-pasta> --micro --para mudanca`
+- `sema prompt-curto <arquivo-ou-pasta> --curto --para review`
+- `sema drift <arquivo-ou-pasta> --json`
+- `sema contexto-ia <arquivo.sema> --saida ./.tmp/contexto --json`
+- `sema validar <arquivo-ou-pasta> --json`
+- `sema verificar <arquivo-ou-pasta> --json`
+
+Se a tarefa envolver edicao real:
+
+1. leia o menor artefato que resolver
+2. suba para `drift` e `briefing` antes de editar
+3. use `diagnosticos` para correcao
+4. valide e verifique no fim

package/README.md

@@ -13,6 +13,19 @@ Este pacote entrega a CLI oficial para:
 - gerar resumo compacto por capacidade de IA
 - preparar contexto para IA
 
+Quando a CLI roda em projeto, a trilha IA-first recomendada fica assim:
+
+- raiz do repo: `llms.txt`, `SEMA_BRIEF.*`, `SEMA_INDEX.json`, `AGENTS.md`, `README.md`
+- modulo alvo: `resumo.micro.txt`, `briefing.min.json`, `prompt-curto.txt`, `drift.json`, `briefing.json`
+
+Isto nao existe para agradar humano. Existe para a IA achar o contexto certo sem entupir a janela com lixo.
+
+Para regenerar os entrypoints IA-first da raiz:
+
+```bash
+sema sync-ai-entrypoints --json
+```
+
 ## Instalacao pelo npm registry
 
 ```bash
@@ -23,7 +36,7 @@ sema --help
 ## Instalacao via tarball da release
 
 ```bash
-npm install -g ./sema-cli-1.0.0.tgz
+npm install -g ./sema-cli-1.1.0.tgz
 ```
 
 Ou direto da GitHub Release:
@@ -42,7 +55,7 @@ npx sema --help
 Ou, se voce estiver testando um tarball local:
 
 ```bash
-npm install ./sema-cli-1.0.0.tgz
+npm install ./sema-cli-1.1.0.tgz
 npx sema --help
 ```
 

package/SEMA_BRIEF.curto.txt

@@ -0,0 +1,9 @@
+PROJETO: Sema
+BASE: C:\GitHub\Sema
+MODULOS: 4
+ENTRADA_IA: llms.txt -> SEMA_BRIEF.curto.txt -> SEMA_INDEX.json -> AGENTS.md -> README.md
+TOP_MODULOS: app.pedidos, sema.produto.ergonomia_e_dominio, sema.produto.governanca_ia, sema.produto.linguagem_composta
+TOP_RISCOS: altera_persistencia, consultar_scorecard_compatibilidade:medio, converter_bloco_composto_para_ir:alto, criar_pedido:alto, efeito_critico, explicitar_variacao_e_compatibilidade:medio (+12)
+TOP_LACUNAS: execucao_implicita, sem_impl, sem_vinculos
+TOP_ARQUIVOS: 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\gerador-python\src\index.ts, C:\GitHub\Sema\pacotes\gerador-typescript\src\index.ts, C:\GitHub\Sema\pacotes\nucleo\src\formatador\index.ts (+3)
+GERADO_EM: 2026-03-31T16:04:57.600Z

package/SEMA_BRIEF.md

@@ -0,0 +1,49 @@
+# SEMA_BRIEF
+
+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-03-31T16:04:57.600Z`
+- Modulos: `4`
+
+## Entrada canonica para IA
+
+- Ordem minima: llms.txt -> SEMA_BRIEF.md -> SEMA_INDEX.json -> AGENTS.md -> README.md -> llms-full.txt
+- IA pequena: llms.txt -> SEMA_BRIEF.micro.txt -> SEMA_INDEX.json -> AGENTS.md
+- IA media: llms.txt -> SEMA_BRIEF.curto.txt -> SEMA_INDEX.json -> AGENTS.md -> README.md
+- IA grande: llms-full.txt -> SEMA_BRIEF.md -> SEMA_INDEX.json -> AGENTS.md -> README.md
+
+## Guia por capacidade
+
+- pequena: IA gratuita ou com contexto curto. Leia so o cartao semantico e o briefing minimo. Artefatos: resumo.micro.txt, briefing.min.json, prompt-curto.txt.
+- media: IA com contexto medio. Aguenta resumo expandido, briefing minimo e drift. Artefatos: resumo.curto.txt, briefing.min.json, drift.json, prompt-curto.txt.
+- grande: IA com contexto grande ou tool use. Pode consumir o pacote completo. Artefatos: README.md, resumo.md, briefing.json, drift.json, ir.json, ast.json.
+
+## Modulos
+
+### app.pedidos
+- Faz: governa 1 rota(s), 1 task(s) com foco em criar pedido publico
+- Publico: POST /pedidos
+- Tocar: nenhum
+- Score: 50 | Confianca: baixa | Risco: alto
+- Lacunas: execucao_implicita, sem_impl, sem_vinculos
+
+### sema.produto.ergonomia_e_dominio
+- Faz: governa 2 superficie(s), 5 task(s) com foco em scorecard atualizado
+- Publico: evento:scorecard_atualizado, policy:compatibilidade_publica
+- Tocar: C:\GitHub\Sema\pacotes\cli\src\projeto.ts, C:\GitHub\Sema\pacotes\nucleo\src\formatador\index.ts, C:\GitHub\Sema\pacotes\nucleo\src\ir\conversor.ts, C:\GitHub\Sema\pacotes\nucleo\src\semantico\analisador.ts
+- Score: 90 | Confianca: alta | Risco: alto
+- Lacunas: execucao_implicita, sem_impl, sem_vinculos
+
+### sema.produto.governanca_ia
+- Faz: governa 2 superficie(s), 4 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\nucleo\src\formatador\index.ts
+- Score: 90 | Confianca: alta | Risco: alto
+- Lacunas: execucao_implicita, sem_impl, sem_vinculos
+
+### sema.produto.linguagem_composta
+- Faz: governa 1 superficie(s), 5 task(s) com foco em regressao composta
+- Publico: storage:regressao_composta
+- Tocar: C:\GitHub\Sema\pacotes\gerador-python\src\index.ts, C:\GitHub\Sema\pacotes\gerador-typescript\src\index.ts, C:\GitHub\Sema\pacotes\nucleo\src\formatador\index.ts, C:\GitHub\Sema\pacotes\nucleo\src\ir\conversor.ts (+1)
+- Score: 90 | Confianca: alta | Risco: alto
+- Lacunas: execucao_implicita, sem_impl, sem_vinculos

package/SEMA_BRIEF.micro.txt

@@ -0,0 +1,7 @@
+PROJETO: Sema
+MODULOS: 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.governanca_ia (+1)
+TOP_RISCOS: altera_persistencia, consultar_scorecard_compatibilidade:medio, converter_bloco_composto_para_ir:alto (+15)
+TOP_LACUNAS: execucao_implicita, sem_impl, sem_vinculos
+GERADO_EM: 2026-03-31T16:04:57.600Z

package/SEMA_INDEX.json

@@ -0,0 +1,501 @@
+{
+  "comando": "resumo-projeto",
+  "geradoEm": "2026-03-31T16:04:57.600Z",
+  "cliVersao": "1.0.0",
+  "baseProjeto": "C:\\GitHub\\Sema",
+  "totalModulos": 4,
+  "entradaCanonica": {
+    "descricao": "Entrada canonica do repositorio para IA. O repo nao e human-first; a IA deve começar por esses artefatos antes de abrir codigo cru.",
+    "ordemLeitura": [
+      "llms.txt",
+      "SEMA_BRIEF.md",
+      "SEMA_INDEX.json",
+      "AGENTS.md",
+      "README.md",
+      "llms-full.txt"
+    ],
+    "porCapacidade": {
+      "pequena": [
+        "llms.txt",
+        "SEMA_BRIEF.micro.txt",
+        "SEMA_INDEX.json",
+        "AGENTS.md"
+      ],
+      "media": [
+        "llms.txt",
+        "SEMA_BRIEF.curto.txt",
+        "SEMA_INDEX.json",
+        "AGENTS.md",
+        "README.md"
+      ],
+      "grande": [
+        "llms-full.txt",
+        "SEMA_BRIEF.md",
+        "SEMA_INDEX.json",
+        "AGENTS.md",
+        "README.md"
+      ]
+    },
+    "docsSuporte": [
+      "docs/AGENT_STARTER.md",
+      "docs/integracao-com-ia.md",
+      "docs/fluxo-pratico-ia-sema.md",
+      "docs/como-ensinar-a-sema-para-ia.md",
+      "docs/sintaxe.md",
+      "docs/cli.md"
+    ],
+    "guiaPorCapacidade": {
+      "pequena": {
+        "descricao": "IA gratuita ou com contexto curto. Leia so o cartao semantico e o briefing minimo.",
+        "artefatos": [
+          "resumo.micro.txt",
+          "briefing.min.json",
+          "prompt-curto.txt"
+        ],
+        "ordemLeitura": [
+          "resumo.micro.txt",
+          "briefing.min.json",
+          "resumo.curto.txt"
+        ],
+        "evitar": [
+          "ast.json",
+          "ir.json",
+          "diagnosticos.json"
+        ]
+      },
+      "media": {
+        "descricao": "IA com contexto medio. Aguenta resumo expandido, briefing minimo e drift.",
+        "artefatos": [
+          "resumo.curto.txt",
+          "briefing.min.json",
+          "drift.json",
+          "prompt-curto.txt"
+        ],
+        "ordemLeitura": [
+          "resumo.curto.txt",
+          "briefing.min.json",
+          "drift.json",
+          "resumo.md"
+        ],
+        "evitar": [
+          "ast.json"
+        ]
+      },
+      "grande": {
+        "descricao": "IA com contexto grande ou tool use. Pode consumir o pacote completo.",
+        "artefatos": [
+          "README.md",
+          "resumo.md",
+          "briefing.json",
+          "drift.json",
+          "ir.json",
+          "ast.json"
+        ],
+        "ordemLeitura": [
+          "README.md",
+          "resumo.md",
+          "briefing.json",
+          "drift.json",
+          "ir.json",
+          "ast.json"
+        ],
+        "evitar": []
+      }
+    }
+  },
+  "guiaPorCapacidade": {
+    "pequena": {
+      "descricao": "IA gratuita ou com contexto curto. Leia so o cartao semantico e o briefing minimo.",
+      "artefatos": [
+        "resumo.micro.txt",
+        "briefing.min.json",
+        "prompt-curto.txt"
+      ],
+      "ordemLeitura": [
+        "resumo.micro.txt",
+        "briefing.min.json",
+        "resumo.curto.txt"
+      ],
+      "evitar": [
+        "ast.json",
+        "ir.json",
+        "diagnosticos.json"
+      ]
+    },
+    "media": {
+      "descricao": "IA com contexto medio. Aguenta resumo expandido, briefing minimo e drift.",
+      "artefatos": [
+        "resumo.curto.txt",
+        "briefing.min.json",
+        "drift.json",
+        "prompt-curto.txt"
+      ],
+      "ordemLeitura": [
+        "resumo.curto.txt",
+        "briefing.min.json",
+        "drift.json",
+        "resumo.md"
+      ],
+      "evitar": [
+        "ast.json"
+      ]
+    },
+    "grande": {
+      "descricao": "IA com contexto grande ou tool use. Pode consumir o pacote completo.",
+      "artefatos": [
+        "README.md",
+        "resumo.md",
+        "briefing.json",
+        "drift.json",
+        "ir.json",
+        "ast.json"
+      ],
+      "ordemLeitura": [
+        "README.md",
+        "resumo.md",
+        "briefing.json",
+        "drift.json",
+        "ir.json",
+        "ast.json"
+      ],
+      "evitar": []
+    }
+  },
+  "modulos": [
+    {
+      "geradoEm": "2026-03-31T16:04:57.600Z",
+      "arquivo": "C:\\GitHub\\Sema\\contratos\\pedidos.sema",
+      "modulo": "app.pedidos",
+      "perfilCompatibilidade": "publico",
+      "scoreSemantico": 50,
+      "confiancaGeral": "baixa",
+      "riscoOperacional": "alto",
+      "faz": "governa 1 rota(s), 1 task(s) com foco em criar pedido publico",
+      "tarefasPrincipais": [
+        "criar_pedido"
+      ],
+      "entradasChave": [
+        "criar_pedido(cliente_id, total)"
+      ],
+      "saidasChave": [
+        "criar_pedido(pedido_id, status)"
+      ],
+      "superficiesPublicas": [
+        "POST /pedidos"
+      ],
+      "regrasCriticas": [
+        "pedido_id existe",
+        "status existe",
+        "total > 0"
+      ],
+      "efeitos": [
+        "auditoria pedidos",
+        "persistencia Pedido criticidade = alta"
+      ],
+      "erros": [],
+      "entidadesAfetadas": [
+        "Pedido",
+        "pedidos"
+      ],
+      "arquivosProvaveis": [],
+      "simbolosRelacionados": [],
+      "riscosPrincipais": [
+        "altera_persistencia",
+        "criar_pedido:alto",
+        "efeito_critico",
+        "vinculo_fraco"
+      ],
+      "lacunas": [
+        "execucao_implicita",
+        "sem_impl",
+        "sem_vinculos"
+      ],
+      "inferido": [],
+      "checksSugeridos": [
+        "revisar efeitos operacionais",
+        "rodar sema drift --json",
+        "rodar sema validar --json",
+        "verificar guarantees"
+      ],
+      "testesMinimos": [
+        "sema drift <arquivo> --json",
+        "sema validar <arquivo> --json",
+        "sema verificar <arquivo-ou-pasta> --json"
+      ]
+    },
+    {
+      "geradoEm": "2026-03-31T16:04:57.600Z",
+      "arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\ergonomia_e_dominio.sema",
+      "modulo": "sema.produto.ergonomia_e_dominio",
+      "perfilCompatibilidade": "interno",
+      "scoreSemantico": 90,
+      "confiancaGeral": "alta",
+      "riscoOperacional": "alto",
+      "faz": "governa 2 superficie(s), 5 task(s) com foco em scorecard atualizado",
+      "tarefasPrincipais": [
+        "reduzir_atrito_sintatico_em_contrato_rico",
+        "modelar_payload_com_mais_precisao",
+        "explicitar_variacao_e_compatibilidade",
+        "separar_validacao_regra_e_poscondicao",
+        "consultar_scorecard_compatibilidade"
+      ],
+      "entradasChave": [
+        "reduzir_atrito_sintatico_em_contrato_rico(contrato_atual, repeticao_detectada)",
+        "modelar_payload_com_mais_precisao(contrato_atual, payload_json_generico, exemplos_payload)",
+        "explicitar_variacao_e_compatibilidade(contrato_atual, perfil_atual)",
+        "separar_validacao_regra_e_poscondicao(contrato_atual, garantias_confusas)"
+      ],
+      "saidasChave": [
+        "reduzir_atrito_sintatico_em_contrato_rico(leitura_mais_limpa, ambiguidade_controlada, perfil)",
+        "modelar_payload_com_mais_precisao(tipo_composto_explicito, cardinalidade_explicita, shape_rico)",
+        "explicitar_variacao_e_compatibilidade(versao_explicita, fallback_claro, contrato_publico_distinto)",
+        "separar_validacao_regra_e_poscondicao(validacao_de_input_clara, regra_de_negocio_clara, pos_condicao_clara)"
+      ],
+      "superficiesPublicas": [
+        "evento:scorecard_atualizado",
+        "policy:compatibilidade_publica"
+      ],
+      "regrasCriticas": [
+        "ambiguidade_controlada existe",
+        "cardinalidade_explicita existe",
+        "contrato_publico_distinto existe",
+        "fallback_claro existe",
+        "leitura_mais_limpa existe",
+        "nota existe",
+        "perfil em [ PUBLICO , INTERNO , EXPERIMENTAL , LEGADO , DEPRECADO ]",
+        "pos_condicao_clara existe"
+      ],
+      "efeitos": [],
+      "erros": [],
+      "entidadesAfetadas": [
+        "PerfilCompatibilidade"
+      ],
+      "arquivosProvaveis": [
+        "C:\\GitHub\\Sema\\pacotes\\cli\\src\\projeto.ts",
+        "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\formatador\\index.ts",
+        "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\ir\\conversor.ts",
+        "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\semantico\\analisador.ts"
+      ],
+      "simbolosRelacionados": [
+        "analisarSemantica",
+        "converterParaIr",
+        "formatarCodigo",
+        "resolverAlvosVerificacao"
+      ],
+      "riscosPrincipais": [
+        "consultar_scorecard_compatibilidade:medio",
+        "explicitar_variacao_e_compatibilidade:medio",
+        "modelar_payload_com_mais_precisao:alto",
+        "reduzir_atrito_sintatico_em_contrato_rico:medio",
+        "separar_validacao_regra_e_poscondicao:medio"
+      ],
+      "lacunas": [
+        "execucao_implicita",
+        "sem_impl",
+        "sem_vinculos"
+      ],
+      "inferido": [
+        "consultar_scorecard_compatibilidade:pacotes/cli/src/projeto.ts",
+        "evento:scorecard_atualizado:scorecard_compatibilidade",
+        "explicitar_variacao_e_compatibilidade:pacotes/nucleo/src/ir/conversor.ts",
+        "modelar_payload_com_mais_precisao:pacotes/nucleo/src/semantico/analisador.ts",
+        "policy:compatibilidade_publica:compatibilidade_publica",
+        "reduzir_atrito_sintatico_em_contrato_rico:pacotes/nucleo/src/formatador/index.ts"
+      ],
+      "checksSugeridos": [
+        "revisar efeitos operacionais",
+        "rodar sema drift --json",
+        "rodar sema validar --json",
+        "verificar guarantees"
+      ],
+      "testesMinimos": [
+        "sema drift <arquivo> --json",
+        "sema validar <arquivo> --json",
+        "sema verificar <arquivo-ou-pasta> --json"
+      ]
+    },
+    {
+      "geradoEm": "2026-03-31T16:04:57.600Z",
+      "arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\governanca_ia.sema",
+      "modulo": "sema.produto.governanca_ia",
+      "perfilCompatibilidade": "publico",
+      "scoreSemantico": 90,
+      "confiancaGeral": "alta",
+      "riscoOperacional": "alto",
+      "faz": "governa 2 superficie(s), 4 task(s) com foco em preparar briefing contextual",
+      "tarefasPrincipais": [
+        "mapear_projeto_sem_adivinhacao",
+        "normalizar_saida_sem_ruido",
+        "medir_drift_contra_codigo_vivo",
+        "padronizar_nomes_para_leitura_de_ia"
+      ],
+      "entradasChave": [
+        "mapear_projeto_sem_adivinhacao(entrada, explicito)",
+        "normalizar_saida_sem_ruido(estrutura_desejada)",
+        "medir_drift_contra_codigo_vivo(contrato_alvo, codigo_vivo)",
+        "padronizar_nomes_para_leitura_de_ia(contrato_atual, sinonimos_em_excesso)"
+      ],
+      "saidasChave": [
+        "mapear_projeto_sem_adivinhacao(base_resolvida, origens_coerentes, codigo_vivo_detectado)",
+        "normalizar_saida_sem_ruido(estrutura_canonica, alias_confuso)",
+        "medir_drift_contra_codigo_vivo(impls_resolvidas, rotas_resolvidas, ambiguidades_explicitas)",
+        "padronizar_nomes_para_leitura_de_ia(nomes_consistentes, leitura_rapida, casos_especiais_reduzidos)"
+      ],
+      "superficiesPublicas": [
+        "webhook:confirmar_contexto_publico",
+        "worker:preparar_briefing_contextual"
+      ],
+      "regrasCriticas": [
+        "alias_confuso existe",
+        "ambiguidades_explicitas existe",
+        "base_resolvida existe",
+        "casos_especiais_reduzidos existe",
+        "codigo_vivo_detectado existe",
+        "estrutura_canonica existe",
+        "impls_resolvidas existe",
+        "leitura_rapida existe"
+      ],
+      "efeitos": [],
+      "erros": [
+        "simbolo_ambiguo"
+      ],
+      "entidadesAfetadas": [],
+      "arquivosProvaveis": [
+        "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\\nucleo\\src\\formatador\\index.ts"
+      ],
+      "simbolosRelacionados": [
+        "analisarDriftLegado",
+        "carregarProjeto",
+        "comandoContextoIa",
+        "formatarCodigo",
+        "normalizarEstruturaSaida"
+      ],
+      "riscosPrincipais": [
+        "mapear_projeto_sem_adivinhacao:medio",
+        "medir_drift_contra_codigo_vivo:alto",
+        "normalizar_saida_sem_ruido:medio",
+        "padronizar_nomes_para_leitura_de_ia:medio"
+      ],
+      "lacunas": [
+        "execucao_implicita",
+        "sem_impl",
+        "sem_vinculos"
+      ],
+      "inferido": [
+        "mapear_projeto_sem_adivinhacao:pacotes/cli/src/projeto.ts",
+        "medir_drift_contra_codigo_vivo:pacotes/cli/src/drift.ts",
+        "normalizar_saida_sem_ruido:pacotes/cli/src/projeto.ts",
+        "padronizar_nomes_para_leitura_de_ia:pacotes/nucleo/src/formatador/index.ts",
+        "sema.produto.governanca_ia:pacotes/cli/src/index.ts",
+        "webhook:confirmar_contexto_publico:/ interno / contexto-ia"
+      ],
+      "checksSugeridos": [
+        "revisar efeitos operacionais",
+        "rodar sema drift --json",
+        "rodar sema validar --json",
+        "verificar guarantees"
+      ],
+      "testesMinimos": [
+        "sema drift <arquivo> --json",
+        "sema validar <arquivo> --json",
+        "sema verificar <arquivo-ou-pasta> --json"
+      ]
+    },
+    {
+      "geradoEm": "2026-03-31T16:04:57.600Z",
+      "arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\linguagem_composta.sema",
+      "modulo": "sema.produto.linguagem_composta",
+      "perfilCompatibilidade": "interno",
+      "scoreSemantico": 90,
+      "confiancaGeral": "alta",
+      "riscoOperacional": "alto",
+      "faz": "governa 1 superficie(s), 5 task(s) com foco em regressao composta",
+      "tarefasPrincipais": [
+        "interpretar_bloco_nomeado",
+        "converter_bloco_composto_para_ir",
+        "formatar_bloco_composto",
+        "gerar_teste_python_composto",
+        "gerar_teste_typescript_composto"
+      ],
+      "entradasChave": [
+        "interpretar_bloco_nomeado(arquivo_semantico, sinais)",
+        "converter_bloco_composto_para_ir(arquivo_semantico)",
+        "formatar_bloco_composto(arquivo_semantico)",
+        "gerar_teste_python_composto(contrato)"
+      ],
+      "saidasChave": [
+        "interpretar_bloco_nomeado(ast_valida, blocos_preservados, status)",
+        "converter_bloco_composto_para_ir(ir_coerente, contexto_preservado, status)",
+        "formatar_bloco_composto(formato_canonico, bloco_legivel)",
+        "gerar_teste_python_composto(dataclass_aninhada, comparacao_tipada)"
+      ],
+      "superficiesPublicas": [
+        "storage:regressao_composta"
+      ],
+      "regrasCriticas": [
+        "asserts_coerentes existe",
+        "ast_valida existe",
+        "bloco_legivel existe",
+        "blocos_preservados existe",
+        "comparacao_tipada existe",
+        "contexto_preservado existe",
+        "dataclass_aninhada existe",
+        "formato_canonico existe"
+      ],
+      "efeitos": [],
+      "erros": [],
+      "entidadesAfetadas": [
+        "SinalTesteComposto",
+        "StatusEvolucao"
+      ],
+      "arquivosProvaveis": [
+        "C:\\GitHub\\Sema\\pacotes\\gerador-python\\src\\index.ts",
+        "C:\\GitHub\\Sema\\pacotes\\gerador-typescript\\src\\index.ts",
+        "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\formatador\\index.ts",
+        "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\ir\\conversor.ts",
+        "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\parser\\parser.ts"
+      ],
+      "simbolosRelacionados": [
+        "converterParaIr",
+        "formatarCodigo",
+        "gerarPython",
+        "gerarTypeScript",
+        "parsear"
+      ],
+      "riscosPrincipais": [
+        "converter_bloco_composto_para_ir:alto",
+        "formatar_bloco_composto:medio",
+        "gerar_teste_python_composto:medio",
+        "gerar_teste_typescript_composto:medio",
+        "interpretar_bloco_nomeado:alto"
+      ],
+      "lacunas": [
+        "execucao_implicita",
+        "sem_impl",
+        "sem_vinculos"
+      ],
+      "inferido": [
+        "converter_bloco_composto_para_ir:pacotes/nucleo/src/ir/conversor.ts",
+        "formatar_bloco_composto:pacotes/nucleo/src/formatador/index.ts",
+        "gerar_teste_python_composto:pacotes/gerador-python/src/index.ts",
+        "gerar_teste_typescript_composto:pacotes/gerador-typescript/src/index.ts",
+        "interpretar_bloco_nomeado:pacotes/nucleo/src/parser/parser.ts",
+        "sema.produto.linguagem_composta:pacotes/nucleo/src/parser/parser.ts"
+      ],
+      "checksSugeridos": [
+        "revisar efeitos operacionais",
+        "rodar sema drift --json",
+        "rodar sema validar --json",
+        "verificar guarantees"
+      ],
+      "testesMinimos": [
+        "sema drift <arquivo> --json",
+        "sema validar <arquivo> --json",
+        "sema verificar <arquivo-ou-pasta> --json"
+      ]
+    }
+  ]
+}

package/dist/drift.d.ts

@@ -1,5 +1,16 @@
 import type { NivelConfiancaSemantica, NivelRiscoSemantico } from "@sema/nucleo";
 import type { ContextoProjetoCarregado } from "./projeto.js";
+type ConsumerFramework = "nextjs-consumer" | "react-vite-consumer" | "angular-consumer" | "flutter-consumer";
+interface RegistroConsumerSurfaceDrift {
+    rota: string;
+    arquivo: string;
+    tipoArquivo: string;
+}
+interface RegistroConsumerBridgeDrift {
+    caminho: string;
+    arquivo: string;
+    simbolo: string;
+}
 export interface DiagnosticoDrift {
     tipo: "impl_quebrado" | "task_sem_impl" | "rota_divergente" | "recurso_divergente" | "vinculo_quebrado";
     modulo: string;
@@ -74,6 +85,10 @@ interface RegistroVinculoDrift {
 export interface ResultadoDrift {
     comando: "drift";
     sucesso: boolean;
+    consumerFramework: ConsumerFramework | null;
+    appRoutes: string[];
+    consumerSurfaces: RegistroConsumerSurfaceDrift[];
+    consumerBridges: RegistroConsumerBridgeDrift[];
     modulos: Array<{
         caminho: string;
         modulo: string | null;