ledger-tasks-yylo

Referência da CLI do YYLO Ledger

Use yy ledger para todos os comandos. O Ledger 0.3.x expõe tanto os comandos de tarefa plana compatíveis quanto os grupos nativos record|task|wiki|workflow|artifact com ID primeiro. yy kanban é um alias de compatibilidade rotulado para o mesmo runtime de tarefa roteado pelo controlador.

Contrato de tarefa suportado

• Pré-instale yy ledger --version e yy ledger --help; a ajuda do comando é autoritária para o runtime selecionado.
• Use a superfície de tarefa plana para gerenciamento de tarefas do ciclo de vida. Use as habilidades nativas dedicadas para Registros de wiki, workflow e artefatos em vez de adivinhar seus argumentos.
• Novos PDRs operacionais, contratos, planos, relatórios, recibos e evidências pertencem a Registros de Artefatos tipados, não à documentação do produto, corpos/respostas de tarefas ou novos arquivos .juno_task/specs.
• Se um grupo nativo necessário estiver ausente, falhe fechado e solicite uma atualização do Ledger. Nunca invoque código fonte mutável diretamente ou escreva arquivos do store do Ledger manualmente.
• Leia o estado atual da tarefa antes da mutação, preserve os recibos de mutação onde oferecidos e nunca contorne o roteamento do controlador ou o estado do ciclo de vida com edições diretas de arquivos.
• A descoberta normal é apenas "hot" (em tempo real), a menos que um comando explícito de "cold-archive" (arquivo frio) seja usado.

Roteamento inter-projeto opt-in

O acesso inter-projeto está desativado por padrão. O .juno_task/config.json de origem deve definir kanbanRegistry.enabled: true e listar explicitamente allowedProjects; substituições de ambiente são YYLO_LEDGER_REGISTRY_ENABLED e YYLO_LEDGER_REGISTRY_ALLOWED_PROJECTS. Registre-se com yy ledger project add ALIAS --path /absolute/project, então roteie qualquer comando com --project ALIAS. O wrapper/runtime de destino permanece autoritário, e falhas de roteamento nunca retornam ao quadro de origem.

Comandos de compatibilidade de Tarefa Legado

CREATE — Adicionar uma nova tarefa

yy ledger create "Task description here" --status backlog --tags feature,backend

Opções: --status (backlog|todo|in_progress|done), --tags (separado por vírgula/espaço), --blocked-by (IDs de tarefa), --related-tasks (IDs de tarefa)

LIST — Navegar por tarefas com estatísticas resumidas

yy ledger list --limit 5 --sort asc
yy ledger list --status todo --sort asc
yy ledger list --status todo,in_progress --limit 10

SEARCH — Encontrar tarefas por critérios

yy ledger search --status todo --tag backend --limit 10
yy ledger search --body "OAuth" --open
yy ledger search --commit abc123

Filtros: --status, --tag, --body, --response, --commit, --open (sem agent_response), --recent, --exclude (excluir tags)

GET — Detalhes completos da tarefa (incluindo informações de dependência e detalhes de tarefas relacionadas)

yy ledger get TASK_ID

MARK — Atualizar status com mensagem de resposta obrigatória

yy ledger mark in_progress --id TASK_ID --response "Starting work on this"
yy ledger mark done --id TASK_ID --response "Completed: implemented X, tested Y" --commit abc123def
yy ledger mark todo --id TASK_ID --response "Reopening: found regression"

Obrigatório: --id e --response. Opcional: --commit (recomendado para done).

UPDATE — Modificar campos da tarefa

yy ledger update TASK_ID --status todo --tags backend,urgent
yy ledger update TASK_ID --commit abc123def
yy ledger update TASK_ID --response "Additional context"

ARCHIVE — Exclusão lógica (preserva dados, define status para archive)

yy ledger archive TASK_ID

Pacotes de arquivo frio imutáveis

list, search, ready e order normais são deliberadamente apenas "hot" (em tempo real). get TASK_ID exato resolve transparentemente uma tarefa "hot" ou uma tarefa arquivada somente leitura; use history TASK_ID explicitamente para seu ledger. Descubra tarefas "cold" (frias) apenas com saída archive-search limitada e projetada:

yy ledger archive-search --tag backend --before 2026-01-01 --limit 20 --projection metadata

Antes da manutenção do arquivo, verifique a versão/ajuda instalada e obtenha autorização explícita do proprietário. O repositório e o índice devem estar limpos, e os relatórios devem ser caminhos novos e duráveis fora do repositório:

yy ledger --version
yy ledger archive-pack plan --status done,archive --older-than 90d --max-tasks 1000 --target-bytes 26214400 --hard-max-bytes 47185920 --report /external/receipts/archive-plan.json
# Independently inspect selected IDs, revisions, source HEAD, policy, and plan hash.
yy ledger archive-pack create --plan /external/receipts/archive-plan.json --report /external/receipts/archive-create.json
yy ledger archive-pack doctor
yy ledger doctor

…