@semacode/cli 1.5.36 → 1.5.38

package/exemplos/operacao_estrategia_discovery.sema

@@ -0,0 +1,220 @@
+module exemplos.operacao_estrategia.discovery {
+  docs {
+    resumo: "Tasks oficiais de discovery semanal e avaliacao de slice apos discovery."
+  }
+
+  type JanelaDiscovery {
+    fields {
+      semana_referencia: Data
+      strategy_id: Id
+      versao_modelo_candidata: Texto
+      status_discovery: StatusDiscovery
+    }
+    invariants {
+      semana_referencia existe
+      strategy_id existe
+      versao_modelo_candidata existe
+      status_discovery em [ABERTA, EM_AVALIACAO, APROVADA, REJEITADA]
+    }
+  }
+
+  enum StatusSlice {
+    ATIVO,
+    QUARENTENA,
+    DESLIGADO
+  }
+
+  enum StatusGate {
+    ABERTO,
+    FECHADO
+  }
+
+  enum StatusDiscovery {
+    ABERTA,
+    EM_AVALIACAO,
+    APROVADA,
+    REJEITADA
+  }
+
+  task registrar_discovery_semanal {
+    docs {
+      resumo: "Abre a janela semanal de discovery para uma strategy e marca a versao candidata que esta entrando em avaliacao."
+    }
+    input {
+      strategy_id: Id required
+      semana_referencia: Data required
+      versao_modelo_candidata: Texto required
+    }
+    output {
+      janela: JanelaDiscovery
+      discovery_registrada: Booleano
+    }
+    authz {
+      escopo: strategy.discovery.operar
+      tenant: obrigatorio
+    }
+    dados {
+      classificacao_padrao: interno
+      redacao_log: obrigatoria
+      input {
+        strategy_id: interno
+        semana_referencia: interno
+        versao_modelo_candidata: interno
+      }
+      output {
+        janela: interno
+        discovery_registrada: interno
+      }
+    }
+    audit {
+      evento: strategy.discovery.aberta
+      ator: sistema.strategy
+      correlacao: request_id
+      retencao: "180d"
+      motivo: obrigatorio
+    }
+    forbidden {
+      shell.exec
+      log.segredo
+      retorno.credencial
+    }
+    rules {
+      strategy_id existe
+      semana_referencia existe
+      versao_modelo_candidata existe
+    }
+    effects {
+      persistencia discovery_semanal criticidade = alta
+      auditoria strategy criticidade = alta
+      evento discovery_aberta criticidade = media
+    }
+    vinculos {
+      tabela: discovery_semanal
+      recurso: strategy_registry
+      evento: discovery_aberta
+    }
+    execucao {
+      idempotencia: verdadeiro
+      timeout: "10s"
+      retry: "nenhum"
+      compensacao: "fechar_janela_discovery_inconsistente"
+      criticidade_operacional: alta
+    }
+    guarantees {
+      janela existe
+      discovery_registrada == verdadeiro
+    }
+    tests {
+      caso "abre discovery da semana" {
+        given {
+          strategy_id: "strategy_alpha"
+          semana_referencia: "2026-03-30"
+          versao_modelo_candidata: "modelo_2026_13"
+        }
+
+        expect {
+          sucesso: verdadeiro
+          discovery_registrada: verdadeiro
+          janela: "janela_strategy_alpha_2026_13"
+        }
+      }
+    }
+  }
+
+  task avaliar_slice_apos_discovery {
+    docs {
+      resumo: "Decide se um slice segue aberto,entra em quarentena ou precisa ficar bloqueado ate nova avaliacao."
+    }
+    input {
+      strategy_id: Id required
+      slice_id: Id required
+      precision_observada: Decimal required
+      precision_minima: Decimal required
+      risco_operacional: Texto required
+    }
+    output {
+      gate_slice: StatusGate
+      slice_status: StatusSlice
+      motivo_operacional: Texto
+    }
+    authz {
+      escopo: strategy.slice.avaliar
+      tenant: obrigatorio
+    }
+    dados {
+      classificacao_padrao: interno
+      redacao_log: obrigatoria
+      input {
+        strategy_id: interno
+        slice_id: interno
+        precision_observada: interno
+        precision_minima: interno
+        risco_operacional: interno
+      }
+      output {
+        gate_slice: interno
+        slice_status: interno
+        motivo_operacional: interno
+      }
+    }
+    audit {
+      evento: strategy.slice.avaliado
+      ator: sistema.strategy
+      correlacao: request_id
+      retencao: "180d"
+      motivo: obrigatorio
+    }
+    forbidden {
+      shell.exec
+      log.segredo
+      retorno.credencial
+    }
+    rules {
+      strategy_id existe
+      slice_id existe
+      precision_observada existe
+      precision_minima existe
+      risco_operacional existe
+    }
+    effects {
+      persistencia slice criticidade = alta
+      auditoria discovery_slice criticidade = alta
+      notificacao operacao criticidade = media
+    }
+    vinculos {
+      tabela: slice
+      recurso: strategy_registry
+      evento: discovery_slice_avaliado
+    }
+    execucao {
+      idempotencia: verdadeiro
+      timeout: "10s"
+      retry: "nenhum"
+      compensacao: "manter_gate_slice_fechado_ate_reavaliacao"
+      criticidade_operacional: alta
+    }
+    guarantees {
+      gate_slice existe
+      slice_status existe
+      motivo_operacional existe
+    }
+    tests {
+      caso "slice ruim fecha gate na avaliacao" {
+        given {
+          strategy_id: "strategy_alpha"
+          slice_id: "slice_under35_serie_a"
+          precision_observada: 0.49
+          precision_minima: 0.58
+          risco_operacional: "drawdown_excessivo"
+        }
+
+        expect {
+          sucesso: verdadeiro
+          gate_slice: "FECHADO"
+          slice_status: "QUARENTENA"
+          motivo_operacional: "drawdown_excessivo"
+        }
+      }
+    }
+  }
+}

package/exemplos/operacao_estrategia_fluxo.sema

@@ -0,0 +1,114 @@
+module exemplos.operacao_estrategia.fluxo {
+  docs {
+    resumo: "Flow oficial de governanca operacional com stubs curtos para manter a orquestracao validavel sem virar contrato monolitico."
+  }
+
+  enum StatusStrategy {
+    RASCUNHO,
+    ATIVA,
+    QUARENTENA,
+    DESATIVADA
+  }
+
+  enum StatusGate {
+    ABERTO,
+    FECHADO
+  }
+
+  task registrar_discovery_semanal {
+    input {
+      strategy_id: Id required
+      semana_referencia: Data required
+      versao_modelo_candidata: Texto required
+    }
+    output {
+      discovery_registrada: Booleano
+    }
+    guarantees {
+      discovery_registrada existe
+    }
+  }
+
+  task avaliar_slice_apos_discovery {
+    input {
+      strategy_id: Id required
+      slice_id: Id required
+      precision_observada: Decimal required
+      precision_minima: Decimal required
+      risco_operacional: Texto required
+    }
+    output {
+      motivo_operacional: Texto
+    }
+    guarantees {
+      motivo_operacional existe
+    }
+  }
+
+  task colocar_slice_em_quarentena {
+    input {
+      strategy_id: Id required
+      slice_id: Id required
+      motivo: Texto required
+      origem: Texto required
+      data_referencia: Data required
+    }
+    output {
+      gate_slice: StatusGate
+    }
+    guarantees {
+      gate_slice existe
+    }
+  }
+
+  task fechar_gate_global_strategy {
+    input {
+      strategy_id: Id required
+      motivo_operacional: Texto required
+      versao_modelo_ativa: Texto required
+    }
+    output {
+      gate_global: StatusGate
+    }
+    guarantees {
+      gate_global existe
+    }
+  }
+
+  task ativar_strategy_com_nova_versao {
+    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
+    }
+    guarantees {
+      strategy_status existe
+    }
+  }
+
+  flow governanca_operacional {
+    strategy_id: Id
+    slice_id: Id
+    semana_referencia: Data
+    versao_modelo_ativa: Texto
+    versao_modelo_candidata: Texto
+    precision_observada: Decimal
+    precision_minima: Decimal
+    risco_operacional: Texto
+    motivo_operacional: Texto
+    strategy_status_atual: StatusStrategy
+    gate_global_atual: StatusGate
+    aprovacao_manual: Booleano
+    etapa discovery usa registrar_discovery_semanal com strategy_id = strategy_id, semana_referencia = semana_referencia, versao_modelo_candidata = versao_modelo_candidata
+    etapa avaliar_slice usa avaliar_slice_apos_discovery com strategy_id = strategy_id, slice_id = slice_id, precision_observada = precision_observada, precision_minima = precision_minima, risco_operacional = risco_operacional depende_de discovery
+    etapa quarentena_slice usa colocar_slice_em_quarentena com strategy_id = strategy_id, slice_id = slice_id, motivo = motivo_operacional, origem = risco_operacional, data_referencia = semana_referencia quando motivo_operacional existe depende_de avaliar_slice
+    etapa fechar_gate_global usa fechar_gate_global_strategy com strategy_id = strategy_id, motivo_operacional = motivo_operacional, versao_modelo_ativa = versao_modelo_ativa quando motivo_operacional existe depende_de quarentena_slice
+    etapa reativacao usa ativar_strategy_com_nova_versao com strategy_id = strategy_id, versao_modelo_ativa = versao_modelo_ativa, versao_modelo_candidata = versao_modelo_candidata, strategy_status_atual = strategy_status_atual, gate_global_atual = gate_global_atual, aprovacao_manual = aprovacao_manual quando aprovacao_manual == verdadeiro depende_de fechar_gate_global
+  }
+}

package/exemplos/operacao_estrategia_gates.sema

@@ -0,0 +1,106 @@
+module exemplos.operacao_estrategia.gates {
+  docs {
+    resumo: "Task oficial para fechamento do gate global de uma strategy com trilha auditavel."
+  }
+
+  enum StatusStrategy {
+    RASCUNHO,
+    ATIVA,
+    QUARENTENA,
+    DESATIVADA
+  }
+
+  enum StatusGate {
+    ABERTO,
+    FECHADO
+  }
+
+  task fechar_gate_global_strategy {
+    docs {
+      resumo: "Fecha o gate global quando a strategy inteira precisa parar de liberar sem apagar historico nem perder a trilha da versao ativa."
+    }
+    input {
+      strategy_id: Id required
+      motivo_operacional: Texto required
+      versao_modelo_ativa: Texto required
+    }
+    output {
+      strategy_status: StatusStrategy
+      gate_global: StatusGate
+      versao_modelo_ativa: Texto
+    }
+    authz {
+      escopo: strategy.gate.fechar
+      tenant: obrigatorio
+    }
+    dados {
+      classificacao_padrao: interno
+      redacao_log: obrigatoria
+      input {
+        strategy_id: interno
+        motivo_operacional: interno
+        versao_modelo_ativa: interno
+      }
+      output {
+        strategy_status: interno
+        gate_global: interno
+        versao_modelo_ativa: interno
+      }
+    }
+    audit {
+      evento: strategy.gate_global.fechado
+      ator: sistema.strategy
+      correlacao: request_id
+      retencao: "180d"
+      motivo: obrigatorio
+    }
+    forbidden {
+      shell.exec
+      log.segredo
+      retorno.credencial
+    }
+    rules {
+      strategy_id existe
+      motivo_operacional existe
+      versao_modelo_ativa existe
+    }
+    effects {
+      persistencia strategy criticidade = alta
+      notificacao operacao criticidade = alta
+      auditoria gate_global criticidade = alta
+    }
+    vinculos {
+      tabela: strategy
+      recurso: strategy_registry
+      evento: gate_global_fechado
+    }
+    execucao {
+      idempotencia: verdadeiro
+      timeout: "10s"
+      retry: "nenhum"
+      compensacao: "manter_strategy_em_quarentena"
+      criticidade_operacional: alta
+    }
+    guarantees {
+      strategy_status == QUARENTENA
+      gate_global == FECHADO
+      versao_modelo_ativa existe
+    }
+    tests {
+      caso "fecha gate global sem perder versao ativa" {
+        given {
+          strategy_id: "strategy_alpha"
+          motivo_operacional: "sequencia_ruim_em_varias_ligas"
+          versao_modelo_ativa: "modelo_2026_12"
+        }
+
+        expect {
+          sucesso: verdadeiro
+          strategy_status: "QUARENTENA"
+          gate_global: "FECHADO"
+          versao_modelo_ativa: "modelo_2026_12"
+        }
+      }
+    }
+  }
+}

package/exemplos/operacao_estrategia_quarentena.sema

@@ -0,0 +1,133 @@
+module exemplos.operacao_estrategia.quarentena {
+  docs {
+    resumo: "Task oficial para colocar slice em quarentena seletiva sem desligar a strategy inteira."
+  }
+
+  type ContextoQuarentena {
+    fields {
+      motivo: Texto
+      origem: Texto
+      desde: Data
+    }
+    invariants {
+      motivo existe
+      origem existe
+      desde existe
+    }
+  }
+
+  enum StatusSlice {
+    ATIVO,
+    QUARENTENA,
+    DESLIGADO
+  }
+
+  enum StatusGate {
+    ABERTO,
+    FECHADO
+  }
+
+  task colocar_slice_em_quarentena {
+    docs {
+      resumo: "Transforma um problema de slice em acao operacional explicita,sem desligar a strategy inteira por reflexo idiota."
+    }
+    input {
+      strategy_id: Id required
+      slice_id: Id required
+      motivo: Texto required
+      origem: Texto required
+      data_referencia: Data required
+    }
+    output {
+      slice_status: StatusSlice
+      gate_slice: StatusGate
+      contexto: ContextoQuarentena
+    }
+    authz {
+      escopo: strategy.slice.quarentena
+      tenant: obrigatorio
+    }
+    dados {
+      classificacao_padrao: interno
+      redacao_log: obrigatoria
+      input {
+        strategy_id: interno
+        slice_id: interno
+        motivo: interno
+        origem: interno
+        data_referencia: interno
+      }
+      output {
+        slice_status: interno
+        gate_slice: interno
+        contexto: interno
+      }
+    }
+    audit {
+      evento: strategy.slice.quarentena
+      ator: sistema.strategy
+      correlacao: request_id
+      retencao: "180d"
+      motivo: obrigatorio
+    }
+    forbidden {
+      shell.exec
+      log.segredo
+      retorno.credencial
+    }
+    rules {
+      strategy_id existe
+      slice_id existe
+      motivo existe
+      origem existe
+      data_referencia existe
+    }
+    effects {
+      persistencia slice criticidade = alta
+      persistencia quarentena criticidade = alta
+      notificacao operacao criticidade = alta
+      auditoria quarentena criticidade = alta
+    }
+    vinculos {
+      tabela: slice
+      tabela: quarentena
+      recurso: strategy_registry
+      evento: slice_quarentena
+    }
+    execucao {
+      idempotencia: verdadeiro
+      timeout: "10s"
+      retry: "nenhum"
+      compensacao: "reabrir_slice_por_revisao_manual"
+      criticidade_operacional: alta
+    }
+    state governanca_estrategia {
+      transitions {
+        ATIVA -> QUARENTENA
+      }
+    }
+    guarantees {
+      slice_status == QUARENTENA
+      gate_slice == FECHADO
+      contexto existe
+    }
+    tests {
+      caso "quarentena seletiva fecha so o slice afetado" {
+        given {
+          strategy_id: "strategy_alpha"
+          slice_id: "slice_under35_serie_a"
+          motivo: "llm_detectou_noticia_ruim"
+          origem: "monitoramento_live"
+          data_referencia: "2026-03-30"
+        }
+
+        expect {
+          sucesso: verdadeiro
+          slice_status: "QUARENTENA"
+          gate_slice: "FECHADO"
+          contexto: "ctx_quarentena"
+        }
+      }
+    }
+  }
+}

package/exemplos/operacao_estrategia_rollout.sema

@@ -0,0 +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"
+        }
+      }
+    }
+  }
+}

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
     }
   }
-}
+}