Fase 2 — Worker de coleta

[cpenaforte-clickbus]

Descrição

Fase 2 do plano — Worker. O script de ciclo, o workflow_call que o expõe, as flags de CLI que o
worker precisa, o guard de clone shallow, e o repositório privado com o agendamento.

O que entra

• scripts/iris-cycle.sh: descoberta, digest de refs, seleção, clone paralelo, laço do CLI e push
• .github/workflows/iris-ingestion-worker.yml com workflow_call como único gatilho
• As duas flags de CLI: --refs-digest e a que desliga o author_velocity
• O guard que desliga durability quando o clone chega shallow
• O caller agendado em RocketBus/iris-actions

Regra de ouro deste bloco

Nada nos dois arquivos do RocketBus/iris nomeia uma organização — o que os torna reaproveitáveis por
qualquer outra (§3.4, e regra 6 do CLAUDE.md: "Iris is open source — never hardcode ClickBus/RocketBus
names, URLs, sample data, or defaults"). Nenhum secret e nenhum agendamento entram no repo público.

Se encaixa em qual estágio?

Stage 2 — Ingestion: reliability of CLI → /api/ingest pipeline. A leitura centralizada da API do
GitHub reabre o non-goal de integrações externas do CLAUDE.md; a nota de governança da §2.2 do DD
registra que a exceção pedida é a mesma já concedida ao Datadog (014_org_integrations.sql +
/api/cron/sync-integrations).

Definição de feito

Todas as issues filhas fechadas.

Links

• DD 0010 §3.1, §3.4 e §6 (Fase 2): https://github.com/RocketBus/clickbus-rfc-design-docs/blob/main/design-docs/DD0010-Coleta-Centralizada-de-Atribuicao-do-Iris.md
• Épico: RocketBus/billing#63