@vectorplane/ctrl-cli 0.1.0 → 0.1.1

package/README.md

@@ -1,110 +1,63 @@
 # VectorPlane Ctrl CLI
 
-`vectorplane-ctrl-cli` é o CLI oficial do ecossistema **VectorPlane**, nome comercial do backend `conductor-edge-ia`.
+CLI oficial do VectorPlane.
 
-O repositório analisado posiciona o produto como uma control plane de contexto para engenharia com IA: memória remota por workspace, snapshots consolidados, governança, sessões de agentes, jobs e operação edge. Este CLI segue exatamente essa lógica. Ele não é um utilitário genérico de sync; ele é a porta local para autenticação, coleta de contexto da máquina, análise de workspace e envio seguro de snapshots para o plano de controle.
-
-## Relação com `conductor-edge-ia`
-
-O backend atual define alguns conceitos centrais que este CLI preserva:
-
-- `workspace` como unidade primária de contexto
-- `snapshot` consolidado como envelope principal de estado
-- `agent session` e `clientInstanceId` como base de observabilidade e coordenação
-- `control plane` como camada acima de clientes locais, MCP e REST
-- preocupação explícita com governança, rastreabilidade, serialização consistente e isolamento
-
-O `vp` foi desenhado para se encaixar nesse vocabulário e servir como cliente local premium do VectorPlane.
-
-## Evolução planejada
-
-O roadmap do CLI foi documentado em [`docs/evolution-phases.md`](./docs/evolution-phases.md), alinhado às fases já visíveis no `conductor-edge-ia`:
-
-- `Foundation`
-- `Coordination`
-- `Governed Sync`
-- `Enterprise Control Surface`
+Use o comando `vp` para autenticar, verificar a sessão local e sincronizar o workspace com o produto.
 
 ## Instalação
 
-```bash
-npm install
-npm run build
-npm install -g .
-```
-
-Instalação via npm público:
-
 ```bash
 npm install -g @vectorplane/ctrl-cli
 ```
 
-## Uso local
+## Uso
 
 ```bash
 vp login
 vp status
 vp sync
-vp whoami
-vp doctor
-vp workspace current
 ```
 
 ## Comandos
 
 ### `vp login`
 
-- inicia callback local em `http://127.0.0.1:4217/callback`
-- gera `state` seguro
 - abre o navegador para autenticação
-- troca `code` por tokens via API
-- persiste a sessão em `~/.vectorplane/session.json`
+- conclui o login com callback local seguro
+- salva a sessão localmente
 
 ### `vp sync`
 
-- exige sessão ativa
-- coleta contexto de máquina, runtime, workspace e git
-- gera snapshot estruturado e hash estável
-- faz deduplicação por hash
-- persiste snapshot localmente
-- envia para `POST https://api.vectorplane.io/sync`
-- enfileira localmente quando a API falha
+- coleta contexto local do workspace
+- envia a sincronização para o VectorPlane
+- usa fila local quando a API estiver indisponível
 
 ### `vp status`
 
-- informa estado da sessão local
-- mostra perfil ativo
-- mostra workspace ativo e binding local
-- mostra diretório atual
-- mostra machine ID persistido
-- mostra branch git, fila local, sessão de agente e última sincronização quando disponíveis
+- mostra o estado da sessão local
+- exibe workspace ativo, diretório atual e última sincronização
 
 ### Comandos adicionais já implementados
 
 - `vp whoami`
-  - consulta a identidade atual via API
+  - mostra a identidade autenticada
 - `vp doctor`
-  - verifica diretório local, git, health, ready e autenticação
+  - executa verificações locais e de conectividade
 - `vp config`
-  - lista, cria e troca perfis
-  - lê e altera configurações principais
+  - gerencia perfis e configuração local
 - `vp workspace`
-  - consulta o workspace atual
-  - faz binding manual
-  - tenta resolver por repositório remoto
+  - gerencia o workspace atual
 - `vp session`
-  - faz check-in, heartbeat e check-out de sessão de agente
+  - gerencia sessões de agente
 - `vp context`
-  - carrega `context`, `snapshot` ou `delivery-context`
+  - carrega contexto remoto do workspace
 - `vp bootstrap`
-  - lê `agent-setup` e guidance de bootstrap do workspace
+  - obtém instruções de setup do workspace
 - `vp event send`
-  - envia ou enfileira eventos operacionais
+  - envia eventos operacionais
 
 ## Persistência local
 
-Arquivos usados:
-
 - `~/.vectorplane/config.json`
 - `~/.vectorplane/session.json`
 - `~/.vectorplane/device.json`
@@ -117,51 +70,5 @@ Arquivos usados:
 
 - tokens nunca são impressos no terminal
 - tokens nunca são enviados por query string
-- o callback aceita apenas `code` e `state`
-- `state` é validado obrigatoriamente
-- logs evitam payloads sensíveis e mascaram chaves delicadas
-- remotes git são sanitizados antes de entrarem no snapshot
-
-## Desenvolvimento
-
-```bash
-npm run check
-npm run build
-npm start -- status
-```
-
-## Publicação npm
-
-O pacote foi preparado para publicação pública como `@vectorplane/ctrl-cli`.
-
-Checklist local:
-
-```bash
-npm run release:check
-```
-
-Publicação:
-
-```bash
-npm login
-npm publish --access public
-```
-
-Notas de empacotamento:
-
-- o tarball publica apenas `bin/`, `dist/`, `README.md` e `LICENSE`
-- `src/`, `docs/`, `.git/`, `node_modules/`, `package-lock.json` e arquivos locais não entram no pacote
-- tokens, sessão local e dados de `~/.vectorplane/` não fazem parte do publish
-
-## Integração aplicada
-
-O fluxo web e backend do CLI foi alinhado ao ecossistema real:
-
-- dashboard com rota `/cli/login`
-- emissão autenticada de código por `POST /auth/cli/code`
-- troca de token por `POST /cli/token/exchange`
-- refresh por `POST /cli/token/refresh`
-- resolução e leitura de workspace via rotas `cli/workspace/*`
-- `POST /sync` e `POST /events` no mesmo envelope oficial do worker
-
-O cliente agora faz unwrapping do envelope `{ success, data, requestId }` usado pelo `conductor-edge-ia`, em vez de assumir respostas cruas.
+- o callback valida o `state`
+- a sessão fica no diretório do usuário

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vectorplane/ctrl-cli",
-  "version": "0.1.0",
-  "description": "Official VectorPlane CLI for secure local auth, workspace sync, agent sessions, and control plane operations.",
+  "version": "0.1.1",
+  "description": "Official VectorPlane CLI.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",