Busca no GitHub
Uma execução de fetch (busca) segue o mesmo processo para toda tarefa no GitHub: analisar → prever → buscar ou fazer checkout.
Etapas
1. Analisar
Analisar owner/repo (+ número de issue/PR, se presente) a partir da URL ou texto do usuário.
Critério de conclusão: owner/repo identificado (ou usuário solicitado a esclarecer).
2. Prever
Antes do checkout, decidir: esta tarefa exigirá mais de uma leitura de arquivo ou uma pesquisa em todo o repositório (Grep/Glob)?
- Não → buscar branch (Etapa 3).
- Sim → fazer checkout do branch (Etapa 4).
- A tarefa se expande durante a execução → re-prever antes do segundo acesso; trocar de branch se necessário.
Critério de conclusão: branch escolhido e registrado (fetch vs checkout).
3. Buscar branch
Siga GH-COMMANDS.md para o tipo de URL. Arquivo único: gh api repos/owner/repo/contents/path?ref=branch.
Critério de conclusão: conteúdo solicitado retornado via gh; nenhum checkout iniciado.
4. Fazer checkout do branch
Siga CHECKOUT.md — perguntar pelo caminho local, verificar remoto, clonar apenas com aprovação.
Critério de conclusão: caminho local verificado em uso, ou clone raso aprovado em um caminho absoluto conhecido; alvo de Leitura/Grep/Glob naquela árvore.
Alcance
Acesse o GitHub através do gh (buscar branch) ou de um caminho de checkout verificado. Se o gh estiver ausente ou não autenticado, WebFetch é o fallback.
Concluído quando: todo acesso passou por buscar ou checkout conforme a porta prever; WebFetch usado apenas em falha genuína do gh.