O catálogo

O catálogo é servido por um portal, não por este site. É lá que contratos são buscados, comparados e resolvidos pela CLI — ver O portal.

Por que não está aqui

Um catálogo pertence a quem o publica. Listar os contratos de uma organização como seção da documentação do Oren diria que eles fazem parte do Oren — e não fazem. São as tasks de uma organização, com o mesmo estatuto das de qualquer outra.

Isso importa mais do que parece. O modelo inteiro se apoia em implementações serem comparadas pelo privilégio que exigem, e em ser oficial não ter peso nesse ranking. Documentação que destaca os contratos de uma organização põe o dedo exatamente nessa balança.

Os workers de referência

Os contratos usados como exemplo ao longo desta documentação são publicados pela techlite, e o código deles está no repositório de workers — um diretório por task, cada um com um README gerado cobrindo entradas, saídas, dependências e implementações.

Existem para provar que os contratos são implementáveis e dar um ponto de partida. Uma implementação de terceiro que peça menos privilégio é objetivamente melhor.

Navegando um catálogo

export OREN_REGISTRY=https://seu-portal
oren add techlite/analyze-commits

O oren add mostra o que uma task exige do seu ambiente, e o custo de cada implementação disponível, antes de você usá-la. A interface web do portal mostra o mesmo, lado a lado.