Use Registros de Fluxo de Trabalho YYLO

Trate o Ledger como a fonte da verdade para identidade de fluxo de trabalho, definição validada e histórico de revisão. Use yy ledger em um controlador YYLO ou yylo-ledger de forma independente. Inspecione COMMAND workflow --help; se o namespace estiver ausente, não o invente nem edite o armazenamento do Ledger diretamente.

Mantenha três limites distintos

1. O Ledger armazena e valida dados de fluxo de trabalho. Ele não executa fluxos de trabalho.
2. Um executor YYLO selecionado separadamente executa dados de fluxo de trabalho revisados. O armazenamento não concede autoridade de execução, rede, mutação, liberação ou implantação.
3. Registros de Artefatos retêm evidências de execução. Não substitua a definição do fluxo de trabalho por stdout, logs, saída do modelo, relatórios ou recibos.

O host do Ledger somente leitura também não possui ponto de extremidade de execução de fluxo de trabalho.

Descobrir e inspecionar

yy ledger workflow search --text "release verification" --projection summary --limit 20 -f json
yy ledger workflow get RECORD_ID -f json
yy ledger workflow get RECORD_ID --raw
yy ledger workflow get RECORD_ID --validated

Prefira IDs imutáveis após a descoberta. Use projeções delimitadas e escopo de arquivo explícito. --validated emite YAML normalizado somente após a validação do esquema.

Crie dados de fluxo de trabalho seguros

Um documento v1 de fluxo de trabalho requer um mapeamento com schema_version: v1, um workflow_id não vazio e uma lista steps cujos IDs de etapa não são vazios e são únicos.

schema_version: v1
workflow_id: focused-validation
steps:
  - id: test
    command: ["npm", "test"]

Crie através de transporte de arquivo/stdin:

yy ledger workflow create --title "Focused validation" --file workflow.yaml

O Ledger rejeita YAML inseguro ou não portátil, incluindo chaves duplicadas, aliases, âncoras, tags explícitas, estruturas recursivas, chaves de mapeamento não string, valores de data/hora implícitos, números não finitos, entrada CRLF e valores não suportados. Nunca enfraqueça a validação armazenando shell executável como um substituto não validado.

Revise com segurança

Leia a revisão e o histórico atuais, em seguida, siga o contrato de comparação e substituição workflow update --help instalado. Vincule atualizações à revisão esperada e pré-imagens/digests, valide o resultado e releia-o. Em caso de desvio, pare e reconcilie em vez de forçar. O arquivo é não destrutivo.

Antes da execução, congele o ID exato do Registro do fluxo de trabalho, a revisão, o digest do payload, a identidade do executor, as entradas e as autoridades concedidas. Após a execução, armazene saídas delimitadas sob artifact-yylo com proveniência de fluxo de trabalho/execução. Uma solicitação de execução nunca implica autoridade de mesclagem, liberação, publicação, implantação ou produção.

Solicitação completa

$ARGUMENTS

Quando Usar

• Você precisa encontrar, criar ou revisar atualizações seguras para Registros de Fluxo de Trabalho YYLO Ledger validados.
• Você deve manter os limites de armazenamento, execução e evidência de execução explícitos.

Limitações

• O Ledger armazena e valida dados de fluxo de trabalho; ele nunca executa fluxos de trabalho e não concede autoridade de execução, rede, mutação, liberação ou implantação.
• A evidência de execução pertence a registros artifact-yylo com proveniência de fluxo de trabalho/execução - nunca substitua a definição do fluxo de trabalho por saídas.
• Uma solicitação de execução nunca implica autoridade de mesclagem, liberação, publicação, implantação ou produção. Em caso de desvio de revisão, pare e reconcilie em vez de forçar.

Exemplo

yy ledger workflow search --text "release verification" --projection summary --limit 20 -f json
yy ledger workflow get RECORD_ID --validated

Adaptado de yylo-dev/yylo-skills (MIT) - v2.0.1; frontmatter, Quando Usar/Limitações e limites de segurança adicionados para conformidade upstream.