@semacode/cli 1.3.2 → 1.3.6

package/SEMA_INDEX.json

@@ -1,546 +0,0 @@
-{
-  "comando": "resumo-projeto",
-  "geradoEm": "2026-04-03T14:43:39.329Z",
-  "cliVersao": "1.2.17",
-  "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-04-03T14:43:39.329Z",
-      "arquivo": "c:\\GitHub\\Sema\\contratos\\pedidos.sema",
-      "modulo": "app.pedidos",
-      "perfilCompatibilidade": "publico",
-      "scoreSemantico": 35,
-      "confiancaGeral": "media",
-      "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": [],
-      "simbolosRelacionados": [],
-      "riscosPrincipais": [
-        "criar_pedido:alto",
-        "efeito_critico",
-        "efeito_privilegiado"
-      ],
-      "lacunas": [
-        "sem_impl",
-        "vinculo_quebrado"
-      ],
-      "inferido": [],
-      "checksSugeridos": [
-        "confirmar proibicoes operacionais",
-        "corrigir vinculos rastreaveis",
-        "revisar auth e authz",
-        "revisar efeitos operacionais",
-        "rodar sema drift --json",
-        "rodar sema validar --json"
-      ],
-      "testesMinimos": [
-        "sema drift <arquivo> --json",
-        "sema validar <arquivo> --json",
-        "sema verificar <arquivo-ou-pasta> --json"
-      ],
-      "consumerFramework": "nextjs-consumer",
-      "appRoutes": [],
-      "consumerSurfaces": [],
-      "consumerBridges": [],
-      "arquivosProvaveisEditar": []
-    },
-    {
-      "geradoEm": "2026-04-03T14:43:39.329Z",
-      "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": [
-        "sem_impl",
-        "vinculo_quebrado"
-      ],
-      "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": [
-        "confirmar proibicoes operacionais",
-        "corrigir vinculos rastreaveis",
-        "revisar auth e authz",
-        "revisar efeitos operacionais",
-        "rodar sema drift --json",
-        "rodar sema validar --json"
-      ],
-      "testesMinimos": [
-        "sema drift <arquivo> --json",
-        "sema validar <arquivo> --json",
-        "sema verificar <arquivo-ou-pasta> --json"
-      ],
-      "consumerFramework": "nextjs-consumer",
-      "appRoutes": [],
-      "consumerSurfaces": [],
-      "consumerBridges": [],
-      "arquivosProvaveisEditar": [
-        "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-04-03T14:43:39.329Z",
-      "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": [
-        "sem_impl",
-        "vinculo_quebrado"
-      ],
-      "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": [
-        "confirmar proibicoes operacionais",
-        "corrigir vinculos rastreaveis",
-        "revisar auth e authz",
-        "revisar efeitos operacionais",
-        "rodar sema drift --json",
-        "rodar sema validar --json"
-      ],
-      "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": [],
-      "arquivosProvaveisEditar": [
-        "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"
-      ]
-    },
-    {
-      "geradoEm": "2026-04-03T14:43:39.329Z",
-      "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": [
-        "sem_impl",
-        "vinculo_quebrado"
-      ],
-      "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",
-        "corrigir vinculos rastreaveis",
-        "revisar auth e authz",
-        "revisar efeitos operacionais",
-        "rodar sema drift --json",
-        "rodar sema validar --json"
-      ],
-      "testesMinimos": [
-        "sema drift <arquivo> --json",
-        "sema validar <arquivo> --json",
-        "sema verificar <arquivo-ou-pasta> --json"
-      ],
-      "consumerFramework": "nextjs-consumer",
-      "appRoutes": [],
-      "consumerSurfaces": [],
-      "consumerBridges": [],
-      "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"
-      ]
-    }
-  ]
-}

package/docs/AGENT_STARTER.md

@@ -1,102 +0,0 @@
-# AGENT_STARTER
-
-Use este texto como starter curto para qualquer IA antes de editar `.sema`.
-
-Ordem canonica de entrada no repo:
-
-1. `llms.txt`
-2. `SEMA_BRIEF.md`
-3. `SEMA_INDEX.json`
-4. `AGENTS.md`
-5. `README.md`
-
-Roteamento por capacidade:
-
-- IA pequena ou gratuita: `llms.txt` -> `SEMA_BRIEF.micro.txt` -> `SEMA_INDEX.json`
-- IA media: `llms.txt` -> `SEMA_BRIEF.curto.txt` -> `SEMA_INDEX.json` -> `README.md`
-- IA grande ou com tool use: `llms-full.txt` -> `SEMA_BRIEF.md` -> `SEMA_INDEX.json` -> `AGENTS.md` -> `README.md`
-
-Tres modos de uso da Sema:
-
-- projeto novo: modele, valide, compile e verifique antes de subir codigo derivado
-- projeto ja semantizado: inspecione, leia resumo, rode drift e gere contexto antes de editar
-- legado sem Sema: importe, revise o rascunho, formate, valide e use drift como arbitro da adocao incremental
-
-Para manter os artefatos gerados da raiz sincronizados:
-
-- `sema sync-ai-entrypoints --json`
-
-```text
-Voce esta trabalhando com Sema, um Protocolo de Governanca de Intencao para IA sobre software vivo em backend e front consumer.
-
-Importante:
-- a Sema e protocolo de governanca semantica desenhado para IA, nao para ergonomia humana
-- a Sema funciona como camada de navegacao operacional para agente, nao como runtime magico
-- leitura humana e bonus toleravel, nao centro do produto
-- a Sema modela contratos, estados, fluxos, erros, efeitos, garantias, vinculos e execucao
-- a Sema gera codigo e scaffolding real para TypeScript, Python e Dart
-- a Sema usa `importar` para bootstrap revisavel, nao para contrato final automatico
-- a Sema usa `drift` para medir diferenca entre contrato e codigo vivo
-- a Sema usa `impl` para ligar task a simbolo real do runtime
-- a Sema usa `resumo` e `prompt-curto` para IA pequena ou gratuita
-- a Sema pode servir de base para interfaces graficas elegantes e coerentes
-- a primeira onda consumer oficial agora cobre `Next.js consumer`, `React/Vite consumer`, `Angular consumer` e `flutter-consumer`
-- esses slices oficiais cobrem `consumer bridge + superficies rastreaveis`, nao geracao completa de UI
-- a proxima camada semantica de front (`screen`, `action`, `query`, `form`, `navigation`) esta documentada como roadmap, nao como sintaxe oficial ja suportada
-- trate a Sema como cerebro semantico da aplicacao, nao como gerador magico de front-end pronto
-- nao cobre da Sema persistencia real, runtime ou smoke test automatico; isso continua sendo engenharia viva
-- se a tarefa envolver UI, priorize `appRoutes`, `consumerSurfaces` e `consumerBridges` antes de abrir arquivo aleatorio
-- evite pedir HTML unico solto quando a intencao for testar a Sema de verdade
-
-Regras:
-- nao invente sintaxe fora da gramatica e dos exemplos oficiais
-- se a IA for pequena, comece em `sema resumo` e `briefing.min.json`
-- trate `ir --json` como fonte de verdade semantica
-- trate `diagnosticos --json` como fonte de correcao
-- use `sema formatar` como fonte unica de estilo
-- preserve a intencao do contrato
-- nao cobre da Sema adivinhacao de negocio que nao esta no contrato nem no codigo
-
-Comandos essenciais:
-- resumo por capacidade: `sema resumo <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>]`
-- prompt curto: `sema prompt-curto <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>]`
-- contexto completo do modulo: `sema contexto-ia <arquivo.sema>`
-- estrutura sintatica: `sema ast <arquivo.sema> --json`
-- estrutura semantica: `sema ir <arquivo.sema> --json`
-- validacao: `sema validar <arquivo.sema> --json`
-- diagnosticos: `sema diagnosticos <arquivo.sema> --json`
-- formatacao: `sema formatar <arquivo.sema>`
-- importacao assistida de legado: `sema importar <nestjs|fastapi|flask|nextjs|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer|firebase|typescript|python|dart|dotnet|java|go|rust|cpp> <diretorio> --saida <diretorio>`
-- geracao de codigo: `sema compilar <arquivo-ou-pasta> --alvo <typescript|python|dart> --saida <diretorio>`
-- verificacao final: `sema verificar <arquivo-ou-pasta> [--json]`
-
-Regra pratica de ouro:
-- se a tarefa pedir codigo derivado, `sema compilar` e obrigatorio
-- se a tarefa partir de projeto que nao nasceu com Sema, `sema importar` deve entrar antes da lapidacao semantica
-- se a tarefa pedir apenas leitura ou correcao sem gerar codigo, `sema compilar` pode ficar fora
-
-Antes de editar:
-1. leia README, docs de IA e um exemplo oficial parecido
-2. se a IA for pequena, rode `sema resumo <arquivo> --micro`
-3. se a tarefa pedir contexto mais rico, consulte `drift`, `briefing.min.json` e depois AST/IR
-
-Depois de editar:
-1. rode `sema formatar`
-2. rode `sema validar --json`
-3. se houver falha, use `diagnosticos --json`
-4. se a tarefa pedir codigo derivado, rode `sema compilar`
-5. feche com `sema verificar <arquivo-ou-pasta> --json`
-
-Priorize sempre:
-- exemplos oficiais
-- JSON da CLI
-- consistencia semantica
-
-Nao improvise quando faltar contexto.
-```
-
-Documentos de apoio:
-
-- [como-ensinar-a-sema-para-ia.md](./como-ensinar-a-sema-para-ia.md)
-- [prompt-base-ia-sema.md](./prompt-base-ia-sema.md)
-- [fluxo-pratico-ia-sema.md](./fluxo-pratico-ia-sema.md)