Cookwala

Esta página foi traduzida por máquina e ainda não foi revisada por uma pessoa. O inglês é a referência; correções são bem-vindas no GitHub. GitHub

Cookwala / For

Para fabricantes de aparelhos: fornos, cooktops, multicozinhas, robôs de cozinha e humanoides

Um aparelho que implementa Cookwala lê uma receita assinada, verifica cada passo contra o que sabe fazer e medir, recusa o que não pode verificar antes que algo aqueça, e mantém seus próprios limites de segurança digam o que disserem a receita, o agente ou a rede. Cinco endpoints, um documento de capacidades, testes públicos.

Por que isso é importante para você

A parte difícil já é sua: movimento, controle de calor, sensores. Cookwala dá a camada de tarefa acima disso, aberta e livre de royalties: um formato de receita que uma máquina pode planejar, envelopes de operação com faixas físicas, uma escada de sensores por passo, limites de segurança locais que nada pode elevar, e uma recusa que é uma resposta normal, não um erro. Seus clientes recebem todas as cozinhas sem que você escreva uma receita; seu regulador recebe uma história de segurança legível; sua equipe comercial recebe um relatório de conformidade assinado em vez de uma afirmação.

O que existe hoje: a API Core 0.2, um executor de referência para rodar ao lado do seu, 51 vetores de conformidade Core incluindo dry runs do executor, um formato de relatório assinado e um verificador. O que não existe: um certificador, um teste de hardware, uma segunda implementação. Você seria o primeiro, e o padrão mudaria onde você mostrar que está errado.

Caminhos de entrada, do leve ao profundo

  1. Leve. Escreva um documento de capacidades para um produto e faça um dry run das nove receitas de exemplo no navegador ou na CLI; leia as seções 3 e 6 do Core 0.2 numa noite.
  2. Médio. Implemente os cinco endpoints Core num hub ao lado do seu firmware, rode as suítes do executor, inicie o hub de referência com um token e compare as respostas no fio.
  3. Profundo. Aplique o pacote de limites de segurança no aparelho, meça a parada local, publique um relatório de conformidade assinado, abra um pull request que o registre e diga-nos o que mudar no Core 0.3.

Primeiro sucesso, em menos de 15 minutos

Menos de 15 minutos, sem hardware: rode as suítes do executor e depois faça um dry run de uma receita contra o seu próprio documento de capacidades.

git clone https://github.com/amado2k5/cookwala && cd cookwala && pip install -e sdk/python
python tools/run_conformance.py envelope   # 14 vectors: bands, altitude, sensor ladders
python tools/run_conformance.py dryrun     # 7 vectors: refusal before heat
cp examples/capabilities/robot-arm.json my-device.json   # edit ops, sensors, safety
cookwala dryrun examples/koshari.cookwala.json --device my-device.json --human-present
conformance: 14/14 passed · conformance: 7/7 passed · accepted or refused with the step and the reason

O caminho depois disso

  1. Escrever o documento de capacidades: operações, sensores com precisão, segurança (certificações, detecção de presença, parada)
  2. Fazer um dry run das receitas de exemplo; cada recusa nomeia o passo e o motivo
  3. Implementar POST /v1/executions, GET status, stop, resume e o log, mais GET /v1/capabilities e /v1/safety-limits
  4. Rodar as suítes do executor (envelope, dryrun, transitions) e as verificações de fio do README do hub
  5. Publicar um relatório de conformidade assinado; até existir um serviço de registro, um pull request o adiciona ao arquivo do registro
  6. Nada está certificado ainda: não existe certificador, e o relatório diz o que prova e o que não prova

Outros caminhos