Guias
Trabalhe em várias máquinas
Coordene reservas e consulte retratos compartilhados sem transportar credenciais.
Adesão é uma operação explícita
A fábrica compartilhada usa branches de estado no remoto para reservas e retratos de máquinas. A adesão é da máquina, não do projeto: ork fabrica entrar publica o primeiro retrato; execute apenas quando essa participação estiver autorizada. O pedido do time no orkastery.yaml (fabrica.compartilhada: true) não liga a publicação: o manifesto vem com o repositório, e só a máquina decide publicar o retrato dela. Cada máquina faz seu próprio login do runtime.
fabrica.remoto é o nome de um remoto do git já configurado no clone, não uma URL: só letras, dígitos, ponto, sublinhado e hífen, sem hífen no começo, sem .. e com até 64 caracteres. O mesmo vale para o --remoto de ork fabrica, ork roadmap, ork ship registrar-pr, ork ci status e ork ship --para. Fora do formato, o valor nunca chega ao git: a recusa é tipada (fabrica.remoto-invalido, roadmap.remoto-invalido, ship.remoto-invalido ou ci.remoto-invalido) e mostra o valor redigido. Para outro servidor, crie o remoto com git remote add e ponha o nome no manifesto.
Consulte antes de assumir trabalho
Reservas evitam que duas máquinas assumam o mesmo item. Sem rede, consulte a última cópia e considere sua data. O retrato público não leva prompts, transcripts, credenciais ou caminhos locais. Uma decisão pendente precisa ser respondida pelo ingresso autenticado da máquina responsável.
ork board --sem-remoto
ork fabrica --sem-remotoA rede da pessoa: Orkastery Network
A fábrica compartilhada vive no remoto de um projeto. A rede junta as máquinas de uma pessoa, de todos os projetos, num repositório privado dela na forja, <usuario>/orkastery-network. ork network entrar cria a casa quando falta, publica o primeiro retrato e só então grava a adesão; depois, a máquina publica sozinha na batida do pulse e nos eventos de thread. A identidade vem do gh ou do glab já autenticados; o ork nunca lê token. Quem já fez ork fabrica entrar é membro sem refazer nada.
A casa recebe nome, hostname, forja e login, runtimes e hosts com a versão, projetos com remoto sem credencial e a última batida. Nunca recebe token, senha, e-mail da conta, plano pago, caminho de arquivo de credencial, prompt, transcript ou log. Publicar exige a casa privada, conferida na forja, e só por HTTPS.
O ork doctor tem a linha rede: adesão, casa, última batida e última falha do rede.log. Ele só lê arquivos locais e nunca bloqueia; vira aviso quando a falha é mais nova que a batida ou quando a batida passou de 3 horas. O REDE.md da casa lista as máquinas com batida nos últimos 14 dias; as paradas há mais tempo ficam no rodapé e no ork network status. A rede foi publicada na versão 0.5.3.
ork network entrar --maquina pc-casa
ork network status
ork network publicar
ork network sairO roadmap da rede, de qualquer diretório
ork network roadmap junta o status report do roadmap, as reservas e as threads de cada máquina, com a fonte e a hora de cada parte. Roda de qualquer diretório, inclusive fora de um clone. O roadmap vem da base remota, igual para toda máquina; esta máquina entra pelo estado local, e as outras pelo retrato publicado.
Sem clone, a leitura usa a CLI da forja já autenticada, gh ou glab, só com consulta; nenhum token sai dela. O que não foi lido sai como lacuna, com o tipo e o que fazer: máquina sem batida há mais de 3 h, forja sem login, sem rede. A resposta nunca diz vazio por não ter lido.
A rede da pessoa também entra no panorama, na seção Rede por pessoa: a casa e cada máquina, com a batida e os projetos que declara. Um projeto que só uma máquina da rede declara pode ser pedido pelo nome, sem clone nem registro nesta, e a máquina da rede que não publicou na fábrica do projeto aparece com as threads não lidas (lacuna maquina.sem-fabrica), nunca com zero ativas. ORK_REDE_LER=0 desliga essa leitura.
ork network roadmap
ork network roadmap --projeto github:orkastery/orkastery
ork network roadmap --projeto meu-produto --json