@semacode/cli 1.5.16 → 1.5.17

package/SEMA_INDEX.json

@@ -0,0 +1,921 @@
+{
+  "comando": "resumo-projeto",
+  "geradoEm": "2026-05-09T17:05:35.014Z",
+  "cliVersao": "1.5.15",
+  "baseProjeto": "C:\\GitHub\\Sema",
+  "totalModulos": 7,
+  "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/persistencia-vendor-first.md",
+      "docs/sintaxe.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": {
+        "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-05-09T17:05:35.014Z",
+      "arquivo": "C:\\GitHub\\Sema\\contratos\\pedidos.sema",
+      "modulo": "app.pedidos",
+      "perfilCompatibilidade": "publico",
+      "scoreSemantico": 95,
+      "confiancaGeral": "alta",
+      "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 criticidade = media",
+        "db.write Pedido criticidade = alta privilegio = escrita isolamento = tenant",
+        "secret.read pedidos_api_key criticidade = media privilegio = leitura isolamento = processo"
+      ],
+      "erros": [],
+      "entidadesAfetadas": [
+        "Pedido",
+        "pedidos",
+        "pedidos_api_key"
+      ],
+      "arquivosProvaveis": [
+        "C:\\GitHub\\Sema\\src\\pedidos.controller.ts"
+      ],
+      "simbolosRelacionados": [
+        "criarPedido",
+        "PedidosController.criarPedido"
+      ],
+      "riscosPrincipais": [
+        "criar_pedido:alto",
+        "efeito_critico",
+        "efeito_privilegiado"
+      ],
+      "lacunas": [
+        "execucao_implicita"
+      ],
+      "inferido": [
+        "criar_pedido:src/pedidos.controller.ts"
+      ],
+      "checksSugeridos": [
+        "confirmar proibicoes operacionais",
+        "revisar auth e authz",
+        "revisar efeitos operacionais",
+        "rodar sema drift --json",
+        "rodar sema validar --json",
+        "validar classificacao de dados"
+      ],
+      "testesMinimos": [
+        "sema drift <arquivo> --json",
+        "sema validar <arquivo> --json",
+        "sema verificar <arquivo-ou-pasta> --json"
+      ],
+      "consumerFramework": "nextjs-consumer",
+      "appRoutes": [],
+      "consumerSurfaces": [],
+      "consumerBridges": [],
+      "ancoragensVinculo": [],
+      "arquivosProvaveisEditar": [
+        "C:\\GitHub\\Sema\\src\\pedidos.controller.ts"
+      ]
+    },
+    {
+      "geradoEm": "2026-05-09T17:05:35.014Z",
+      "arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\ergonomia_e_dominio.sema",
+      "modulo": "sema.produto.ergonomia_e_dominio",
+      "perfilCompatibilidade": "interno",
+      "scoreSemantico": 91,
+      "confiancaGeral": "alta",
+      "riscoOperacional": "alto",
+      "faz": "governa 2 superficie(s), 7 task(s) com foco em scorecard atualizado",
+      "tarefasPrincipais": [
+        "reduzir_atrito_sintatico_em_contrato_rico",
+        "modelar_payload_com_mais_precisao",
+        "explicitar_variacao_e_compatibilidade",
+        "habilitar_impl_lua_completo",
+        "habilitar_impl_php_completo",
+        "separar_validacao_regra_e_poscondicao"
+      ],
+      "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)",
+        "habilitar_impl_lua_completo(contrato_atual, origem_lua_declarada)"
+      ],
+      "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)",
+        "habilitar_impl_lua_completo(impl_lua_validado, use_lua_validado, ir_lua_preservado, drift_lua_resolvido)"
+      ],
+      "superficiesPublicas": [
+        "evento:scorecard_atualizado",
+        "policy:compatibilidade_publica"
+      ],
+      "regrasCriticas": [
+        "ambiguidade_controlada existe",
+        "cardinalidade_explicita existe",
+        "contrato_publico_distinto existe",
+        "detector_lua_resolvido existe",
+        "detector_php_resolvido existe",
+        "drift_lua_resolvido existe",
+        "drift_php_resolvido existe",
+        "fallback_claro existe"
+      ],
+      "efeitos": [],
+      "erros": [],
+      "entidadesAfetadas": [
+        "PerfilCompatibilidade"
+      ],
+      "arquivosProvaveis": [
+        "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\\lua-symbols.ts",
+        "C:\\GitHub\\Sema\\pacotes\\cli\\src\\php-symbols.ts",
+        "C:\\GitHub\\Sema\\pacotes\\cli\\src\\projeto.ts",
+        "C:\\GitHub\\Sema\\pacotes\\cli\\src\\tipos.ts",
+        "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\ast\\tipos.ts"
+      ],
+      "simbolosRelacionados": [
+        "analisarDriftLegado",
+        "analisarSemantica",
+        "converterParaIr",
+        "formatarCodigo",
+        "importarProjetoLegado",
+        "resolverAlvosVerificacao"
+      ],
+      "riscosPrincipais": [
+        "consultar_scorecard_compatibilidade:medio",
+        "explicitar_variacao_e_compatibilidade:medio",
+        "habilitar_impl_lua_completo:alto",
+        "habilitar_impl_php_completo:alto",
+        "modelar_payload_com_mais_precisao:alto",
+        "reduzir_atrito_sintatico_em_contrato_rico:medio"
+      ],
+      "lacunas": [
+        "execucao_implicita"
+      ],
+      "inferido": [
+        "consultar_scorecard_compatibilidade:pacotes/cli/src/projeto.ts",
+        "evento:scorecard_atualizado:scorecard_compatibilidade",
+        "explicitar_variacao_e_compatibilidade:pacotes/nucleo/src/ir/conversor.ts",
+        "habilitar_impl_lua_completo:pacotes/cli/src/drift.ts",
+        "habilitar_impl_lua_completo:pacotes/cli/src/importador.ts",
+        "habilitar_impl_lua_completo:pacotes/cli/src/index.ts"
+      ],
+      "checksSugeridos": [
+        "confirmar proibicoes operacionais",
+        "revisar auth e authz",
+        "revisar efeitos operacionais",
+        "rodar sema drift --json",
+        "rodar sema validar --json",
+        "validar classificacao de dados"
+      ],
+      "testesMinimos": [
+        "sema drift <arquivo> --json",
+        "sema validar <arquivo> --json",
+        "sema verificar <arquivo-ou-pasta> --json"
+      ],
+      "consumerFramework": "nextjs-consumer",
+      "appRoutes": [
+        "/ranking"
+      ],
+      "consumerSurfaces": [
+        "router:/ranking -> C:\\GitHub\\Sema\\pacotes\\cli\\src\\index.ts"
+      ],
+      "consumerBridges": [],
+      "ancoragensVinculo": [],
+      "arquivosProvaveisEditar": [
+        "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\\lua-symbols.ts",
+        "C:\\GitHub\\Sema\\pacotes\\cli\\src\\php-symbols.ts",
+        "C:\\GitHub\\Sema\\pacotes\\cli\\src\\projeto.ts",
+        "C:\\GitHub\\Sema\\pacotes\\cli\\src\\tipos.ts",
+        "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\ast\\tipos.ts"
+      ]
+    },
+    {
+      "geradoEm": "2026-05-09T17:05:35.014Z",
+      "arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\geradores_web.sema",
+      "modulo": "sema.produto.geradores_web",
+      "perfilCompatibilidade": "interno",
+      "scoreSemantico": 90,
+      "confiancaGeral": "alta",
+      "riscoOperacional": "medio",
+      "faz": "governa 3 task(s) com foco em gerar contrato javascript",
+      "tarefasPrincipais": [
+        "gerar_contrato_javascript",
+        "gerar_pagina_html",
+        "gerar_design_system_css"
+      ],
+      "entradasChave": [
+        "gerar_contrato_javascript(contrato)",
+        "gerar_pagina_html(contrato)",
+        "gerar_design_system_css(contrato)"
+      ],
+      "saidasChave": [
+        "gerar_contrato_javascript(jsdoc_tipado, validacoes_coerentes, testes_gerados)",
+        "gerar_pagina_html(html_semantico, formularios_derivados, rotas_visuais)",
+        "gerar_design_system_css(variaveis_css, dark_mode, responsividade)"
+      ],
+      "superficiesPublicas": [],
+      "regrasCriticas": [
+        "contrato deve_ser preenchido",
+        "dark_mode existe",
+        "formularios_derivados existe",
+        "html_semantico existe",
+        "jsdoc_tipado existe",
+        "responsividade existe",
+        "rotas_visuais existe",
+        "testes_gerados existe"
+      ],
+      "efeitos": [
+        "auditoria geracao_css criticidade = media",
+        "auditoria geracao_html criticidade = media",
+        "auditoria geracao_javascript criticidade = media"
+      ],
+      "erros": [],
+      "entidadesAfetadas": [
+        "geracao_css",
+        "geracao_html",
+        "geracao_javascript"
+      ],
+      "arquivosProvaveis": [
+        "C:\\GitHub\\Sema\\pacotes\\gerador-css\\src\\index.ts",
+        "C:\\GitHub\\Sema\\pacotes\\gerador-html\\src\\index.ts",
+        "C:\\GitHub\\Sema\\pacotes\\gerador-javascript\\src\\index.ts"
+      ],
+      "simbolosRelacionados": [
+        "gerarCss",
+        "gerarHtml",
+        "gerarJavaScript"
+      ],
+      "riscosPrincipais": [
+        "gerar_contrato_javascript:medio",
+        "gerar_design_system_css:medio",
+        "gerar_pagina_html:medio"
+      ],
+      "lacunas": [
+        "execucao_implicita"
+      ],
+      "inferido": [
+        "gerar_contrato_javascript:pacotes/gerador-javascript/src/index.ts",
+        "gerar_design_system_css:pacotes/gerador-css/src/index.ts",
+        "gerar_pagina_html:pacotes/gerador-html/src/index.ts",
+        "sema.produto.geradores_web:pacotes/gerador-css/src/index.ts",
+        "sema.produto.geradores_web:pacotes/gerador-html/src/index.ts",
+        "sema.produto.geradores_web:pacotes/gerador-javascript/src/index.ts"
+      ],
+      "checksSugeridos": [
+        "confirmar proibicoes operacionais",
+        "revisar auth e authz",
+        "revisar efeitos operacionais",
+        "rodar sema drift --json",
+        "rodar sema validar --json",
+        "validar classificacao de dados"
+      ],
+      "testesMinimos": [
+        "sema drift <arquivo> --json",
+        "sema validar <arquivo> --json",
+        "sema verificar <arquivo-ou-pasta> --json"
+      ],
+      "consumerFramework": "nextjs-consumer",
+      "appRoutes": [],
+      "consumerSurfaces": [],
+      "consumerBridges": [],
+      "ancoragensVinculo": [],
+      "arquivosProvaveisEditar": [
+        "C:\\GitHub\\Sema\\pacotes\\gerador-css\\src\\index.ts",
+        "C:\\GitHub\\Sema\\pacotes\\gerador-html\\src\\index.ts",
+        "C:\\GitHub\\Sema\\pacotes\\gerador-javascript\\src\\index.ts"
+      ]
+    },
+    {
+      "geradoEm": "2026-05-09T17:05:35.014Z",
+      "arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\governanca_ia.sema",
+      "modulo": "sema.produto.governanca_ia",
+      "perfilCompatibilidade": "publico",
+      "scoreSemantico": 93,
+      "confiancaGeral": "alta",
+      "riscoOperacional": "alto",
+      "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",
+        "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)",
+        "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)",
+        "resolver_documentacao_obrigatoria_para_mudanca(docs_obrigatorias_resolvidas, leitura_obrigatoria_emitida, docs_ausentes_detectadas, docs_criadas_quando_autorizado)"
+      ],
+      "superficiesPublicas": [
+        "webhook:confirmar_contexto_publico",
+        "worker:preparar_briefing_contextual"
+      ],
+      "regrasCriticas": [
+        "alias_confuso existe",
+        "ambiguidades_explicitas existe",
+        "arquivos_afetados existe",
+        "arquivos_preservados existe",
+        "base_resolvida existe",
+        "bloqueio_emitido_quando_falta_leitura existe",
+        "casos_especiais_reduzidos 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\\lua-symbols.ts",
+        "C:\\GitHub\\Sema\\pacotes\\cli\\src\\projeto.ts",
+        "C:\\GitHub\\Sema\\pacotes\\editor-vscode\\extension.js",
+        "C:\\GitHub\\Sema\\pacotes\\mcp\\src\\index.ts",
+        "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\formatador\\index.ts"
+      ],
+      "simbolosRelacionados": [
+        "analisarDriftLegado",
+        "assistirRenomeacaoSemantica",
+        "carregarProjeto",
+        "comandoContextoIa",
+        "formatarCodigo",
+        "gerarMapaImpactoSemantico",
+        "materializarExemplosOficiais",
+        "normalizarEstruturaSaida"
+      ],
+      "riscosPrincipais": [
+        "assistir_renomeacao_semantica:alto",
+        "mapear_impacto_semantico:alto",
+        "mapear_projeto_sem_adivinhacao:medio",
+        "materializar_exemplos_oficiais:medio",
+        "medir_drift_contra_codigo_vivo:alto",
+        "normalizar_saida_sem_ruido:medio"
+      ],
+      "lacunas": [
+        "execucao_implicita"
+      ],
+      "inferido": [
+        "assistir_renomeacao_semantica:pacotes/cli/src/drift.ts",
+        "assistir_renomeacao_semantica:pacotes/cli/src/index.ts",
+        "conduzir_mudanca_semantica_real:pacotes/cli/src/index.ts",
+        "mapear_impacto_semantico:pacotes/cli/src/drift.ts",
+        "mapear_impacto_semantico:pacotes/cli/src/index.ts",
+        "mapear_projeto_sem_adivinhacao:pacotes/cli/src/projeto.ts"
+      ],
+      "checksSugeridos": [
+        "confirmar proibicoes operacionais",
+        "revisar auth e authz",
+        "revisar efeitos operacionais",
+        "rodar sema drift --json",
+        "rodar sema validar --json",
+        "validar classificacao de dados"
+      ],
+      "testesMinimos": [
+        "sema drift <arquivo> --json",
+        "sema validar <arquivo> --json",
+        "sema verificar <arquivo-ou-pasta> --json"
+      ],
+      "consumerFramework": "nextjs-consumer",
+      "appRoutes": [
+        "/ranking"
+      ],
+      "consumerSurfaces": [
+        "router:/ranking -> C:\\GitHub\\Sema\\pacotes\\cli\\src\\index.ts"
+      ],
+      "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\\lua-symbols.ts",
+        "C:\\GitHub\\Sema\\pacotes\\cli\\src\\projeto.ts",
+        "C:\\GitHub\\Sema\\pacotes\\editor-vscode\\extension.js",
+        "C:\\GitHub\\Sema\\pacotes\\mcp\\src\\index.ts",
+        "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\formatador\\index.ts"
+      ]
+    },
+    {
+      "geradoEm": "2026-05-09T17:05:35.014Z",
+      "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"
+      ],
+      "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": [
+        "confirmar proibicoes operacionais",
+        "revisar auth e authz",
+        "revisar efeitos operacionais",
+        "rodar sema drift --json",
+        "rodar sema validar --json",
+        "validar classificacao de dados"
+      ],
+      "testesMinimos": [
+        "sema drift <arquivo> --json",
+        "sema validar <arquivo> --json",
+        "sema verificar <arquivo-ou-pasta> --json"
+      ],
+      "consumerFramework": "nextjs-consumer",
+      "appRoutes": [],
+      "consumerSurfaces": [],
+      "consumerBridges": [],
+      "ancoragensVinculo": [],
+      "arquivosProvaveisEditar": [
+        "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"
+      ]
+    },
+    {
+      "geradoEm": "2026-05-09T17:05:35.014Z",
+      "arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\persistencia_vendor_first.sema",
+      "modulo": "sema.produto.persistencia_vendor_first",
+      "perfilCompatibilidade": "interno",
+      "scoreSemantico": 90,
+      "confiancaGeral": "alta",
+      "riscoOperacional": "alto",
+      "faz": "governa 6 task(s) com foco em validar compatibilidade vendor first",
+      "tarefasPrincipais": [
+        "validar_compatibilidade_vendor_first",
+        "converter_persistencia_para_ir_canonico",
+        "formatar_database_vendor_first",
+        "inferir_database_legado_em_adocao",
+        "carregar_configuracao_de_persistencia",
+        "cruzar_persistencia_com_banco_real"
+      ],
+      "entradasChave": [
+        "validar_compatibilidade_vendor_first(contrato_persistencia, engine_alvo)",
+        "converter_persistencia_para_ir_canonico(contrato_persistencia)",
+        "formatar_database_vendor_first(contrato_persistencia)",
+        "inferir_database_legado_em_adocao(projeto_legado, linguagem_detectada)"
+      ],
+      "saidasChave": [
+        "validar_compatibilidade_vendor_first(diagnosticos_emitidos, incompatibilidades_reais_detectadas, status)",
+        "converter_persistencia_para_ir_canonico(secao_databases_preservada, compatibilidade_calculada, status)",
+        "formatar_database_vendor_first(ordem_canonica, recursos_preservados)",
+        "inferir_database_legado_em_adocao(engines_inferidos, bloco_database_emitido)"
+      ],
+      "superficiesPublicas": [],
+      "regrasCriticas": [
+        "adapters_por_engine_lidos existe",
+        "bloco_database_emitido existe",
+        "categoria_persistencia_emitida existe",
+        "colunas_reais_mapeadas existe",
+        "compatibilidade_calculada existe",
+        "compatibilidade_materializada existe",
+        "diagnosticos_emitidos existe",
+        "engines_habilitados_lidos existe"
+      ],
+      "efeitos": [],
+      "erros": [],
+      "entidadesAfetadas": [
+        "StatusPersistenciaVendor"
+      ],
+      "arquivosProvaveis": [
+        "C:\\GitHub\\Sema\\pacotes\\cli\\src\\drift.ts",
+        "C:\\GitHub\\Sema\\pacotes\\cli\\src\\importador.ts",
+        "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": [
+        "analisarPersistenciaReal",
+        "analisarSemantica",
+        "carregarConfiguracaoProjeto",
+        "converterParaIr",
+        "formatarCodigo",
+        "importarProjetoLegado"
+      ],
+      "riscosPrincipais": [
+        "carregar_configuracao_de_persistencia:medio",
+        "converter_persistencia_para_ir_canonico:alto",
+        "cruzar_persistencia_com_banco_real:alto",
+        "formatar_database_vendor_first:medio",
+        "inferir_database_legado_em_adocao:medio",
+        "validar_compatibilidade_vendor_first:alto"
+      ],
+      "lacunas": [
+        "execucao_implicita"
+      ],
+      "inferido": [
+        "carregar_configuracao_de_persistencia:pacotes/cli/src/projeto.ts",
+        "converter_persistencia_para_ir_canonico:pacotes/nucleo/src/ir/conversor.ts",
+        "cruzar_persistencia_com_banco_real:pacotes/cli/src/drift.ts",
+        "formatar_database_vendor_first:pacotes/nucleo/src/formatador/index.ts",
+        "inferir_database_legado_em_adocao:pacotes/cli/src/importador.ts",
+        "sema.produto.persistencia_vendor_first:pacotes/cli/src/drift.ts"
+      ],
+      "checksSugeridos": [
+        "confirmar proibicoes operacionais",
+        "revisar auth e authz",
+        "revisar efeitos operacionais",
+        "rodar sema drift --json",
+        "rodar sema validar --json",
+        "validar classificacao de dados"
+      ],
+      "testesMinimos": [
+        "sema drift <arquivo> --json",
+        "sema validar <arquivo> --json",
+        "sema verificar <arquivo-ou-pasta> --json"
+      ],
+      "consumerFramework": "nextjs-consumer",
+      "appRoutes": [],
+      "consumerSurfaces": [],
+      "consumerBridges": [],
+      "ancoragensVinculo": [],
+      "arquivosProvaveisEditar": [
+        "C:\\GitHub\\Sema\\pacotes\\cli\\src\\drift.ts",
+        "C:\\GitHub\\Sema\\pacotes\\cli\\src\\importador.ts",
+        "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"
+      ]
+    },
+    {
+      "geradoEm": "2026-05-09T17:05:35.014Z",
+      "arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\profiles_author_agents_flow.sema",
+      "modulo": "sema.produto.profiles_author_agents_flow",
+      "perfilCompatibilidade": "interno",
+      "scoreSemantico": 91,
+      "confiancaGeral": "alta",
+      "riscoOperacional": "alto",
+      "faz": "governa 6 task(s) com foco em interpretar blocos author e agents",
+      "tarefasPrincipais": [
+        "interpretar_blocos_author_e_agents",
+        "validar_guardrails_author_agents",
+        "validar_author_sensivel_com_fontes_e_agents",
+        "converter_profiles_author_agents_para_ir",
+        "aplicar_regras_gerais_author_automaticas",
+        "expor_comando_author_cli"
+      ],
+      "entradasChave": [
+        "interpretar_blocos_author_e_agents(contrato)",
+        "validar_guardrails_author_agents(ast)",
+        "validar_author_sensivel_com_fontes_e_agents(ast)",
+        "converter_profiles_author_agents_para_ir(ast)"
+      ],
+      "saidasChave": [
+        "interpretar_blocos_author_e_agents(ast)",
+        "validar_guardrails_author_agents(diagnosticos)",
+        "validar_author_sensivel_com_fontes_e_agents(diagnosticos)",
+        "converter_profiles_author_agents_para_ir(ir)"
+      ],
+      "superficiesPublicas": [],
+      "regrasCriticas": [
+        "ajuda_author existe",
+        "args existe",
+        "ast existe",
+        "contrato deve_ser preenchido",
+        "contrato_exemplo existe",
+        "diagnosticos existe",
+        "fluxo_editorial existe",
+        "ir existe"
+      ],
+      "efeitos": [
+        "auditoria author_regras_automaticas criticidade = alta",
+        "auditoria cli_author criticidade = media",
+        "auditoria ir_profiles_author_agents criticidade = media",
+        "auditoria parse_profiles_author_agents criticidade = media",
+        "auditoria validacao_author_sensivel criticidade = alta",
+        "auditoria validacao_profiles_author_agents criticidade = media"
+      ],
+      "erros": [],
+      "entidadesAfetadas": [
+        "author_regras_automaticas",
+        "cli_author",
+        "ir_profiles_author_agents",
+        "parse_profiles_author_agents",
+        "validacao_author_sensivel",
+        "validacao_profiles_author_agents"
+      ],
+      "arquivosProvaveis": [
+        "C:\\GitHub\\Sema\\pacotes\\cli\\src\\index.ts",
+        "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\ast\\tipos.ts",
+        "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\ir\\conversor.ts",
+        "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\ir\\modelos.ts",
+        "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\lexer\\tokens.ts",
+        "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\parser\\parser.ts",
+        "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\semantico\\analisador.ts"
+      ],
+      "simbolosRelacionados": [
+        "analisarSemantica",
+        "comandoAuthor",
+        "converterParaIr",
+        "parsear"
+      ],
+      "riscosPrincipais": [
+        "aplicar_regras_gerais_author_automaticas:alto",
+        "converter_profiles_author_agents_para_ir:medio",
+        "efeito_critico",
+        "efeito_privilegiado",
+        "expor_comando_author_cli:medio",
+        "interpretar_blocos_author_e_agents:medio"
+      ],
+      "lacunas": [
+        "execucao_implicita"
+      ],
+      "inferido": [
+        "aplicar_regras_gerais_author_automaticas:converterParaIr",
+        "aplicar_regras_gerais_author_automaticas:pacotes/nucleo/src/ir/conversor.ts",
+        "aplicar_regras_gerais_author_automaticas:pacotes/nucleo/src/ir/modelos.ts",
+        "converter_profiles_author_agents_para_ir:converterParaIr",
+        "converter_profiles_author_agents_para_ir:pacotes/nucleo/src/ir/conversor.ts",
+        "converter_profiles_author_agents_para_ir:pacotes/nucleo/src/ir/modelos.ts"
+      ],
+      "checksSugeridos": [
+        "confirmar proibicoes operacionais",
+        "revisar auth e authz",
+        "revisar efeitos operacionais",
+        "rodar sema drift --json",
+        "rodar sema validar --json",
+        "validar classificacao de dados"
+      ],
+      "testesMinimos": [
+        "sema drift <arquivo> --json",
+        "sema validar <arquivo> --json",
+        "sema verificar <arquivo-ou-pasta> --json"
+      ],
+      "consumerFramework": "nextjs-consumer",
+      "appRoutes": [
+        "/ranking"
+      ],
+      "consumerSurfaces": [
+        "router:/ranking -> C:\\GitHub\\Sema\\pacotes\\cli\\src\\index.ts"
+      ],
+      "consumerBridges": [],
+      "ancoragensVinculo": [],
+      "arquivosProvaveisEditar": [
+        "C:\\GitHub\\Sema\\pacotes\\cli\\src\\index.ts",
+        "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\ast\\tipos.ts",
+        "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\ir\\conversor.ts",
+        "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\ir\\modelos.ts",
+        "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\lexer\\tokens.ts",
+        "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\parser\\parser.ts",
+        "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\semantico\\analisador.ts"
+      ]
+    }
+  ]
+}