@patchgg/cli 0.3.0 → 0.3.1

package/dist/cli.js

@@ -187,7 +187,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.3.0" : JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
+    VERSION = true ? "0.3.1" : JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
   }
 });
 
@@ -229,7 +229,7 @@ ${BLOCK_WORDS} Its credit goes in your recipe's \`credits\`. If nothing fits, ma
 ## 2. Start
 
 \`\`\`sh
-${pch} login
+${pch} login                               # agents: run it yourself, in the background, and pass on its link
 ${pch} agent install                       # gives your coding agent Patch's tools
 ${pch} new <you>/<game> --licence MIT      # a repo with a patch.json, open unless you add --visibility private
 ${pch} init                                # or this, in a folder you already have
@@ -253,7 +253,7 @@ That's the whole flow: it uploads, tests a browser game, a mod Patch installs or
 ${pch} publish <you>/<game>@<version> --review pass --summary "<what you saw>" --moment "1 00:04 <what you saw>" --moment "1 00:30 <what you saw>"
 \`\`\`
 
-That sends it to Patch's review and follows it until it's live. Running \`${pch} publish\` is your yes, so run it once the person wants it out (\`${pch} test start\` tries a build without publishing it). A passed test shows it starts and runs, not that it plays well, so play it yourself before its first public release.
+That sends it to Patch's review and follows it until it's live. Run it yourself, wherever you run: in WSL, on Linux or a Mac, or on a server, the person's Patch Desktop takes the test through Patch, and pch says if they need to open it or press Start. Running \`${pch} publish\` is your yes, so run it once the person wants it out (\`${pch} test start\` tries a build without publishing it). A passed test shows it starts and runs, not that it plays well, so play it yourself before its first public release.
 
 ## 4. Its listing
 
@@ -35771,6 +35771,13 @@ if ((!process.stdout.isTTY || process.env.TERM === "dumb") && !process.env.FORCE
   process.env.NO_COLOR = "1";
 }
 
+// src/closed-pipes.ts
+for (const stream of [process.stdout, process.stderr]) {
+  stream.on("error", (error62) => {
+    if (error62.code !== "EPIPE") throw error62;
+  });
+}
+
 // node_modules/.pnpm/commander@15.0.0/node_modules/commander/lib/error.js
 var CommanderError = class extends Error {
   /**
@@ -40331,7 +40338,8 @@ async function login(ctx, options) {
       scopes: key.scopes,
       git,
       git_identity: gitIdentity,
-      look_first: LOOK_FIRST
+      look_first: LOOK_FIRST,
+      next: `${pchOn(target.env)} agent install`
     },
     () => {
       if (people) {
@@ -40353,9 +40361,7 @@ async function login(ctx, options) {
       if (git.helper) out.line(`Git is signed in too: Patch repos at ${git.url} just work.`);
       if (gitIdentity) out.line(gitIdentity);
       out.line(LOOK_FIRST);
-      out.line(
-        "pch agent install gives your coding agent Patch's tools, and pch guide says how to publish."
-      );
+      out.line(agentNext(pchOn(target.env)));
     }
   );
 }
@@ -40393,6 +40399,7 @@ async function loginWithKey(ctx) {
     }
   );
 }
+var agentNext = (pch) => `Next: run ${pch} agent install now, which gives you Patch's MCP tools, one-step publish among them, then ask the person to restart you to load them. ${pch} guide says how to make and publish a game.`;
 var SHORT_IDENTITY = "Git doesn't know who you are on this PC yet: pch new and pch clone set that up for each repo.";
 function signedIn(ctx, headline, { git, notes }) {
   const { out, target } = ctx;
@@ -40457,14 +40464,14 @@ ${drawn.map((line) => `  ${line}`).join("\n")}
       block.write(`  Opening ${page} in your browser: check the code matches, then approve.`);
       block.write(import_picocolors3.default.dim(`  Didn't open? Go to ${device.verification_uri} and enter the code.`));
     } else {
-      block.write(`  Go to ${import_picocolors3.default.bold(device.verification_uri)} and enter the code.`);
+      block.write(`  Go to ${import_picocolors3.default.bold(device.verification_uri_complete)} and approve the code.`);
     }
     block.write();
   } else {
     process.stderr.write(
       `This waits for a person to approve it in a browser, which can take a few minutes. The code only works while this keeps running, so don't put a short timeout on it.
 
-To sign in, open ${import_picocolors3.default.bold(device.verification_uri)} and enter ${import_picocolors3.default.bold(code)}
+To sign in, the person opens this link, which has the code in it, checks the code is ${import_picocolors3.default.bold(code)} and approves it: ${import_picocolors3.default.bold(device.verification_uri_complete)}
 
 `
     );
@@ -41694,7 +41701,12 @@ var recipeSchema = external_exports.object({
   ).max(4).default([]).describe("Config files and the values to set in them."),
   test: external_exports.object({
     args: external_exports.array(shortLine(400)).max(16).optional(),
-    checks: external_exports.array(external_exports.string().regex(checkName, "must be lowercase letters, digits and dashes")).max(12).optional().describe(
+    checks: external_exports.array(
+      external_exports.string().regex(
+        checkName,
+        "must be lowercase letters, digits and dashes, such as player-moves"
+      )
+    ).max(12).optional().describe(
       `Checks the release reports itself while it's tested: a browser game opened with ?patch-test=1 logs "pass <name>" or "fail <name>: why".`
     ),
     minutes: external_exports.number().int().min(1).max(15).optional(),
@@ -43049,13 +43061,15 @@ function mcpServer({ target }, options = {}, found = {}) {
   ];
   const name = target.env === "production" ? "patch" : `patch-${target.env}`;
   const platform = found.platform ?? process.platform;
-  if (found.hasPch ?? onPath("pch")) {
-    return platform === "win32" ? { name, command: "cmd", args: ["/c", "pch", ...flags] } : { name, command: "pch", args: flags };
+  if (found.executable ?? isExecutable) return { name, command: process.execPath, args: flags };
+  const pch = found.pchPath === void 0 ? whereOnPath("pch") : found.pchPath;
+  if (pch) {
+    return platform === "win32" ? { name, command: "cmd", args: ["/c", "pch", ...flags] } : { name, command: pch, args: flags };
   }
   return {
     name,
     command: process.execPath,
-    args: isExecutable ? flags : [...process.execArgv, resolve5(process.argv[1]), ...flags]
+    args: [...process.execArgv, resolve5(process.argv[1]), ...flags]
   };
 }
 function commandLine(server) {
@@ -43084,8 +43098,18 @@ function codexHas(server) {
   return { status: listed.stdout?.includes(server.name) ? 0 : 1 };
 }
 function onPath(bin) {
+  return whereOnPath(bin) !== null;
+}
+function whereOnPath(bin) {
   const names = process.platform === "win32" ? [`${bin}.cmd`, `${bin}.exe`, `${bin}.bat`, bin] : [bin];
-  return (process.env.PATH ?? "").split(delimiter).some((folder) => folder && names.some((name) => existsSync2(join6(folder, name))));
+  for (const folder of (process.env.PATH ?? "").split(delimiter)) {
+    if (!folder) continue;
+    for (const name of names) {
+      const path2 = resolve5(folder, name);
+      if (existsSync2(path2)) return path2;
+    }
+  }
+  return null;
 }
 function run(bin, args2) {
   const shell = process.platform === "win32";
@@ -48736,6 +48760,7 @@ async function followRelease(ctx, ref, options = {}) {
     ...review ? { review } : {},
     ...options.testAgain ? { test_again: true } : {}
   };
+  const people = forAPerson(out.json, runningIn());
   let said2 = "";
   let asked = "";
   let step;
@@ -48754,7 +48779,9 @@ async function followRelease(ctx, ref, options = {}) {
     said2 = line;
     if (step.needs_person && step.needs_person.ask !== asked) {
       asked = step.needs_person.ask;
-      out.step(step.needs_person.ask);
+      out.step(
+        people ? step.needs_person.ask : `${step.needs_person.why} Ask the person: "${step.needs_person.ask}" This carries on by itself once they have, so keep it running, or run it again.`
+      );
     }
     if (stops || Date.now() >= deadline) break;
     if (step.needs_person) await sleep10(PERSON_EVERY_MS);
@@ -49652,7 +49679,7 @@ function topLevel(command) {
 }
 var collect = (value, previous = []) => [...previous, value];
 program2.command("login").description(
-  "Sign in through the browser (device code), and sign git in with it. It waits for a person, which can take a few minutes, so don't run it under a short timeout"
+  "Sign in through the browser (device code), and sign git in with it. It waits for a person, which can take a few minutes, so don't run it under a short timeout. Agents: run it yourself, in the background, and give the person the link it prints, which has the code in it"
 ).option("--scope <scope>", "API key scope: read, publish, admin (repeatable)", collect).option("--no-browser", "print the link instead of opening a browser").action(action((ctx, options) => login(ctx, options)));
 program2.command("logout").description("Revoke and forget the active login, and sign git out").action(action((ctx) => logout(ctx)));
 program2.command("whoami").description("Who you're signed in as, and where").action(action((ctx) => whoami(ctx)));
@@ -49864,7 +49891,7 @@ program2.command("check [dir]").description(
   )
 );
 program2.command("publish [target]").description(
-  "Publish from upload to live: uploads what Patch doesn't have, tests it on your PC, saves the footage for your review, then follows Patch's review until it's live. Running it is your yes. Give owner/slug@version instead of a folder to carry a release on, with --review once you've looked at its footage"
+  "Publish from upload to live: uploads what Patch doesn't have, tests it on your PC, saves the footage for your review, then follows Patch's review until it's live. Running it is your yes. Give owner/slug@version instead of a folder to carry a release on, with --review once you've looked at its footage. Agents: run it yourself, wherever you run (WSL, Linux, a Mac or a server). The person's Patch Desktop takes the test through Patch, and pch says if they need to open it or press Start"
 ).addOption(
   new Option("--channel <channel>", `overrides patch.json. ${NOT_LOCKED_HELP}`).choices([
     "private",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@patchgg/cli",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "pch: the Patch command-line tool for creators and their agents",
   "license": "MIT",
   "homepage": "https://patch.gg",