@aiuby-ia/cli 0.0.0-stage → 0.3.0

package/README.md

@@ -1,3 +1,90 @@
-# Temporary Holding Version
+# aiuby
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Linha de comando e templates de partida do **AIUBY Compute**.
+
+> **Estado: prévia (0.3.0).** A CLI autentica, copia templates, cadastra aplicações e
+> revisões a partir do `aiuby.toml`, lê o catálogo de hardware e mostra o plano de
+> implantação. **Implantar funciona só em organizações com a prévia do runtime habilitada
+> pela AIUBY**: CPU no Google Cloud, até 1 vCPU e 1 GB, 1 réplica, endereço público e prazo
+> (a aplicação para sozinha). Nas demais, o pedido é recusado com os motivos. Logs, escala,
+> volumes, segredos e GPU ainda não existem.
+
+## Instalação
+
+Precisa de Node.js 20 ou mais novo. O pacote é distribuído pelo site da AIUBY:
+
+```bash
+npm install -g https://aiuby.com/cli/aiuby-cli-latest.tgz
+aiuby --version
+```
+
+Para fixar uma versão, troque `latest` pelo número (por exemplo `aiuby-cli-0.3.0.tgz`).
+Para atualizar, rode o mesmo comando de novo. Para remover: `npm uninstall -g @aiuby-ia/cli`.
+
+## Primeiros passos
+
+1. Adicione o AIUBY Compute à sua organização: na área logada, em **Produtos** (só o dono adiciona; não tem custo).
+2. Na área logada, em **Acesso → Chaves de API**, crie uma chave com os escopos
+   **Ler o Compute** e, para cadastrar pela CLI, **Gerenciar aplicações do Compute**.
+   Ela vale para um workspace, que é o "projeto" da CLI.
+3. Autentique e confira:
+
+```bash
+aiuby login       # cola a chave; ela não aparece na tela
+aiuby whoami
+aiuby apps list
+aiuby capacity list
+```
+
+4. Comece de um template, ajuste o `aiuby.toml` e valide:
+
+```bash
+aiuby init fastapi-http minha-api
+cd minha-api
+aiuby config validate
+```
+
+5. Cadastre a aplicação e veja o plano:
+
+```bash
+aiuby apps create            # cadastra; não implanta
+aiuby apps update            # depois de mudar o aiuby.toml: nova revisão
+aiuby deploy --dry-run minha-api
+aiuby deploy minha-api       # só com a prévia do runtime; pede o escopo "Implantar no Compute"
+aiuby stop minha-api
+```
+
+O cadastro também pode ser feito na tela **Compute → Apps**.
+
+Em automação, defina `AIUBY_TOKEN` no ambiente em vez de usar `login`.
+
+## Documentação
+
+- [Referência da CLI](docs/cli.md)
+- [Referência da API](docs/api.md)
+
+## Templates
+
+| Pasta | O que é |
+| --- | --- |
+| [`templates/fastapi-http`](templates/fastapi-http) | API HTTP em Python com FastAPI, em CPU |
+| [`templates/vllm-openai`](templates/vllm-openai) | Inferência com vLLM e API compatível com OpenAI, em GPU |
+| [`templates/langgraph-agent`](templates/langgraph-agent) | Agente com LangGraph atrás de uma API HTTP, em CPU |
+
+São pontos de partida de código. Ainda não foram executados num runtime da AIUBY.
+
+## Segurança
+
+- A CLI fala só com a API da AIUBY. Nunca pede credenciais da AWS ou do Google Cloud.
+- A chave nunca é aceita como argumento. Fica em `~/.config/aiuby/credentials.json`, com permissão `0600`.
+- A API precisa ser HTTPS (HTTP só em `localhost`).
+
+## Desenvolvimento
+
+```bash
+npm ci
+npm run check     # tipos, testes e build
+```
+
+`src/contracts.ts` espelha o contrato de configuração da API. A validação local é uma
+conveniência: quem decide é a API.

package/THIRD_PARTY_LICENSES.md

@@ -0,0 +1,58 @@
+# Licenças de terceiros
+
+O executável `dist/aiuby.mjs` embute estas bibliotecas.
+
+## zod
+
+```
+MIT License
+
+Copyright (c) 2025 Colin McDonnell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## smol-toml
+
+```
+Copyright (c) Squirrel Chat et al., All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+3. Neither the name of the copyright holder nor the names of its contributors
+   may be used to endorse or promote products derived from this software without
+   specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+```