run402 4.95.0 → 4.97.0

package/lib/path-lookup.mjs

@@ -1,10 +1,8 @@
 /**
  * `path-lookup.mjs` — the tiny, dependency-free "is this executable on
- * PATH" check kygit-handoff design D8 needs twice (`run402 doctor` and
- * `repos view`, both naming `npm i -g @kychee/kygit` when a `kygit::`
- * remote has no `git-remote-kygit` helper installed). No shell, no `which`
- * subprocess — a plain directory scan mirrors what the OS loader itself
- * does to resolve an unqualified command name.
+ * PATH" check behind `repos resume` / `repos join`'s remote-helper next
+ * action. No shell, no `which` subprocess — a plain directory scan mirrors
+ * what the OS loader itself does to resolve an unqualified command name.
  */
 import {accessSync, constants, readFileSync } from "node:fs";
 import { delimiter, join } from "node:path";
@@ -26,8 +24,7 @@ export function isExecutableOnPath(name, env = process.env) {
 /**
  * After a restore into `dir`, the ONE thing that still stands between the
  * caller and its first `git push` is git finding the remote helper the
- * checkout's origin scheme names (`git-remote-kygit` for `kygit::`,
- * `git-remote-run402` for `run402::`). A resume or join run through
+ * checkout's `run402::` origin names (`git-remote-run402`). A resume or join run through
  * `npx` has the helper only inside the npx cache, so git cannot see it.
  * Returns a `next_actions` entry naming the fix, or null when the helper
  * is on PATH or the checkout's remote cannot be read (never throws).
@@ -42,11 +39,11 @@ export function remoteHelperNextAction(dir, env = process.env) {
     return null;
   }
   if (!url) return null;
-  const helper = url.startsWith("kygit::") ? "git-remote-kygit" : url.startsWith("run402::") ? "git-remote-run402" : null;
+  const helper = url.startsWith("run402::") ? "git-remote-run402" : null;
   if (!helper || isExecutableOnPath(helper, env)) return null;
   return {
     type: "install_remote_helper",
-    command: "npm i -g @kychee/kygit run402",
-    why: `git push needs ${helper} on PATH and this session does not have it there (an npx run keeps it inside the npx cache); install both packages once and every git command in this checkout works`,
+    command: "npm i -g run402",
+    why: `git push needs ${helper} on PATH and this session does not have it there (an npx run keeps it inside the npx cache); install run402 once and every git command in this checkout works`,
   };
 }

package/lib/path-lookup.test.mjs

@@ -1,8 +1,6 @@
 /**
- * `path-lookup.mjs` — the PATH-executable probe `doctor.mjs`/`repos.mjs`'s
- * `view()` both use to detect a `kygit::` remote with no `git-remote-kygit`
- * helper installed (kygit-handoff design D8, mirroring
- * `kygit/kygit.mjs`'s own `findRemoteHelper`).
+ * `path-lookup.mjs` — the PATH-executable probe behind `repos resume` /
+ * `repos join`'s remote-helper next action.
  */
 import { describe, it } from "node:test";
 import assert from "node:assert/strict";
@@ -15,10 +13,10 @@ describe("isExecutableOnPath", () => {
   it("finds an executable file on PATH", () => {
     const dir = mkdtempSync(join(tmpdir(), "path-lookup-"));
     try {
-      const bin = join(dir, "git-remote-kygit");
+      const bin = join(dir, "git-remote-run402");
       writeFileSync(bin, "#!/bin/sh\n");
       chmodSync(bin, 0o755);
-      assert.equal(isExecutableOnPath("git-remote-kygit", { PATH: dir }), true);
+      assert.equal(isExecutableOnPath("git-remote-run402", { PATH: dir }), true);
     } finally {
       rmSync(dir, { recursive: true, force: true });
     }
@@ -27,10 +25,10 @@ describe("isExecutableOnPath", () => {
   it("returns false when the name exists but is not executable", () => {
     const dir = mkdtempSync(join(tmpdir(), "path-lookup-"));
     try {
-      const bin = join(dir, "git-remote-kygit");
+      const bin = join(dir, "git-remote-run402");
       writeFileSync(bin, "not executable");
       chmodSync(bin, 0o644);
-      assert.equal(isExecutableOnPath("git-remote-kygit", { PATH: dir }), false);
+      assert.equal(isExecutableOnPath("git-remote-run402", { PATH: dir }), false);
     } finally {
       rmSync(dir, { recursive: true, force: true });
     }
@@ -39,7 +37,7 @@ describe("isExecutableOnPath", () => {
   it("returns false when the name is nowhere on PATH", () => {
     const dir = mkdtempSync(join(tmpdir(), "path-lookup-"));
     try {
-      assert.equal(isExecutableOnPath("git-remote-kygit", { PATH: dir }), false);
+      assert.equal(isExecutableOnPath("git-remote-run402", { PATH: dir }), false);
     } finally {
       rmSync(dir, { recursive: true, force: true });
     }
@@ -49,10 +47,10 @@ describe("isExecutableOnPath", () => {
     const dirA = mkdtempSync(join(tmpdir(), "path-lookup-a-"));
     const dirB = mkdtempSync(join(tmpdir(), "path-lookup-b-"));
     try {
-      const bin = join(dirB, "git-remote-kygit");
+      const bin = join(dirB, "git-remote-run402");
       writeFileSync(bin, "#!/bin/sh\n");
       chmodSync(bin, 0o755);
-      assert.equal(isExecutableOnPath("git-remote-kygit", { PATH: `${dirA}:${dirB}` }), true);
+      assert.equal(isExecutableOnPath("git-remote-run402", { PATH: `${dirA}:${dirB}` }), true);
     } finally {
       rmSync(dirA, { recursive: true, force: true });
       rmSync(dirB, { recursive: true, force: true });
@@ -60,29 +58,29 @@ describe("isExecutableOnPath", () => {
   });
 
   it("returns false for an empty or missing PATH rather than throwing", () => {
-    assert.equal(isExecutableOnPath("git-remote-kygit", {}), false);
-    assert.equal(isExecutableOnPath("git-remote-kygit", { PATH: "" }), false);
+    assert.equal(isExecutableOnPath("git-remote-run402", {}), false);
+    assert.equal(isExecutableOnPath("git-remote-run402", { PATH: "" }), false);
   });
 });
 
 describe("remoteHelperNextAction", () => {
-it("names the missing helper for the checkout's remote scheme, and nothing when it is on PATH or the checkout is unreadable", () => {
+it("names the missing helper for a run402:: checkout, and nothing when it is on PATH or the checkout is unreadable", () => {
   const dir = mkdtempSync(join(tmpdir(), "run402-remote-helper-"));
   try {
     mkdirSync(join(dir, ".git"));
-    writeFileSync(join(dir, ".git", "config"), `[core]\n\trepositoryformatversion = 0\n[remote "origin"]\n\turl = kygit::org/name\n\tfetch = +refs/heads/*:refs/remotes/origin/*\n`);
+    writeFileSync(join(dir, ".git", "config"), `[core]\n\trepositoryformatversion = 0\n[remote "origin"]\n\turl = run402::org/name\n\tfetch = +refs/heads/*:refs/remotes/origin/*\n`);
     const emptyPath = { PATH: dir };
     const missing = remoteHelperNextAction(dir, emptyPath);
     assert.equal(missing?.type, "install_remote_helper");
-    assert.match(missing.why, /git-remote-kygit/);
-    assert.equal(missing.command, "npm i -g @kychee/kygit run402");
+    assert.match(missing.why, /git-remote-run402/);
+    assert.equal(missing.command, "npm i -g run402");
     // present on PATH → nothing to say
     const bin = join(dir, "bin"); mkdirSync(bin);
-    writeFileSync(join(bin, "git-remote-kygit"), "#!/bin/sh\n"); chmodSync(join(bin, "git-remote-kygit"), 0o755);
+    writeFileSync(join(bin, "git-remote-run402"), "#!/bin/sh\n"); chmodSync(join(bin, "git-remote-run402"), 0o755);
     assert.equal(remoteHelperNextAction(dir, { PATH: bin }), null);
-    // run402:: scheme names the other helper
-    writeFileSync(join(dir, ".git", "config"), `[remote "origin"]\n\turl = run402::org/name\n`);
-    assert.match(remoteHelperNextAction(dir, emptyPath).why, /git-remote-run402/);
+    // any other remote → nothing to say
+    writeFileSync(join(dir, ".git", "config"), `[remote "origin"]\n\turl = https://example.com/x.git\n`);
+    assert.equal(remoteHelperNextAction(dir, emptyPath), null);
     // no checkout → null, never a throw
     assert.equal(remoteHelperNextAction(join(dir, "nope"), emptyPath), null);
   } finally {

package/lib/projects.mjs

@@ -164,7 +164,7 @@ Options:
 
 Notes:
   - Requires project.tenant_payments.read: org developer+ or a read-scoped
-    project grant/delegate.
+    project grant or grant key.
   - Output is the gateway's redacted payment page. Raw X-PAYMENT headers,
     authorization hashes, and internal metadata are never returned.
 `,