premanmcp 0.15.0 → 0.15.1

package/bin/connect/guide.js

@@ -149,7 +149,13 @@ export async function discoverEndpoints(
   args,
   agent,
   serverName,
-  { blockedHere = "", force = false, basePath = ".", frameworkHint = undefined } = {}
+  {
+    blockedHere = "",
+    force = false,
+    basePath = ".",
+    frameworkHint = undefined,
+    handOffBrief = true,
+  } = {}
 ) {
   try {
     const before = await endpointCounts(args);
@@ -183,6 +189,20 @@ export async function discoverEndpoints(
       // Say why before printing homework: "here is a brief" reads as PreMan not
       // working, when the actual answer is one login away.
       if (blocker) process.stdout.write(`${MARK.skip()} ${blocker}\n`);
+      // The brief is written for an agent to execute, not for a person to read.
+      // Twenty lines of it in the middle of a setup walk reads as PreMan having
+      // failed, and the walk still has questions to ask after this. `endpoints
+      // discover` prints the same brief whenever it is actually wanted, so the
+      // pointer loses nothing but the wall of text.
+      if (!handOffBrief) {
+        if (!blocker) {
+          process.stdout.write(`${MARK.skip()} no coding agent here to read this repo\n`);
+        }
+        process.stdout.write(
+          `   Map it from inside one: ${cliInvocation()} endpoints discover\n`
+        );
+        return before;
+      }
       for (const line of brief.instructions || []) process.stdout.write(`${line}\n`);
       const who = agent ? agent.label : "your coding agent";
       process.stdout.write(`\nHand this brief to ${who}, then run:\n${manualSteps()}`);

package/bin/integrations.js

@@ -16,7 +16,9 @@
 
 import { describeCheckout, explainNoCheckout, resolveCheckout } from "./repo.js";
 import {
+  DEFAULT_BACKEND,
   assertOk,
+  backendUrl,
   callBackendJson,
   cliInvocation,
   frontendUrl,
@@ -86,10 +88,14 @@ function showOpeningDesktop() {
   };
 }
 
+const INSTALLATIONS_URL = "https://github.com/settings/installations";
+
 function present(url, what) {
   process.stdout.write(`\n  ${url}\n\n`);
-  if (openUrl(url)) process.stdout.write(`Opened ${what} in your browser.\n`);
-  else process.stdout.write(`Open the link above to ${what}.\n`);
+  // A tab appearing is its own confirmation; saying so as well spends a line
+  // on what the customer is already looking at. It earns its place only when
+  // no tab opened and the link is the way through.
+  if (!openUrl(url)) process.stdout.write(`Open the link above to ${what}.\n`);
 }
 
 /**
@@ -293,9 +299,7 @@ export async function githubCommand(args) {
     {
       timeoutMs: Number(process.env.PREMAN_GITHUB_POLL_MS) || GITHUB_POLL_TIMEOUT_MS,
       hintAfterMs: 20000,
-      hint:
-        "Still nothing from GitHub. Picking at least one repository and confirming\n" +
-        "is what sends you back here.",
+      hint: "Still nothing from GitHub — confirm a repository to come back here.",
     }
   );
 
@@ -319,15 +323,12 @@ function githubHandOff(args, refresh) {
   if (installed) {
     return (
       `The App is installed, but no repositories are shared with it.\n` +
-      `  - Add some: https://github.com/settings/installations\n` +
-      `  - Then re-run '${cliInvocation()} github'.\n`
+      `  Add some at ${INSTALLATIONS_URL}, then re-run '${cliInvocation()} github'.\n`
     );
   }
   return (
-    `Nothing from GitHub yet — no need to wait here.\n` +
-    `  - Finish the install in the browser; it records itself when you confirm.\n` +
-    `  - Check it: ${frontendUrl(args)}  or  https://github.com/settings/installations\n` +
-    `  - Then re-run '${cliInvocation()} github'.\n`
+    `Nothing from GitHub yet. Finish the install in the browser — it records itself.\n` +
+    `  Then re-run '${cliInvocation()} github'.\n`
   );
 }
 
@@ -422,6 +423,17 @@ export async function onboardCommand(
 
   process.stdout.write("PreMan setup\n\n");
 
+  // Which PreMan this is talking to is invisible until the very last line,
+  // and a stored login from a local run silently redirects the whole walk:
+  // the account is created in a database nobody else can see, and the GitHub
+  // App redirects to the real callback, so the install never arrives and the
+  // wait looks like GitHub being slow. Production says nothing, because there
+  // is nothing to warn about; anything else is worth one line up front.
+  const target = backendUrl(args);
+  if (target !== DEFAULT_BACKEND) {
+    process.stdout.write(`${MARK.skip()} Using ${target}, not ${DEFAULT_BACKEND}.\n\n`);
+  }
+
   const creds = await authenticateTerminal(args);
   connected(`Signed in as ${creds.user_email || "your account"}.`);
 
@@ -449,7 +461,9 @@ export async function onboardCommand(
           agent: args.value("--agent", ""),
           interactive: false,
         });
-        const counts = await discoverEndpoints(args, agent, args.value("--name", "preman"));
+        const counts = await discoverEndpoints(args, agent, args.value("--name", "preman"), {
+          handOffBrief: false,
+        });
         return { state: counts.registered ? "done" : "skipped", counts };
       },
     },
@@ -483,9 +497,7 @@ export async function onboardCommand(
           return;
         }
         process.stdout.write(
-          `${checkout.slug} is still not shared with PreMan.\n` +
-            `  Add it at https://github.com/settings/installations, then re-run ` +
-            `'${cliInvocation()} github'.\n`
+          `${checkout.slug} is still not shared. Add it at ${INSTALLATIONS_URL}.\n`
         );
       },
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "premanmcp",
-  "version": "0.15.0",
+  "version": "0.15.1",
   "description": "Turn APIs into agent-callable MCP tools with auth, testing, and audit logs",
   "type": "module",
   "bin": {