@semacode/cli 2.3.0 → 3.0.0

package/exemplos/operacao_estrategia_rollout.sema

@@ -1,124 +1,124 @@
-module exemplos.operacao_estrategia.rollout {
-  docs {
-    resumo: "Task oficial para ativar strategy com nova versao de modelo apos aprovacao manual."
-  }
-
-  enum StatusStrategy {
-    RASCUNHO,
-    ATIVA,
-    QUARENTENA,
-    DESATIVADA
-  }
-
-  enum StatusGate {
-    ABERTO,
-    FECHADO
-  }
-
-  task ativar_strategy_com_nova_versao {
-    docs {
-      resumo: "Promove a versao candidata aprovada e reabre a strategy so quando houver aprovacao manual e gate global devidamente controlado."
-    }
-    input {
-      strategy_id: Id required
-      versao_modelo_ativa: Texto required
-      versao_modelo_candidata: Texto required
-      strategy_status_atual: StatusStrategy required
-      gate_global_atual: StatusGate required
-      aprovacao_manual: Booleano required
-    }
-    output {
-      strategy_status: StatusStrategy
-      gate_global: StatusGate
-      versao_modelo_ativa: Texto
-    }
-    authz {
-      escopo: strategy.rollout.ativar
-      tenant: obrigatorio
-    }
-    dados {
-      classificacao_padrao: interno
-      redacao_log: obrigatoria
-      input {
-        strategy_id: interno
-        versao_modelo_ativa: interno
-        versao_modelo_candidata: interno
-        strategy_status_atual: interno
-        gate_global_atual: interno
-        aprovacao_manual: interno
-      }
-      output {
-        strategy_status: interno
-        gate_global: interno
-        versao_modelo_ativa: interno
-      }
-    }
-    audit {
-      evento: strategy.rollout.ativado
-      ator: sistema.strategy
-      correlacao: request_id
-      retencao: "180d"
-      motivo: obrigatorio
-    }
-    forbidden {
-      shell.exec
-      log.segredo
-      retorno.credencial
-    }
-    rules {
-      strategy_id existe
-      versao_modelo_ativa existe
-      versao_modelo_candidata existe
-      strategy_status_atual em [RASCUNHO, QUARENTENA]
-      gate_global_atual == FECHADO
-      aprovacao_manual == verdadeiro
-    }
-    effects {
-      persistencia strategy criticidade = alta
-      evento strategy_ativada criticidade = alta
-      auditoria rollout criticidade = alta
-    }
-    vinculos {
-      tabela: strategy
-      recurso: model_registry
-      evento: strategy_ativada
-    }
-    execucao {
-      idempotencia: verdadeiro
-      timeout: "15s"
-      retry: "nenhum"
-      compensacao: "reverter_para_versao_modelo_ativa_anterior"
-      criticidade_operacional: alta
-    }
-    state governanca_estrategia {
-      transitions {
-        QUARENTENA -> ATIVA
-        RASCUNHO -> ATIVA
-      }
-    }
-    guarantees {
-      strategy_status == ATIVA
-      gate_global == ABERTO
-      versao_modelo_ativa existe
-    }
-    tests {
-      caso "reativa strategy apos aprovacao do novo modelo" {
-        given {
-          strategy_id: "strategy_alpha"
-          versao_modelo_ativa: "modelo_2026_12"
-          versao_modelo_candidata: "modelo_2026_13"
-          strategy_status_atual: "QUARENTENA"
-          gate_global_atual: "FECHADO"
-          aprovacao_manual: verdadeiro
-        }
-
-        expect {
-          sucesso: verdadeiro
-          strategy_status: "ATIVA"
-          gate_global: "ABERTO"
-          versao_modelo_ativa: "modelo_2026_13"
-        }
-      }
-    }
-  }
-}
+module exemplos.operacao_estrategia.rollout {
+  docs {
+    resumo: "Task oficial para ativar strategy com nova versao de modelo apos aprovacao manual."
+  }
+
+  enum StatusStrategy {
+    RASCUNHO,
+    ATIVA,
+    QUARENTENA,
+    DESATIVADA
+  }
+
+  enum StatusGate {
+    ABERTO,
+    FECHADO
+  }
+
+  task ativar_strategy_com_nova_versao {
+    docs {
+      resumo: "Promove a versao candidata aprovada e reabre a strategy so quando houver aprovacao manual e gate global devidamente controlado."
+    }
+    input {
+      strategy_id: Id required
+      versao_modelo_ativa: Texto required
+      versao_modelo_candidata: Texto required
+      strategy_status_atual: StatusStrategy required
+      gate_global_atual: StatusGate required
+      aprovacao_manual: Booleano required
+    }
+    output {
+      strategy_status: StatusStrategy
+      gate_global: StatusGate
+      versao_modelo_ativa: Texto
+    }
+    authz {
+      escopo: strategy.rollout.ativar
+      tenant: obrigatorio
+    }
+    dados {
+      classificacao_padrao: interno
+      redacao_log: obrigatoria
+      input {
+        strategy_id: interno
+        versao_modelo_ativa: interno
+        versao_modelo_candidata: interno
+        strategy_status_atual: interno
+        gate_global_atual: interno
+        aprovacao_manual: interno
+      }
+      output {
+        strategy_status: interno
+        gate_global: interno
+        versao_modelo_ativa: interno
+      }
+    }
+    audit {
+      evento: strategy.rollout.ativado
+      ator: sistema.strategy
+      correlacao: request_id
+      retencao: "180d"
+      motivo: obrigatorio
+    }
+    forbidden {
+      shell.exec
+      log.segredo
+      retorno.credencial
+    }
+    rules {
+      strategy_id existe
+      versao_modelo_ativa existe
+      versao_modelo_candidata existe
+      strategy_status_atual em [RASCUNHO, QUARENTENA]
+      gate_global_atual == FECHADO
+      aprovacao_manual == verdadeiro
+    }
+    effects {
+      persistencia strategy criticidade = alta
+      evento strategy_ativada criticidade = alta
+      auditoria rollout criticidade = alta
+    }
+    vinculos {
+      tabela: strategy
+      recurso: model_registry
+      evento: strategy_ativada
+    }
+    execucao {
+      idempotencia: verdadeiro
+      timeout: "15s"
+      retry: "nenhum"
+      compensacao: "reverter_para_versao_modelo_ativa_anterior"
+      criticidade_operacional: alta
+    }
+    state governanca_estrategia {
+      transitions {
+        QUARENTENA -> ATIVA
+        RASCUNHO -> ATIVA
+      }
+    }
+    guarantees {
+      strategy_status == ATIVA
+      gate_global == ABERTO
+      versao_modelo_ativa existe
+    }
+    tests {
+      caso "reativa strategy apos aprovacao do novo modelo" {
+        given {
+          strategy_id: "strategy_alpha"
+          versao_modelo_ativa: "modelo_2026_12"
+          versao_modelo_candidata: "modelo_2026_13"
+          strategy_status_atual: "QUARENTENA"
+          gate_global_atual: "FECHADO"
+          aprovacao_manual: verdadeiro
+        }
+
+        expect {
+          sucesso: verdadeiro
+          strategy_status: "ATIVA"
+          gate_global: "ABERTO"
+          versao_modelo_ativa: "modelo_2026_13"
+        }
+      }
+    }
+  }
+}

package/exemplos/pagamento.sema

@@ -431,4 +431,4 @@ module exemplos.pagamento {
       timeout_gateway: "Erro publico quando o gateway nao responde."
     }
   }
-}
+}

package/exemplos/pagamento_dominio.sema

@@ -32,4 +32,4 @@ module exemplos.pagamento.dominio {
       PENDENTE -> RECUSADO
     }
   }
-}
+}

package/exemplos/pedido.sema

@@ -252,4 +252,4 @@ module exemplos.pedido {
       auditoria fluxo_aprovacao_pedido criticidade = alta
     }
   }
-}
+}

package/exemplos/permissao.sema

@@ -118,4 +118,4 @@ module exemplos.permissao {
       }
     }
   }
-}
+}

package/exemplos/persistencia_vendor_first.sema

@@ -83,4 +83,4 @@ module exemplos.persistencia.vendor_first {
       retention: 300s
     }
   }
-}
+}

package/exemplos/profile_conversas.sema

@@ -1,165 +1,165 @@
-module exemplos.profile_conversas {
-  docs {
-    resumo: "Exemplo oficial do profile Conversas: bot comercial para atendimento de cliente com tom persuasivo, estado visivel do turno, customer_reply como unica saida ao cliente, deduplicacao, limites de promessa, memoria curta e escalacao humana. Contrato primeiro: criar, editar ou remover contrato antes de qualquer acao."
-  }
-
-  type PoliticaTomConversa {
-    fields {
-      tom: Texto
-      formalidade: Texto
-      intensidade_persuasiva: Texto
-      proibicoes: Lista
-    }
-    invariants {
-      tom existe
-      formalidade existe
-      intensidade_persuasiva existe
-      proibicoes existe
-    }
-  }
-
-  type ContextoClienteConversa {
-    fields {
-      etapa: Texto
-      intencao_detectada: Texto
-      sentimento: Texto
-      objecoes: Lista
-      historico_resumido: Texto
-      ultima_mensagem_cliente: Texto
-      ultima_resposta_visivel: Texto
-      fatos_coletados: Lista
-      proxima_acao_esperada: Texto
-    }
-    invariants {
-      etapa existe
-      intencao_detectada existe
-      sentimento existe
-      historico_resumido existe
-      ultima_mensagem_cliente existe
-      ultima_resposta_visivel existe
-      fatos_coletados existe
-      proxima_acao_esperada existe
-    }
-  }
-
-  type EstadoTurnoConversa {
-    fields {
-      conversation_id: Id
-      evento_id: Id
-      canal: Texto
-      mensagem_cliente_visivel: Texto
-      resposta_anterior_visivel: Texto
-      etapa_atual: Texto
-      pergunta_anterior: Texto
-      confirmacao_curta: Booleano
-      dedupe_key: Texto
-      origem_estado: Texto
-    }
-    invariants {
-      conversation_id existe
-      evento_id existe
-      canal existe
-      mensagem_cliente_visivel existe
-      resposta_anterior_visivel existe
-      etapa_atual existe
-      dedupe_key existe
-      origem_estado existe
-    }
-  }
-
-  task responder_cliente_vendas {
-    input {
-      mensagem_cliente: Texto required
-      contexto: ContextoClienteConversa required
-      politica: PoliticaTomConversa required
-      estado_turno: EstadoTurnoConversa required
-      conhecimento_autorizado: Lista required
-    }
-    output {
-      resposta_cliente: Texto
-      customer_reply: Texto
-      proxima_acao: Texto
-      escalar_humano: Booleano
-      dedupe_key: Texto
-    }
-    rules {
-      mensagem_cliente deve_ser preenchida
-      contexto deve_ser valido
-      politica deve_ser com_tom_comercial_persuasivo
-      estado_turno deve_ser origem_conversa_visivel
-      estado_turno deve_ser deduplicado_por_evento
-      conhecimento_autorizado deve_ser nao_vazio
-      estado_turno.confirmacao_curta deve_ser interpretada_contra_pergunta_anterior
-    }
-    effects {
-      auditoria conversa_cliente criticidade = alta
-      evento resposta_bot_preparada criticidade = media
-    }
-    authz {
-      escopo: sema.conversas.responder
-      tenant: obrigatorio
-    }
-    dados {
-      classificacao_padrao: interno
-      redacao_log: parcial
-    }
-    audit {
-      evento: exemplos.conversas.resposta
-      ator: auth.agente
-      correlacao: conversation_id
-      retencao: "30d"
-      motivo: obrigatorio
-    }
-    forbidden {
-      promessa_sem_base
-      inventar_preco_ou_prazo
-      insistencia_agressiva
-      ignorar_objecao_cliente
-      reiniciar_conversa_apos_confirmacao_curta
-      repetir_saudacao_apos_contexto_existente
-      enviar_json_interno_ao_cliente
-      responder_mais_de_uma_vez_o_mesmo_inbound
-      voz_generica_de_ia
-    }
-    impl {
-      ts: cli.src.index.validarProfileSemantico
-    }
-    vinculos {
-      arquivo: "pacotes/cli/src/index.ts"
-      simbolo: cli.src.index.validarProfileSemantico
-    }
-    execucao {
-      idempotencia: verdadeiro
-      timeout: "10s"
-      retry: "nenhum"
-      criticidade_operacional: alta
-    }
-    guarantees {
-      resposta_cliente existe
-      resposta_cliente deve_ser aderente_ao_tom
-      resposta_cliente deve_ser responder_objecao
-      customer_reply existe
-      customer_reply deve_ser unica_saida_visivel
-      proxima_acao existe
-      proxima_acao deve_ser clara
-      escalar_humano existe
-      dedupe_key existe
-    }
-    tests {
-      caso "lead indeciso recebe resposta com proxima acao" {
-        given {
-          mensagem_cliente: "Ainda estou comparando opcoes."
-          contexto: "etapa comparacao, intencao comprar, sentimento INDECISO, objecao confianca, ultima mensagem Ainda estou comparando opcoes, ultima resposta visivel vazia"
-          politica: "tom comercial persuasivo, formalidade media, proibido prometer preco ou prazo sem base"
-          estado_turno: "conversation_id c1 evento_id msg1 canal WHATSAPP mensagem_cliente_visivel Ainda estou comparando opcoes resposta_anterior_visivel vazia etapa_atual comparacao dedupe_key msg1 origem_estado conversa_visivel"
-          conhecimento_autorizado: "pode oferecer diagnostico rapido"
-        }
-
-        expect {
-          sucesso: verdadeiro
-          escalar_humano: falso
-        }
-      }
-    }
-  }
-}
+module exemplos.profile_conversas {
+  docs {
+    resumo: "Exemplo oficial do profile Conversas: bot comercial para atendimento de cliente com tom persuasivo, estado visivel do turno, customer_reply como unica saida ao cliente, deduplicacao, limites de promessa, memoria curta e escalacao humana. Contrato primeiro: criar, editar ou remover contrato antes de qualquer acao."
+  }
+
+  type PoliticaTomConversa {
+    fields {
+      tom: Texto
+      formalidade: Texto
+      intensidade_persuasiva: Texto
+      proibicoes: Lista
+    }
+    invariants {
+      tom existe
+      formalidade existe
+      intensidade_persuasiva existe
+      proibicoes existe
+    }
+  }
+
+  type ContextoClienteConversa {
+    fields {
+      etapa: Texto
+      intencao_detectada: Texto
+      sentimento: Texto
+      objecoes: Lista
+      historico_resumido: Texto
+      ultima_mensagem_cliente: Texto
+      ultima_resposta_visivel: Texto
+      fatos_coletados: Lista
+      proxima_acao_esperada: Texto
+    }
+    invariants {
+      etapa existe
+      intencao_detectada existe
+      sentimento existe
+      historico_resumido existe
+      ultima_mensagem_cliente existe
+      ultima_resposta_visivel existe
+      fatos_coletados existe
+      proxima_acao_esperada existe
+    }
+  }
+
+  type EstadoTurnoConversa {
+    fields {
+      conversation_id: Id
+      evento_id: Id
+      canal: Texto
+      mensagem_cliente_visivel: Texto
+      resposta_anterior_visivel: Texto
+      etapa_atual: Texto
+      pergunta_anterior: Texto
+      confirmacao_curta: Booleano
+      dedupe_key: Texto
+      origem_estado: Texto
+    }
+    invariants {
+      conversation_id existe
+      evento_id existe
+      canal existe
+      mensagem_cliente_visivel existe
+      resposta_anterior_visivel existe
+      etapa_atual existe
+      dedupe_key existe
+      origem_estado existe
+    }
+  }
+
+  task responder_cliente_vendas {
+    input {
+      mensagem_cliente: Texto required
+      contexto: ContextoClienteConversa required
+      politica: PoliticaTomConversa required
+      estado_turno: EstadoTurnoConversa required
+      conhecimento_autorizado: Lista required
+    }
+    output {
+      resposta_cliente: Texto
+      customer_reply: Texto
+      proxima_acao: Texto
+      escalar_humano: Booleano
+      dedupe_key: Texto
+    }
+    rules {
+      mensagem_cliente deve_ser preenchida
+      contexto deve_ser valido
+      politica deve_ser com_tom_comercial_persuasivo
+      estado_turno deve_ser origem_conversa_visivel
+      estado_turno deve_ser deduplicado_por_evento
+      conhecimento_autorizado deve_ser nao_vazio
+      estado_turno.confirmacao_curta deve_ser interpretada_contra_pergunta_anterior
+    }
+    effects {
+      auditoria conversa_cliente criticidade = alta
+      evento resposta_bot_preparada criticidade = media
+    }
+    authz {
+      escopo: sema.conversas.responder
+      tenant: obrigatorio
+    }
+    dados {
+      classificacao_padrao: interno
+      redacao_log: parcial
+    }
+    audit {
+      evento: exemplos.conversas.resposta
+      ator: auth.agente
+      correlacao: conversation_id
+      retencao: "30d"
+      motivo: obrigatorio
+    }
+    forbidden {
+      promessa_sem_base
+      inventar_preco_ou_prazo
+      insistencia_agressiva
+      ignorar_objecao_cliente
+      reiniciar_conversa_apos_confirmacao_curta
+      repetir_saudacao_apos_contexto_existente
+      enviar_json_interno_ao_cliente
+      responder_mais_de_uma_vez_o_mesmo_inbound
+      voz_generica_de_ia
+    }
+    impl {
+      ts: cli.src.index.validarProfileSemantico
+    }
+    vinculos {
+      arquivo: "pacotes/cli/src/index.ts"
+      simbolo: cli.src.index.validarProfileSemantico
+    }
+    execucao {
+      idempotencia: verdadeiro
+      timeout: "10s"
+      retry: "nenhum"
+      criticidade_operacional: alta
+    }
+    guarantees {
+      resposta_cliente existe
+      resposta_cliente deve_ser aderente_ao_tom
+      resposta_cliente deve_ser responder_objecao
+      customer_reply existe
+      customer_reply deve_ser unica_saida_visivel
+      proxima_acao existe
+      proxima_acao deve_ser clara
+      escalar_humano existe
+      dedupe_key existe
+    }
+    tests {
+      caso "lead indeciso recebe resposta com proxima acao" {
+        given {
+          mensagem_cliente: "Ainda estou comparando opcoes."
+          contexto: "etapa comparacao, intencao comprar, sentimento INDECISO, objecao confianca, ultima mensagem Ainda estou comparando opcoes, ultima resposta visivel vazia"
+          politica: "tom comercial persuasivo, formalidade media, proibido prometer preco ou prazo sem base"
+          estado_turno: "conversation_id c1 evento_id msg1 canal WHATSAPP mensagem_cliente_visivel Ainda estou comparando opcoes resposta_anterior_visivel vazia etapa_atual comparacao dedupe_key msg1 origem_estado conversa_visivel"
+          conhecimento_autorizado: "pode oferecer diagnostico rapido"
+        }
+
+        expect {
+          sucesso: verdadeiro
+          escalar_humano: falso
+        }
+      }
+    }
+  }
+}

package/exemplos/profile_game.sema

@@ -111,4 +111,4 @@ module exemplos.profile.game {
       }
     }
   }
-}
+}

package/exemplos/profile_legal.sema

@@ -102,4 +102,4 @@ module exemplos.profile.legal {
       }
     }
   }
-}
+}

package/exemplos/profile_ops.sema

@@ -107,4 +107,4 @@ module exemplos.profile.ops {
       }
     }
   }
-}
+}

package/exemplos/profile_research.sema

@@ -101,4 +101,4 @@ module exemplos.profile.research {
       }
     }
   }
-}
+}

package/exemplos/profile_software.sema

@@ -120,4 +120,4 @@ module exemplos.profile.software {
       }
     }
   }
-}
+}

package/exemplos/profile_workflow_n8n.sema

@@ -96,4 +96,4 @@ module exemplos.profile.workflow_n8n {
     etapa concluir usa validar_workflow_n8n com runtime = "workflow n8n", adapter = "n8n", scorecard = "compatibilidade parcial" depende_de receber
     etapa bloquear usa validar_workflow_n8n com runtime = "workflow n8n", adapter = "n8n", scorecard = "bloqueio por lacuna" depende_de receber
   }
-}
+}

package/exemplos/relatorio.sema

@@ -90,4 +90,4 @@ module exemplos.relatorio {
       }
     }
   }
-}
+}

package/exemplos/replica_analitica_erp.sema

@@ -157,4 +157,4 @@ module exemplos.replica.analitica_erp {
       }
     }
   }
-}
+}

package/exemplos/testes_embutidos.sema

@@ -42,4 +42,4 @@ module exemplos.testes.embutidos {
       }
     }
   }
-}
+}