@h1veframework/cli 0.2.0 → 0.3.0

package/README.md

@@ -25,9 +25,14 @@ nf --version
 ```bash
 export H1VE_API_URL="https://app.h1ve.org"
 export H1VE_API_KEY="nf_pat_..."      # seu PAT
+export H1VE_PROJECT_ID="..."          # OBRIGATÓRIO só se você tem 2+ projetos (o id do projeto)
 nf health                              # testa a conexão
 ```
 
+> **`H1VE_PROJECT_ID`** (SPEC-076): com **um** projeto, não precisa — o servidor resolve sozinho.
+> Com **2+ projetos** (plano pago), defina o id do projeto — senão o `nf start`/`nf health` responde
+> *"Você tem mais de um projeto. Defina H1VE_PROJECT_ID."* (o id fica na app, no projeto).
+
 > Coloque os `export` no seu `~/.zshrc` / `~/.bashrc` para não repetir a cada sessão.
 > "Nenhum snapshot registrado" no `nf health` é **sucesso** (conectou; projeto sem métricas ainda).
 

package/dist/index.js

@@ -13,7 +13,13 @@ var NexusApiError = class extends Error {
   }
   code;
 };
-function errorForStatus(status2) {
+function errorForStatus(status2, code) {
+  if (code === "NO_PROJECT") {
+    return new NexusApiError(
+      "NO_PROJECT",
+      "Voc\xEA tem mais de um projeto. Defina H1VE_PROJECT_ID (o id do projeto) na config do CLI/MCP."
+    );
+  }
   switch (status2) {
     case 401:
       return new NexusApiError("UNAUTHENTICATED", "H1VE_API_KEY ausente ou inv\xE1lida.");
@@ -68,7 +74,13 @@ function rootUrl(baseUrl) {
 }
 function createClient(config) {
   const doFetch = config.fetchImpl ?? fetch;
-  const authHeaders = { "x-api-key": config.apiKey, accept: "application/json" };
+  const authHeaders = {
+    "x-api-key": config.apiKey,
+    accept: "application/json",
+    // SPEC-076: envia o projeto ativo quando configurado. O servidor valida a membership
+    // do id e ignora o header onde não escopa — então mandar sempre é simples e seguro.
+    ...config.projectId ? { "x-project-id": config.projectId } : {}
+  };
   async function postAction(featureId, action, body) {
     const url = `${rootUrl(config.baseUrl)}/api/features/${encodeURIComponent(featureId)}/${action}`;
     const res = await doFetch(url, {
@@ -83,19 +95,19 @@ function createClient(config) {
     async getContext(branch) {
       const url = `${rootUrl(config.baseUrl)}/api/context?branch=${encodeURIComponent(branch)}`;
       const res = await doFetch(url, { headers: authHeaders });
-      if (!res.ok) throw errorForStatus(res.status);
+      if (!res.ok) throw errorForStatus(res.status, await readErrorCode(res));
       return await res.json();
     },
     async listHealth() {
       const url = `${rootUrl(config.baseUrl)}/api/health`;
       const res = await doFetch(url, { headers: authHeaders });
-      if (!res.ok) throw errorForStatus(res.status);
+      if (!res.ok) throw errorForStatus(res.status, await readErrorCode(res));
       return await res.json();
     },
     async listFeatures() {
       const url = `${rootUrl(config.baseUrl)}/api/features`;
       const res = await doFetch(url, { headers: authHeaders });
-      if (!res.ok) throw errorForStatus(res.status);
+      if (!res.ok) throw errorForStatus(res.status, await readErrorCode(res));
       return await res.json();
     },
     startFeature(featureId, slug) {
@@ -113,7 +125,7 @@ function createClient(config) {
     async listProjects() {
       const url = `${rootUrl(config.baseUrl)}/api/projects`;
       const res = await doFetch(url, { headers: authHeaders });
-      if (!res.ok) throw errorForStatus(res.status);
+      if (!res.ok) throw errorForStatus(res.status, await readErrorCode(res));
       return await res.json();
     },
     async createConnection(projectId, input) {
@@ -260,16 +272,17 @@ var CliError = class extends Error {
 function readConfig(env = process.env) {
   const baseUrl = env.H1VE_API_URL?.trim() || env.NEXUS_FLOW_API_URL?.trim();
   const apiKey = env.H1VE_API_KEY?.trim() || env.NEXUS_FLOW_API_KEY?.trim();
+  const projectId = env.H1VE_PROJECT_ID?.trim() || env.NEXUS_FLOW_PROJECT_ID?.trim();
   if (!baseUrl || !apiKey) {
     throw new CliError(
       "Defina H1VE_API_URL e H1VE_API_KEY no ambiente.\n  export H1VE_API_URL=https://app.h1ve.org\n  export H1VE_API_KEY=nf_pat_...   (crie um token em /api-tokens)\n  (os nomes legados NEXUS_FLOW_API_URL/KEY ainda s\xE3o aceitos)",
       2
     );
   }
-  return { baseUrl, apiKey };
+  return { baseUrl, apiKey, projectId };
 }
 function clientFromConfig(cfg) {
-  return createClient({ baseUrl: cfg.baseUrl, apiKey: cfg.apiKey });
+  return createClient({ baseUrl: cfg.baseUrl, apiKey: cfg.apiKey, projectId: cfg.projectId });
 }
 
 // src/format.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h1veframework/cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "CLI `nf` do H1VE Flow: opera o fluxo da feature (status/move/blocker/spec/done/health/start) da própria branch, via PAT.",
   "license": "MIT",
   "type": "module",