@augurworks/augur 0.15.4 → 0.15.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@augurworks/augur",
-  "version": "0.15.4",
+  "version": "0.15.5",
   "files": [
     "scripts/",
     "build.js",

package/scripts/connect.mjs

@@ -112,8 +112,15 @@ if (NO_WAIT) {
   process.exit(0);
 }
 console.log(`  ${C.dim}You can stop waiting (Ctrl-C) and run \`augur connect\` again after they approve —`);
-console.log(`  it collects the token for this same code. Talking to your person through messages`);
-console.log(`  rather than a terminal? Use \`augur connect --no-wait\`.${C.off}`);
+console.log(`  it collects the token for this same code.${C.off}`);
+console.log("");
+// Addressed to an agent, in the second person, because the polite version above was
+// read and ignored: an agent whose person only sees its messages once it finishes its
+// turn kept polling here for the code's whole life, twice, and nobody ever saw the code.
+console.log(`  ${C.warn}AGENTS: if your person reads your messages only after you finish, do not wait here.`);
+console.log(`  Stop now, send them the first line above, and run \`augur connect\` again once they say`);
+console.log(`  they have approved — it collects the token then. (\`augur connect --no-wait\` does`);
+console.log(`  exactly that in one step.)${C.off}`);
 console.log("");
 
 const deadline = Date.now() + (expiresInMs || 300000);

package/src/_worker.js

@@ -9133,9 +9133,12 @@ function doorText(f) {
       + `  ${f.connect}\n\n`
       + `It prints a link and a code. The owner of this workspace opens the link in a\n`
       + `browser they are already signed in to and enters the code. The token lands on\n`
-      + `that machine, and every verb below uses it from then on. Talking to that person\n`
-      + `through messages rather than a terminal? Add --no-wait: it prints the line and\n`
-      + `exits; run the same command again after they approve and the token is collected.\n`
+      + `that machine, and every verb below uses it from then on.\n\n`
+      + `AGENTS: if your person reads your messages only after you finish your turn, run\n`
+      + `it with --no-wait. It prints the line and exits; send them that line, end your\n`
+      + `turn, and run the same command again once they say they approved — the token is\n`
+      + `collected then, for that same code. Do not poll for the approval in one turn:\n`
+      + `the code lives five minutes and nobody sees it until you stop.\n\n`
       + `With no\n`
       + `source tree yet, \`npx @augurworks/augur clone --space ${f.workspace}\` then fetches one (it reads\n`
       + `the origin from the pairing).\n\n`