run402 4.70.2 → 4.70.3

package/gitvault-surface.json

@@ -1,5 +1,5 @@
 {
-  "surface_version": "4.70.2",
+  "surface_version": "4.70.3",
   "verbs": [
     "repos create",
     "repos list",

package/lib/path-lookup.mjs

@@ -6,7 +6,7 @@
  * subprocess — a plain directory scan mirrors what the OS loader itself
  * does to resolve an unqualified command name.
  */
-import { accessSync, constants } from "node:fs";
+import {accessSync, constants, readFileSync } from "node:fs";
 import { delimiter, join } from "node:path";
 
 /** True iff `name` resolves to an executable file somewhere on `PATH`. Windows `PATHEXT` is out of scope — this CLI targets POSIX (`engines.node` + the hardened-git doc comments assume it) — so no `.exe`/`.cmd` suffix search. */
@@ -22,3 +22,31 @@ export function isExecutableOnPath(name, env = process.env) {
   }
   return false;
 }
+
+/**
+ * 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
+ * `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).
+ */
+export function remoteHelperNextAction(dir, env = process.env) {
+  let url = null;
+  try {
+    const cfg = readFileSync(join(dir, ".git", "config"), "utf8");
+    const m = cfg.match(/\[remote "origin"\][^[]*?\n\s*url\s*=\s*(\S+)/);
+    url = m ? m[1] : null;
+  } catch {
+    return null;
+  }
+  if (!url) return null;
+  const helper = url.startsWith("kygit::") ? "git-remote-kygit" : 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`,
+  };
+}

package/lib/path-lookup.test.mjs

@@ -6,10 +6,10 @@
  */
 import { describe, it } from "node:test";
 import assert from "node:assert/strict";
-import { mkdtempSync, chmodSync, writeFileSync, rmSync } from "node:fs";
+import { mkdtempSync, mkdirSync, chmodSync, writeFileSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
-import { isExecutableOnPath } from "./path-lookup.mjs";
+import { isExecutableOnPath, remoteHelperNextAction } from "./path-lookup.mjs";
 
 describe("isExecutableOnPath", () => {
   it("finds an executable file on PATH", () => {
@@ -64,3 +64,29 @@ describe("isExecutableOnPath", () => {
     assert.equal(isExecutableOnPath("git-remote-kygit", { 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", () => {
+  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`);
+    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");
+    // 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);
+    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/);
+    // no checkout → null, never a throw
+    assert.equal(remoteHelperNextAction(join(dir, "nope"), emptyPath), null);
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+});
+});

package/lib/repos.mjs

@@ -1918,6 +1918,13 @@ async function resume(args) {
   try {
     const result = await sdk.gitvault.resume({ key, ...(to != null ? { to } : {}), onLine: (line) => console.error(line) });
     if (coldStart.next_action) result.next_actions = [...(result.next_actions ?? []), coldStart.next_action];
+    // The restored checkout's first git command needs the remote helper on
+    // PATH; an npx-run resume/join has it only in the npx cache. Name it.
+    try {
+      const { remoteHelperNextAction } = await import("./path-lookup.mjs");
+      const helperAction = result.restored?.dir ? remoteHelperNextAction(result.restored.dir) : null;
+      if (helperAction) result.next_actions = [...(result.next_actions ?? []), helperAction];
+    } catch { /* never fails a completed claim */ }
     if (a.includes("--json")) {
       printJson(sdk, { ...result, cold_start: coldStart });
     } else {
@@ -2111,6 +2118,13 @@ async function joinInvite(args) {
     } catch {
       // never fails a completed join
     }
+    // The restored checkout's first git command needs the remote helper on
+    // PATH; an npx-run resume/join has it only in the npx cache. Name it.
+    try {
+      const { remoteHelperNextAction } = await import("./path-lookup.mjs");
+      const helperAction = result.restored?.dir ? remoteHelperNextAction(result.restored.dir) : null;
+      if (helperAction) result.next_actions = [...(result.next_actions ?? []), helperAction];
+    } catch { /* never fails a completed claim */ }
     if (a.includes("--json")) {
       printJson(sdk, { ...result, cold_start: coldStart });
     } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "run402",
-  "version": "4.70.2",
+  "version": "4.70.3",
   "description": "CLI for Run402 — full-stack backend infrastructure for AI agents: Postgres, auth, storage, serverless functions and atomic deploys. Paid with x402/MPP. Includes $0.03 image generation.",
   "type": "module",
   "bin": {