@semacode/cli 2.2.0 → 2.3.1

package/exemplos/pipeline-conteudo/definicao.json

@@ -1,136 +1,136 @@
-{
-  "schemaVersion": "sema.content.pipeline/v1",
-  "pipelineId": "conteudo-multidestino-exemplo",
-  "version": "1.0.0",
-  "stages": [
-    {
-      "stageId": "pauta",
-      "capability": "content.topic.plan",
-      "scope": "GLOBAL",
-      "adapterPolicy": "NONE",
-      "dependsOn": [],
-      "produces": ["briefing-editorial"],
-      "gateIds": []
-    },
-    {
-      "stageId": "pesquisa",
-      "capability": "content.research.collect",
-      "scope": "GLOBAL",
-      "adapterPolicy": "NONE",
-      "dependsOn": ["pauta"],
-      "produces": ["dossie-fontes"],
-      "gateIds": []
-    },
-    {
-      "stageId": "conteudo-mestre",
-      "capability": "content.master.compose",
-      "scope": "GLOBAL",
-      "adapterPolicy": "NONE",
-      "dependsOn": ["pesquisa"],
-      "produces": ["conteudo-mestre"],
-      "gateIds": ["qa-mestre"]
-    },
-    {
-      "stageId": "adaptacao",
-      "capability": "content.target.adapt",
-      "scope": "POR_ALVO",
-      "adapterPolicy": "CONSTRAINTS",
-      "dependsOn": ["conteudo-mestre"],
-      "produces": ["conteudo-adaptado"],
-      "gateIds": ["qa-destino"]
-    },
-    {
-      "stageId": "entrega",
-      "capability": "content.target.deliver",
-      "scope": "POR_ALVO",
-      "adapterPolicy": "CONFIRMATION",
-      "dependsOn": ["adaptacao"],
-      "produces": ["confirmacao-entrega"],
-      "gateIds": ["confirmacao-externa"]
-    }
-  ],
-  "gates": [
-    {
-      "gateId": "qa-mestre",
-      "stageId": "conteudo-mestre",
-      "scope": "GLOBAL",
-      "evaluationMode": "IA_ESPECIALIZADA",
-      "requiredEvidence": ["artifact.digest.observed"],
-      "evaluatorCapabilities": ["content.qa.factual", "content.qa.editorial"],
-      "minAttestationsPerEvidence": 1,
-      "minDistinctAttesterControlDomains": 1,
-      "minApprovals": 2,
-      "minDistinctControlDomains": 2,
-      "producerDisjoint": true,
-      "rejectionIsBinding": true,
-      "rubricDigest": "sha256:1111111111111111111111111111111111111111111111111111111111111111"
-    },
-    {
-      "gateId": "qa-destino",
-      "stageId": "adaptacao",
-      "scope": "POR_ALVO",
-      "evaluationMode": "HIBRIDA",
-      "requiredEvidence": ["adapter.constraints.passed"],
-      "evaluatorCapabilities": ["content.qa.target-fit"],
-      "minAttestationsPerEvidence": 1,
-      "minDistinctAttesterControlDomains": 1,
-      "minApprovals": 1,
-      "minDistinctControlDomains": 1,
-      "producerDisjoint": true,
-      "rejectionIsBinding": true,
-      "rubricDigest": "sha256:2222222222222222222222222222222222222222222222222222222222222222"
-    },
-    {
-      "gateId": "confirmacao-externa",
-      "stageId": "entrega",
-      "scope": "POR_ALVO",
-      "evaluationMode": "DETERMINISTICA",
-      "requiredEvidence": ["destination.delivery.observed"],
-      "evaluatorCapabilities": [],
-      "minAttestationsPerEvidence": 1,
-      "minDistinctAttesterControlDomains": 1,
-      "minApprovals": 1,
-      "minDistinctControlDomains": 1,
-      "producerDisjoint": true,
-      "rejectionIsBinding": true,
-      "rubricDigest": "sha256:3333333333333333333333333333333333333333333333333333333333333333"
-    }
-  ],
-  "adapters": [
-    {
-      "adapterId": "destination.document",
-      "version": "1.0.0",
-      "capabilities": ["content.target.deliver", "content.target.confirm"],
-      "acceptedMediaTypes": ["text/html", "text/markdown"],
-      "formatProfiles": ["long-form"],
-      "deterministicConstraints": [
-        {
-          "constraintId": "document-non-empty",
-          "kind": "artifact.bytes.min",
-          "config": { "minimum": 1 }
-        }
-      ],
-      "requiredMetadata": ["title"],
-      "optionalMetadata": [],
-      "confirmationPredicates": ["destination.delivery.observed"]
-    },
-    {
-      "adapterId": "destination.audio-feed",
-      "version": "1.0.0",
-      "capabilities": ["content.target.deliver", "content.target.confirm"],
-      "acceptedMediaTypes": ["audio/mpeg", "audio/mp4"],
-      "formatProfiles": ["spoken-episode"],
-      "deterministicConstraints": [
-        {
-          "constraintId": "audio-duration-positive",
-          "kind": "media.duration.min",
-          "config": { "minimum": 1 }
-        }
-      ],
-      "requiredMetadata": ["title", "description"],
-      "optionalMetadata": [],
-      "confirmationPredicates": ["destination.delivery.observed"]
-    }
-  ],
-  "requiredCompletionGates": ["qa-mestre", "qa-destino", "confirmacao-externa"]
-}
+{
+  "schemaVersion": "sema.content.pipeline/v1",
+  "pipelineId": "conteudo-multidestino-exemplo",
+  "version": "1.0.0",
+  "stages": [
+    {
+      "stageId": "pauta",
+      "capability": "content.topic.plan",
+      "scope": "GLOBAL",
+      "adapterPolicy": "NONE",
+      "dependsOn": [],
+      "produces": ["briefing-editorial"],
+      "gateIds": []
+    },
+    {
+      "stageId": "pesquisa",
+      "capability": "content.research.collect",
+      "scope": "GLOBAL",
+      "adapterPolicy": "NONE",
+      "dependsOn": ["pauta"],
+      "produces": ["dossie-fontes"],
+      "gateIds": []
+    },
+    {
+      "stageId": "conteudo-mestre",
+      "capability": "content.master.compose",
+      "scope": "GLOBAL",
+      "adapterPolicy": "NONE",
+      "dependsOn": ["pesquisa"],
+      "produces": ["conteudo-mestre"],
+      "gateIds": ["qa-mestre"]
+    },
+    {
+      "stageId": "adaptacao",
+      "capability": "content.target.adapt",
+      "scope": "POR_ALVO",
+      "adapterPolicy": "CONSTRAINTS",
+      "dependsOn": ["conteudo-mestre"],
+      "produces": ["conteudo-adaptado"],
+      "gateIds": ["qa-destino"]
+    },
+    {
+      "stageId": "entrega",
+      "capability": "content.target.deliver",
+      "scope": "POR_ALVO",
+      "adapterPolicy": "CONFIRMATION",
+      "dependsOn": ["adaptacao"],
+      "produces": ["confirmacao-entrega"],
+      "gateIds": ["confirmacao-externa"]
+    }
+  ],
+  "gates": [
+    {
+      "gateId": "qa-mestre",
+      "stageId": "conteudo-mestre",
+      "scope": "GLOBAL",
+      "evaluationMode": "IA_ESPECIALIZADA",
+      "requiredEvidence": ["artifact.digest.observed"],
+      "evaluatorCapabilities": ["content.qa.factual", "content.qa.editorial"],
+      "minAttestationsPerEvidence": 1,
+      "minDistinctAttesterControlDomains": 1,
+      "minApprovals": 2,
+      "minDistinctControlDomains": 2,
+      "producerDisjoint": true,
+      "rejectionIsBinding": true,
+      "rubricDigest": "sha256:1111111111111111111111111111111111111111111111111111111111111111"
+    },
+    {
+      "gateId": "qa-destino",
+      "stageId": "adaptacao",
+      "scope": "POR_ALVO",
+      "evaluationMode": "HIBRIDA",
+      "requiredEvidence": ["adapter.constraints.passed"],
+      "evaluatorCapabilities": ["content.qa.target-fit"],
+      "minAttestationsPerEvidence": 1,
+      "minDistinctAttesterControlDomains": 1,
+      "minApprovals": 1,
+      "minDistinctControlDomains": 1,
+      "producerDisjoint": true,
+      "rejectionIsBinding": true,
+      "rubricDigest": "sha256:2222222222222222222222222222222222222222222222222222222222222222"
+    },
+    {
+      "gateId": "confirmacao-externa",
+      "stageId": "entrega",
+      "scope": "POR_ALVO",
+      "evaluationMode": "DETERMINISTICA",
+      "requiredEvidence": ["destination.delivery.observed"],
+      "evaluatorCapabilities": [],
+      "minAttestationsPerEvidence": 1,
+      "minDistinctAttesterControlDomains": 1,
+      "minApprovals": 1,
+      "minDistinctControlDomains": 1,
+      "producerDisjoint": true,
+      "rejectionIsBinding": true,
+      "rubricDigest": "sha256:3333333333333333333333333333333333333333333333333333333333333333"
+    }
+  ],
+  "adapters": [
+    {
+      "adapterId": "destination.document",
+      "version": "1.0.0",
+      "capabilities": ["content.target.deliver", "content.target.confirm"],
+      "acceptedMediaTypes": ["text/html", "text/markdown"],
+      "formatProfiles": ["long-form"],
+      "deterministicConstraints": [
+        {
+          "constraintId": "document-non-empty",
+          "kind": "artifact.bytes.min",
+          "config": { "minimum": 1 }
+        }
+      ],
+      "requiredMetadata": ["title"],
+      "optionalMetadata": [],
+      "confirmationPredicates": ["destination.delivery.observed"]
+    },
+    {
+      "adapterId": "destination.audio-feed",
+      "version": "1.0.0",
+      "capabilities": ["content.target.deliver", "content.target.confirm"],
+      "acceptedMediaTypes": ["audio/mpeg", "audio/mp4"],
+      "formatProfiles": ["spoken-episode"],
+      "deterministicConstraints": [
+        {
+          "constraintId": "audio-duration-positive",
+          "kind": "media.duration.min",
+          "config": { "minimum": 1 }
+        }
+      ],
+      "requiredMetadata": ["title", "description"],
+      "optionalMetadata": [],
+      "confirmationPredicates": ["destination.delivery.observed"]
+    }
+  ],
+  "requiredCompletionGates": ["qa-mestre", "qa-destino", "confirmacao-externa"]
+}

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