komplian 0.6.0 → 0.6.1

package/README.md

@@ -6,26 +6,22 @@
 2. Browser login: `gh auth login -h github.com -s repo -s read:org -w`
 3. `npx komplian onboard --yes` (sin `@versión`: usa `latest` del registry público).
 
-**Orden típico del equipo:** onboard → `postman login` / `postman --yes` → `mcp-tools --yes` → **`db:all:dev`** → `localhost --yes`. Ver **`ONBOARDING.md`**.
+**Orden típico del equipo:** onboard → **`postman --yes`** (pide la clave la primera vez en TTY) → `mcp-tools --yes` → **`db:all:dev`** → `localhost --yes`. Ver **`ONBOARDING.md`**.
 
-**`npm ERR! ETARGET` / “No matching version”** (también si falló **`postman`**, no solo `onboard`): es el mismo paquete npm. Usa **`npx komplian postman login`** / **`npx komplian postman --yes`** **sin** `@0.4.x`; comprueba `npm config get registry` → `https://registry.npmjs.org/`; `npm cache clean --force`. Detalle: `ONBOARDING.md` en el monorepo.
+**`npm ERR! ETARGET` / “No matching version”** (también si falló **`postman`**, no solo `onboard`): es el mismo paquete npm. Usa **`npx komplian postman --yes`** **sin** `@0.4.x`; comprueba `npm config get registry` → `https://registry.npmjs.org/`; `npm cache clean --force`. Detalle: `ONBOARDING.md` en el monorepo.
 
 ### Postman (colección + entornos)
 
 1. En [Postman](https://postman.com) usa una cuenta con email **`@komplian.com`** (o añade ese email a tu perfil).
 2. Crea una **API key**: Settings → **API keys** → Generate.
-3. **Una vez por máquina** (guarda la clave en `~/.komplian/postman-api-key`; no hace falta `export` después):
-
-```bash
-npx komplian postman login
-```
-
-4. Cuando quieras sincronizar la colección:
+3. **Sincronizar** (la primera vez en terminal interactiva **te pide** la API key y la guarda en `~/.komplian/postman-api-key`; no hace falta `export` después):
 
 ```bash
 npx komplian postman --yes
 ```
 
+Opcional: **`npx komplian postman login`** solo para guardar o rotar la clave sin ejecutar el sync.
+
 Opcional: `export POSTMAN_API_KEY=…` solo para la sesión actual (tiene prioridad sobre el archivo).
 
 El comando llama a `GET https://api.getpostman.com/me` y **solo continúa** si el email de la cuenta es `@komplian.com`. **Si ya existen** la colección **Komplian API** y los entornos con el mismo nombre en ese workspace, se **actualizan**; si no, se crean.

package/komplian-postman.mjs

@@ -2,9 +2,10 @@
 /**
  * Komplian Postman — API key + email @komplian.com (Postman /me), luego colección + entornos.
  *
- * Requisitos: Node 18+. Primera vez: npx komplian postman login
+ * Requisitos: Node 18+. Primera vez: ejecuta `npx komplian postman --yes` (o `postman` sin clave):
+ * en terminal interactiva te pide la API key una vez y la guarda; o `npx komplian postman login`.
  *
- * Clave: POSTMAN_API_KEY o ~/.komplian/postman-api-key (npx komplian postman login)
+ * Clave: POSTMAN_API_KEY, ~/.komplian/postman-api-key, o prompt la primera vez (TTY).
  * Seguridad: no registrar secretos; errores API redactados; login sin eco (TTY); ~/.komplian 700 + key 600.
  * Opcional: POSTMAN_WORKSPACE_ID, KOMPLIAN_EMAIL_DOMAIN, KOMPLIAN_POSTMAN_KEY_FILE, KOMPLIAN_DEBUG
  */
@@ -229,17 +230,72 @@ function resolveApiKey() {
 function printMissingKeyHelp() {
   log(`${c.red}✗${c.reset} No hay API key de Postman.`);
   log(``);
-  log(`  ${c.bold}Una vez por máquina:${c.reset}`);
-  log(`    ${c.cyan}npx komplian postman login${c.reset}`);
-  log(`    (pega la clave de Postman → Settings → API keys → Generate)`);
+  log(`  ${c.bold}Terminal interactiva (primera vez):${c.reset}`);
+  log(
+    `    ${c.cyan}npx komplian postman --yes${c.reset}  (pide la clave y sigue con el sync)`
+  );
+  log(
+    `    ${c.cyan}npx komplian postman login${c.reset}  (solo guardar clave; luego postman --yes)`
+  );
   log(``);
-  log(`  ${c.dim}O en la sesión actual: export POSTMAN_API_KEY=…${c.reset}`);
+  log(`  ${c.bold}Sin TTY (CI, pipes):${c.reset}`);
+  log(`  ${c.dim}export POSTMAN_API_KEY=…${c.reset}`);
   log(
-    `${c.dim}  Archivo manual: ${formatHomePath(defaultKeyPath())}${c.reset}`
+    `${c.dim}  Archivo: ${formatHomePath(defaultKeyPath())} (permiso 600)${c.reset}`
   );
   process.exit(1);
 }
 
+/**
+ * POSTMAN_API_KEY o ~/.komplian/postman-api-key. Si falta y hay TTY, pide la clave
+ * (misma validación que `postman login`), guarda y devuelve la resolución.
+ */
+async function resolveApiKeyWithOptionalInteractiveSetup(domain) {
+  let r = resolveApiKey();
+  if (r.key) return r;
+  if (!input.isTTY) {
+    printMissingKeyHelp();
+  }
+
+  log(`${c.cyan}━━ Primera vez: Postman API key ━━${c.reset}`);
+  log(
+    `${c.dim}Cuenta @${domain}. Postman → Settings → API keys → Generate. Se guarda en ${formatHomePath(defaultKeyPath())}.${c.reset}`
+  );
+  log("");
+
+  const raw = await readPasswordLine(
+    "Postman API key (no se muestra al escribir; Settings → API keys): "
+  );
+  const k = (raw || "").trim();
+  if (!k) {
+    log(`${c.red}✗${c.reset} Clave vacía.`);
+    process.exit(1);
+  }
+
+  await verifyKomplianEmail(k, domain, { quietSuccess: true });
+
+  const keyPath = defaultKeyPath();
+  ensureSecureKomplianDir();
+  writeFileSync(keyPath, `${k}\n`, { encoding: "utf8", mode: 0o600 });
+  try {
+    chmodSync(keyPath, 0o600);
+  } catch {
+    /* Windows u otros */
+  }
+
+  log("");
+  log(
+    `${c.green}✓${c.reset} Guardada en ${c.bold}${formatHomePath(keyPath)}${c.reset} — continuando…`
+  );
+
+  r = resolveApiKey();
+  if (!r.key) {
+    log(`${c.red}✗${c.reset} No se pudo leer la clave guardada.`);
+    process.exit(1);
+  }
+  return r;
+}
+
 /** Parseo mínimo .env (sin dependencia dotenv). */
 function parseEnvFile(text) {
   const out = {};
@@ -600,7 +656,8 @@ async function pickWorkspaceId(apiKey, explicit) {
   return w.id;
 }
 
-async function verifyKomplianEmail(apiKey, domain) {
+async function verifyKomplianEmail(apiKey, domain, opts = {}) {
+  const quietOk = opts.quietSuccess === true;
   const { ok, status, body } = await pmFetch(apiKey, "/me");
   if (!ok) {
     log(
@@ -624,9 +681,11 @@ async function verifyKomplianEmail(apiKey, domain) {
     );
     process.exit(1);
   }
-  log(
-    `${c.green}✓${c.reset} Postman: ${c.bold}${maskEmail(email)}${c.reset} (${c.dim}dominio permitido${c.reset})`
-  );
+  if (!quietOk) {
+    log(
+      `${c.green}✓${c.reset} Postman: ${c.bold}${maskEmail(email)}${c.reset} (${c.dim}dominio permitido${c.reset})`
+    );
+  }
   return email;
 }
 
@@ -759,7 +818,7 @@ function usage() {
   log(`  Clave: ${c.dim}POSTMAN_API_KEY${c.reset} o archivo ${c.dim}~/.komplian/postman-api-key${c.reset} (véase ${c.cyan}postman login${c.reset})`);
   log(`  Dominio email: solo @komplian.com (GET /me)`);
   log(``);
-  log(`  -y, --yes           Sin prompts extra`);
+  log(`  -y, --yes           Sin prompts extra (si falta API key y hay TTY, pide la clave una vez y guarda)`);
   log(`  --export-only       Solo escribe JSON en disco (no llama a la API de Postman)`);
   log(`  --out <dir>         Carpeta para export (por defecto: ./komplian-postman)`);
   log(`  --dotenv <ruta>     .env extra (además de api/.env, .env, KOMPLIAN_DOTENV)`);
@@ -771,8 +830,8 @@ function usage() {
 
 function usageLogin() {
   log(`Uso: komplian postman login`);
-  log(`  Guarda la API key de Postman en ${c.dim}~/.komplian/postman-api-key${c.reset} (permiso 600).`);
-  log(`  Tras esto: ${c.cyan}npx komplian postman --yes${c.reset} sin exportar variables.`);
+  log(`  Guarda o sustituye la API key en ${c.dim}~/.komplian/postman-api-key${c.reset} (permiso 600).`);
+  log(`  Opcional: ${c.cyan}npx komplian postman --yes${c.reset} ya pide la clave la primera vez si falta.`);
   log(``);
   log(`  Postman → Settings (avatar) → API keys → Generate`);
 }
@@ -841,15 +900,13 @@ export async function runPostman(argv) {
     return;
   }
 
-  const { key: apiKey, source } = resolveApiKey();
-  if (!apiKey) {
-    printMissingKeyHelp();
-  }
+  const domain = (process.env.KOMPLIAN_EMAIL_DOMAIN || "komplian.com").trim();
+  const { key: apiKey, source } =
+    await resolveApiKeyWithOptionalInteractiveSetup(domain);
   if (source && source !== "POSTMAN_API_KEY") {
     log(`${c.dim}→ API key Postman desde: ${formatHomePath(source)}${c.reset}`);
   }
 
-  const domain = (process.env.KOMPLIAN_EMAIL_DOMAIN || "komplian.com").trim();
   await verifyKomplianEmail(apiKey, domain);
 
   const collection = buildCollection();
@@ -940,16 +997,12 @@ export async function runPostman(argv) {
 }
 
 /**
- * Misma verificación que `postman --yes`: GET /me y dominio @komplian.com.
- * Requiere `npx komplian postman login` (o POSTMAN_API_KEY en la sesión).
+ * GET /me y dominio @komplian.com. Si no hay clave y hay TTY, pide guardarla (como `postman --yes`).
  */
 export async function assertKomplianEmployeePostman() {
   const domain = (process.env.KOMPLIAN_EMAIL_DOMAIN || "komplian.com").trim();
-  const { key, source } = resolveApiKey();
-  if (!key) {
-    printMissingKeyHelp();
-    process.exit(1);
-  }
+  const { key, source } =
+    await resolveApiKeyWithOptionalInteractiveSetup(domain);
   if (source && source !== "POSTMAN_API_KEY") {
     log(`${c.dim}→ Postman API key desde: ${formatHomePath(source)}${c.reset}`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "komplian",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Komplian CLI: onboard, Postman, localhost, mcp-tools, db (psql). Node 18+. Published tarball has no .env / secrets.",
   "type": "module",
   "engines": {