piezas 0.2.0 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "piezas",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Set up Piezas in your project — installs the SDK and configures AI coding agents",
   "type": "module",
   "bin": {

package/src/index.js

@@ -690,7 +690,8 @@ async function waitForEnvKey(projectDir, timeoutSeconds, intervalMs) {
 }
 
 // resolveApiKey implements the key-intake precedence:
-// existing .env key > --key flag > process env > interactive prompt > --wait.
+// existing .env key > --key flag > process env > `piezas login` auto-mint >
+// interactive paste prompt > --wait.
 // Only explicitly provided keys (--key/prompt/wait) may replace an existing
 // .env value; the process env never overrides an already-configured project.
 async function resolveApiKey(envPath, projectDir, options) {
@@ -709,6 +710,15 @@ async function resolveApiKey(envPath, projectDir, options) {
     return { key: processKey, source: 'process-env' };
   }
 
+  // Signed in via `piezas login`? Create the app and mint its key right here,
+  // from the terminal -- no dashboard visit, no copy-paste. This runs BEFORE the
+  // manual paste prompt so a logged-in user is never sent to the web UI to fetch
+  // a key by hand. Declining the offer falls through to the manual paths below.
+  const minted = await resolveKeyViaLogin(projectDir, options);
+  if (minted) {
+    return minted;
+  }
+
   if (options.interactive && !options.yes) {
     const promptFn = options.promptFn ?? promptViaTerminal;
     const answer = String((await promptFn(KEY_PROMPT)) ?? '').trim();
@@ -726,13 +736,6 @@ async function resolveApiKey(envPath, projectDir, options) {
     }
   }
 
-  // Nothing resolved: with a saved `piezas login` session (and a TTY or an
-  // explicit --from-login) create the app + mint a key via the platform.
-  const minted = await resolveKeyViaLogin(projectDir, options);
-  if (minted) {
-    return minted;
-  }
-
   return { key: undefined, source: 'none' };
 }
 
@@ -1055,16 +1058,29 @@ async function resolveKeyViaLogin(projectDir, options) {
   const credentials = readCredentials(env);
   if (!credentials) return undefined;
 
-  const appName = (typeof options.app === 'string' && options.app.trim())
+  const flagApp = (typeof options.app === 'string' && options.app.trim())
     ? options.app.trim()
-    : basename(projectDir);
-
-  if (!options.fromLogin) {
+    : undefined;
+  const defaultName = flagApp || basename(projectDir);
+  let appName = defaultName;
+
+  // Interactive (and not the non-interactive --from-login shortcut, and no
+  // explicit --app): offer an explicit choice -- create a new app now (which
+  // mints its key for you), or paste a key you already made in the dashboard.
+  // Choosing "paste" (2) returns undefined so the caller falls through to the
+  // paste prompt. Choosing "create" (1, the default) asks for the app name and
+  // mints its key here -- no dashboard visit. An explicit --app skips the menu
+  // and creates that app directly.
+  if (!flagApp && !options.fromLogin && options.interactive && !options.yes) {
     const promptFn = options.promptFn ?? promptViaTerminal;
-    const answer = String(
-      (await promptFn(`You are signed in as ${credentials.email}. Create app "${appName}" and mint an API key now? [Y/n] `)) ?? '',
-    ).trim().toLowerCase();
-    if (answer === 'n' || answer === 'no') return undefined;
+    log('');
+    log(`  Signed in as ${credentials.email}. How would you like to get your API key?`);
+    log("    1) Create a new app now - we'll mint its key  (recommended)");
+    log('    2) Paste a key you already created in the dashboard');
+    const choice = String((await promptFn('  Choose 1 or 2 [1]: ')) ?? '').trim();
+    if (choice === '2') return undefined;
+    const answer = String((await promptFn(`  Name for the new app [${defaultName}]: `)) ?? '').trim();
+    appName = answer || defaultName;
   }
 
   const fetchFn = options.fetchFn ?? fetch;
@@ -1120,7 +1136,7 @@ async function resolveKeyViaLogin(projectDir, options) {
       return undefined;
     }
     log(`  Minted a live API key for "${app.name}"`);
-    return { key: minted.data.key, source: 'login' };
+    return { key: minted.data.key, source: 'login', appName: app.name };
   } catch (error) {
     log(`  Could not reach Piezas (${error?.message || 'network error'}) - continuing without a key.`);
     return undefined;
@@ -1282,6 +1298,18 @@ async function runInit(options) {
     }
   }
 
+  // When the app name came from the login prompt (not --app), record it in the
+  // manifest so doctor/agents and the app we just created agree. Cosmetic — the
+  // key is already written — so a write failure here is non-fatal.
+  if (resolved.appName && manifest && manifest.appName !== resolved.appName) {
+    manifest.appName = resolved.appName;
+    try {
+      writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`);
+    } catch {
+      // ignore — manifest metadata is informational
+    }
+  }
+
   log('\n  Done! Your project is set up for Piezas.\n');
   log('  Your AI coding agent now knows how to use Piezas:');
   log('    Claude Code  -> /piezas or reads CLAUDE.md automatically');
@@ -1292,8 +1320,8 @@ async function runInit(options) {
   log('');
   if (apiKeyStatus === 'missing') {
     log('  apiKey: missing');
-    log(`  Put PIEZAS_API_KEY=<your key> in ${envPath} (dashboard -> API Keys -> "Download .env"), or rerun: npx piezas init --key <key>`);
-    log('  No account key handy? Run `npx piezas login`, then `npx piezas init --from-login` to create an app + key from the terminal.');
+    log('  Easiest: run `npx piezas login`, then re-run `npx piezas init` - it creates your app and API key automatically.');
+    log(`  Already have a key? Rerun: npx piezas init --key <key> (or add PIEZAS_API_KEY to ${envPath}).`);
   } else if (apiKeyStatus === 'configured') {
     log(`  apiKey: configured (already in ${envPath})`);
   } else {
@@ -1303,8 +1331,8 @@ async function runInit(options) {
   log('  Next steps:');
   let step = 1;
   if (apiKeyStatus === 'missing') {
-    log(`  ${step++}. Get an API key at https://app.piezas.ai (dashboard -> API Keys)`);
-    log(`  ${step++}. Add PIEZAS_API_KEY=sk_live_xxx to .env (server-side only)`);
+    log(`  ${step++}. Run \`npx piezas login\`, then re-run \`npx piezas init\` to create your app + key`);
+    log(`  ${step++}. (or add an existing PIEZAS_API_KEY=sk_live_xxx to .env, server-side only)`);
   }
   log(`  ${step++}. Run /piezas-spec [idea] or ask for Piezas spec mode`);
   log(`  ${step++}. After the spec is written, tell your AI agent to code from SPEC.md`);
@@ -1799,7 +1827,8 @@ function help() {
   console.log('    --wait                           Watch the folder for a downloaded .env (.env / .env.download / env.txt)');
   console.log('    --wait-timeout <seconds>         How long --wait polls before giving up (default 300)');
   console.log('    --app <name>                     App name recorded in piezas.manifest.json (and used for auto-created apps)');
-  console.log('    --from-login                     When no key is found, create an app + key with your saved login');
+  console.log('    --from-login                     Non-interactive: create an app + key from your saved login (CI/agents;');
+  console.log('                                     interactive `init` already offers this when you are signed in)');
   console.log('    --yes                            Non-interactive: never prompt (for agents/CI)');
   console.log('    --json                           Print a machine-readable JSON summary');
   console.log('    --mode next-bff|static|server-runtime|custom-backend');