Use Registros de Artefatos YYLO

Trate o Ledger como a fonte da verdade para identidade e metadados de artefatos. Use yy ledger em um controlador YYLO ou yylo-ledger de forma independente. Inspecione COMMAND artifact --help; se indisponível, não crie arquivos de armazenamento manualmente. Um Registro de Artefato do Ledger é evidência durável, não um artefato de release npm/Python e não um pedido implícito para publicar ou implantar.

Classifique antes de capturar

Escolha o perfil que corresponde à evidência:

• stdout: saída de processo delimitada;
• model-output: resposta de um agente/modelo;
• report: um resultado legível gerado por humanos ou máquinas;
• receipt: evidência que vincula uma operação e seus inputs/resultado.

Escolha o modo de payload deliberadamente:

• inline: pequenos bytes imutáveis embutidos no Registro;
• local: bytes imutáveis endereçados por conteúdo no armazenamento do Ledger;
• external: bytes externos imutáveis com URI, digest e tamanho;
• link: referência de URI sem garantia de bytes imutáveis.

Prefira evidência imutável quando a verificação posterior depender de bytes exatos. Um link nunca deve ser apresentado como prova endereçada por conteúdo.

Crie explicitamente

Use transporte de arquivo/stdin e forneça o tipo de mídia:

yy ledger artifact create --title "Focused test report" --profile report \
  --mode local --media-type application/json --file report.json

Para conteúdo imutável externo, forneça a URI suportada, o digest SHA-256 e o tamanho mostrado pela ajuda instalada. Nunca embuta credenciais de URI. O Ledger rejeita esquemas inseguros, travessia, incompatibilidades de tamanho/digest, captura excessiva e padrões de segredo conhecidos.

Anexe apenas proveniência suportada e não secreta, como identidade de ator, agente, modelo, sessão, execução, invocação, tarefa ou fluxo de trabalho. A proveniência de tarefa/fluxo de trabalho usa IDs de Registro imutáveis. Selecione temporary, standard ou permanent de retenção deliberadamente; metadados de retenção não autorizam a exclusão por si só.

Limite operacional-documental

Armazene novos PDRs, contratos de arquitetura e migração, planos, relatórios, recibos e evidências de execução como Registros de Artefatos. Rascunhe em um novo arquivo externo, capture-o com um perfil intencional e modo de payload imutável, leia-o de volta e verifique seu ID, digest, tamanho, proveniência, retenção e histórico antes de remover o rascunho. Use o perfil report para PDRs/contratos legíveis por humanos a menos que a ajuda instalada forneça um perfil aprovado mais específico.

O produto docs/ é apenas para documentação enviada como parte do produto. Nunca coloque evidências operacionais lá para fabricar um diff de produto de tarefa. Preserve arquivos legados .juno_task/specs, mas não crie novos como fallback. Se a API de artefatos instalada estiver indisponível, pare com o rascunho externo intacto e solicite um upgrade do Ledger; não o coloque em corpos de tarefa, respostas, documentos de produto, ou caminhos de controlador gerenciados manualmente.

Encontre e verifique

yy ledger artifact search --profile report --projection summary --limit 20 -f json
yy ledger artifact get RECORD_ID -f json
yy ledger artifact history RECORD_ID -f ndjson

Use projeções de metadados/resumo delimitadas antes de solicitar detalhes do payload. Verifique perfil, modo, tipo de mídia, digest, tamanho, proveniência, retenção, revisão e ID imutável antes de confiar na evidência.

Payloads de artefatos são evidências imutáveis. Represente a substituição com relações predecessora/sucessora explícitas e o contrato de atualização seguro contra revisão instalado; não sobrescreva bytes ou edite objetos de conteúdo. Arquivamento é uma transição de ciclo de vida, não exclusão. Release, publicação, upload externo, execução de retenção e mutação de produção sempre exigem autoridade separada.

Solicitação completa

$ARGUMENTS

Quando Usar

• Você precisa capturar ou recuperar Registros de Artefatos duráveis do YYLO Ledger (stdout, saída de modelo, relatório, recibo) com proveniência, retenção e payloads imutáveis.
• Novos PDRs operacionais, contratos, planos, relatórios e recibos pertencem aqui - não em documentos de produto, corpos de tarefa ou novos arquivos .juno_task/specs.

Limitações

• Payloads são imutáveis: represente a substituição com relações predecessora/sucessora, nunca sobrescrevendo bytes. Arquivamento é uma transição de ciclo de vida, não exclusão.
• Apenas seguro para segredos: nunca embuta credenciais de URI; o Ledger rejeita esquemas inseguros, travessia, incompatibilidades de tamanho/digest e padrões de segredo conhecidos.
• Metadados de retenção nunca autorizam a exclusão; release, publicação, upload e mutação de produção sempre precisam de autoridade separada.

Exemplo

…