@shardflux/cli 0.13.0 → 0.13.1

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.13.1
+
+- `npx @shardflux/cli` runs `shard` again: the package exposes one command. The Git remote helper that `shard` uses for agent branches runs from a private shim on the PATH of the git commands `shard` starts.
+
 ## 0.13.0 (not yet published)
 
 - Start the native agent while supervised repository setup runs in the background; show per-step setup progress and one failed-step retry in the command center. Changed runtime, CI, workspace and dependency inputs queue the next template preparation.

package/dist/agent-git.js

@@ -4,12 +4,13 @@ import { existsSync, mkdirSync, readFileSync, realpathSync, rmSync, writeFileSyn
 import { dirname, join, resolve } from 'node:path';
 import { UsageError } from "./errors.js";
 import { AgentStateStore } from "./agent-state.js";
+import { gitPath } from "./git-remote-helper.js";
 const execute = promisify(execFile);
 const DAY = 86_400_000;
 export function gitRunner(root, env = process.env, signal) {
     return async (args) => {
         const result = await execute('git', ['--no-pager', '-C', root, ...args], {
-            env: { ...env, GIT_TERMINAL_PROMPT: '0', GIT_MERGE_AUTOEDIT: 'no' },
+            env: { ...env, PATH: gitPath(env), GIT_TERMINAL_PROMPT: '0', GIT_MERGE_AUTOEDIT: 'no' },
             timeout: 120_000, maxBuffer: 4 * 1024 * 1024, signal,
         });
         return result.stdout.trim();

package/dist/args.d.ts

@@ -1,4 +1,4 @@
-export declare const CLI_VERSION = "0.13.0";
+export declare const CLI_VERSION = "0.13.1";
 export interface OptionSpec {
     type: 'string' | 'boolean';
     short?: string;

package/dist/args.js

@@ -12,7 +12,7 @@
 import { parseArgs } from 'node:util';
 import { ACCOUNT_COMMANDS } from "./account-args.js";
 import { UsageError } from "./errors.js";
-export const CLI_VERSION = '0.13.0';
+export const CLI_VERSION = '0.13.1';
 export const GLOBAL_OPTIONS = {
     'api-url': { type: 'string', value: '<url>', description: 'API base URL (default $SHARDFLUX_API_URL, else https://api.shardflux.dev).' },
     json: { type: 'boolean', description: 'Print machine-readable JSON on stdout (errors as JSON on stderr).' },

package/dist/git-remote-helper.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Git finds a remote helper as `git-remote-<transport>` on PATH. The package exposes only `shard` (a single bin keeps
+ * `npx @shardflux/cli` working), so the git commands shard runs get a private directory on PATH holding a
+ * `git-remote-shard` shim that runs this installation's helper with the same Node.
+ */
+export declare function gitRemoteHelperDir(env?: NodeJS.ProcessEnv): string;
+/** PATH for git commands shard runs: the helper directory first, then the caller's PATH. */
+export declare function gitPath(env?: NodeJS.ProcessEnv): string;

package/dist/git-remote-helper.js

@@ -0,0 +1,31 @@
+import { chmodSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { delimiter, extname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * Git finds a remote helper as `git-remote-<transport>` on PATH. The package exposes only `shard` (a single bin keeps
+ * `npx @shardflux/cli` working), so the git commands shard runs get a private directory on PATH holding a
+ * `git-remote-shard` shim that runs this installation's helper with the same Node.
+ */
+export function gitRemoteHelperDir(env = process.env) {
+    const dir = join(env.XDG_CACHE_HOME || join(homedir(), '.cache'), 'shardflux', 'git-remote');
+    const script = fileURLToPath(new URL(`./git-remote-bin${extname(fileURLToPath(import.meta.url))}`, import.meta.url));
+    const quote = (s) => `'${s.replaceAll("'", `'\\''`)}'`;
+    const shim = `#!/bin/sh\nexec ${quote(process.execPath)} ${quote(script)} "$@"\n`;
+    const target = join(dir, 'git-remote-shard');
+    let current = '';
+    try {
+        current = readFileSync(target, 'utf8');
+    }
+    catch { /* first use */ }
+    if (current !== shim) {
+        mkdirSync(dir, { recursive: true, mode: 0o700 });
+        writeFileSync(target, shim, { mode: 0o755 });
+        chmodSync(target, 0o755);
+    }
+    return dir;
+}
+/** PATH for git commands shard runs: the helper directory first, then the caller's PATH. */
+export function gitPath(env = process.env) {
+    return [gitRemoteHelperDir(env), env.PATH].filter(Boolean).join(delimiter);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shardflux/cli",
-  "version": "0.13.0",
+  "version": "0.13.1",
   "type": "module",
   "description": "shard: the Shardflux command line. Create an account, sign in, set up keys and billing, then open, run commands in, move files to, suspend, resume and fork serverless agent workspaces.",
   "license": "Apache-2.0",
@@ -23,8 +23,7 @@
     "node": ">=24"
   },
   "bin": {
-    "shard": "./dist/bin.js",
-    "git-remote-shard": "./dist/git-remote-bin.js"
+    "shard": "./dist/bin.js"
   },
   "exports": {
     ".": {