@einsia/agent-git 0.2.10 → 0.2.12

package/CHANGELOG.md

@@ -6,6 +6,36 @@ Every notable change to agit, the AgentGit CLI, by release. The format follows
 its [GitHub Release](https://github.com/Einsia/agent-git/releases), and the
 `@einsia/agent-git` npm package ships this file.
 
+## [Unreleased]
+
+## [0.2.12] - 2026-09-28
+
+### Fixed
+
+- Retry RC daemon reconciliation when a global npm installation's lifecycle
+  scripts are disabled. The next CLI invocation schedules the guarded handoff
+  in the background, while project-local and temporary npm packages cannot
+  replace a persistent daemon.
+
+## [0.2.11] - 2026-09-28
+
+### Fixed
+
+- Reconcile the local RC daemon after self-upgrade, global npm installation, or
+  `npx create-agit`, including installations at a different executable path.
+  Idle sessions attached to a persistent Codex server can detach for a safe
+  restart; busy daemons retry after their work clears.
+- Stage the `create-agit` executable before replacing it, so an installation
+  failure preserves the previous CLI. Report when another `agit` on `PATH`
+  shadows the installed copy.
+- Reach the Hub without a fixed stall when one of its addresses is unreachable
+  from your network. agit dialed the resolved addresses one after another and
+  gave the first one most of the connection budget, so every command that talked
+  to the Hub could wait about 20 seconds before trying the next address. The
+  addresses now race: the next one starts after 250 ms or as soon as the
+  previous one fails. Hub API requests, SOCKS proxy connections, LFS
+  availability checks and `agit upgrade` downloads all use it.
+
 ## [0.2.10] - 2026-09-28
 
 ### Fixed

package/npm/README.md

@@ -65,6 +65,9 @@ Unsupported operating system and architecture pairs get no prebuilt binary: runn
   recipe.
 - `agit setup` failing in postinstall never blocks the install — the CLI is on
   disk; re-run `agit setup` any time.
+- If npm suppresses postinstall, the next invocation of a globally installed
+  `agit` schedules a guarded RC daemon reconciliation in the background.
+  npm cannot run the daemon handoff at install time when it suppresses scripts.
 
 ## Environment variables
 

package/npm/lib/reconcile-worker.js

@@ -0,0 +1,40 @@
+'use strict';
+
+const { spawnSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const [bin, pkgRoot, launcher] = process.argv.slice(2);
+if (!bin || !pkgRoot) process.exit(0);
+
+// A transient npx or project-local binary cannot own a persistent daemon.
+// npm's global root or its verified bin symlink identifies a durable install.
+const root = spawnSync('npm', ['root', '-g'], { encoding: 'utf8', timeout: 5000, windowsHide: true });
+let global = false;
+try {
+  const installed = fs.realpathSync(pkgRoot);
+  const same = other => process.platform === 'win32'
+    ? installed.toLowerCase() === other.toLowerCase()
+    : installed === other;
+  if (!root.error && root.status === 0) {
+    try {
+      global = same(fs.realpathSync(path.join(root.stdout.trim(), '@einsia', 'agent-git', 'npm')));
+    } catch { /* A missing current npm root may leave a still-valid installed launcher. */ }
+  }
+  if (!global && launcher && fs.lstatSync(launcher).isSymbolicLink()
+      && path.basename(path.dirname(launcher)) === 'bin'
+      && same(fs.realpathSync(path.join(path.dirname(launcher), '..', 'lib', 'node_modules', '@einsia', 'agent-git', 'npm')))
+      && fs.realpathSync(launcher) === fs.realpathSync(path.join(pkgRoot, 'shim.js'))) {
+    global = true;
+  }
+} catch {
+  process.exit(0);
+}
+if (!global) process.exit(0);
+
+spawnSync(bin, ['rc', 'local', 'reconcile-installed', '--allow-other-installation'], {
+  stdio: 'ignore',
+  timeout: 35000,
+  env: { ...process.env, AGIT_INSTALL_CHANNEL: 'npm_global' },
+  windowsHide: true,
+});

package/npm/lib/reconcile.js

@@ -0,0 +1,51 @@
+'use strict';
+
+const { spawn } = require('child_process');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+const RETRY_MS = 5 * 60 * 1000;
+
+// An npm policy may suppress postinstall. The next CLI use retries the guarded
+// daemon handoff without changing the command's output or exit status.
+function scheduleReconciliation(bin, pkgRoot) {
+  if (process.env.AGIT_BINARY || process.env.AGIT_INTERNAL_UPDATE_RESTART) return;
+  const home = process.env.AGIT_HOME?.trim() || path.join(os.homedir(), '.agit');
+  const dir = path.join(home, 'desktop-rc');
+  let fingerprint;
+  try {
+    const daemon = fs.statSync(path.join(dir, 'agitd.pid'));
+    const installed = fs.statSync(bin);
+    fingerprint = `${path.resolve(bin)}:${installed.size}:${installed.mtimeMs}:${daemon.size}:${daemon.mtimeMs}`;
+    const stamp = path.join(dir, 'npm-reconcile.json');
+    try {
+      const previous = JSON.parse(fs.readFileSync(stamp, 'utf8'));
+      if (previous.fingerprint === fingerprint && Date.now() - previous.at < RETRY_MS) return;
+    } catch { /* An absent or invalid retry receipt cannot suppress reconciliation. */ }
+    const temporary = `${stamp}.${process.pid}.${Math.random().toString(16).slice(2)}`;
+    try {
+      fs.writeFileSync(temporary, JSON.stringify({ fingerprint, at: Date.now() }), { mode: 0o600, flag: 'wx' });
+      fs.renameSync(temporary, stamp);
+    } catch {
+      try { fs.unlinkSync(temporary); } catch { /* The best-effort receipt is optional. */ }
+    }
+  } catch {
+    return; // No running daemon is indicated in this home.
+  }
+
+  try {
+    const child = spawn(process.execPath, [path.join(__dirname, 'reconcile-worker.js'), bin, pkgRoot, process.argv[1] || ''], {
+      detached: true,
+      stdio: 'ignore',
+      env: { ...process.env, AGIT_TELEMETRY_DEFER: '1', AGIT_INTERNAL_UPDATE_RESTART: '1' },
+      windowsHide: true,
+    });
+    child.on('error', () => {});
+    child.unref();
+  } catch {
+    // Reconciliation never changes the forwarded command's result.
+  }
+}
+
+module.exports = { scheduleReconciliation };

package/npm/lib/run.js

@@ -5,10 +5,10 @@ const path = require('path');
 const platform = require('./platform');
 const { resolveBinary } = require('./resolve');
 const log = require('./log');
+const { scheduleReconciliation } = require('./reconcile');
 
-// Entry point for the `agit` command. Thin is deliberate: forward argv / stdio /
-// exit code, nothing else. agit gets written into scripts and hooks, so exit
-// codes and stdio pass-through are load-bearing semantics and must not change.
+// Forward argv, stdio, and exit status unchanged. Hooks rely on those semantics;
+// daemon reconciliation therefore runs independently of the forwarded command.
 function run() {
   const pkgRoot = path.join(__dirname, '..');
   let bin = null;
@@ -37,7 +37,13 @@ function run() {
     process.exit(127);
   }
 
-  const r = spawnSync(bin, process.argv.slice(2), {
+  const args = process.argv.slice(2);
+  // A bridge may stay open indefinitely, so queue its install check before forwarding.
+  // Other commands finish first to avoid racing their own daemon operation.
+  if (args[0] === 'rc' && args[1] === 'local' && args[2] === 'bridge') {
+    scheduleReconciliation(bin, pkgRoot);
+  }
+  const r = spawnSync(bin, args, {
     stdio: 'inherit',
     env: { ...process.env, AGIT_INSTALL_CHANNEL: 'npm_global' },
   });
@@ -45,6 +51,9 @@ function run() {
     log.error(`failed to start ${bin}: ${r.error.message}`);
     process.exit(1);
   }
+  if (!(args[0] === 'rc' && args[1] === 'local' && args[2] === 'bridge')) {
+    scheduleReconciliation(bin, pkgRoot);
+  }
   process.exit(r.status === null ? 1 : r.status);
 }
 

package/npm/postinstall.js

@@ -1,14 +1,8 @@
 'use strict';
 
-// postinstall: the binary lands with the optional dep, so there is nothing to download. It
-// does two things in passing, each idempotent and neither able to block the install when it
-// fails:
-//
-// 1. Self-check that the binary really runs (an architecture mismatch, Rosetta and the like
-//    surface here rather than the first time the user types agit).
-// 2. Run `agit setup` — the product promise of "installed by default at download time":
-//    skills, hooks, MCP and AGENTS.md, all in one go. AGIT_SKIP_SETUP=1 turns it off
-//    (CI / hosted environments).
+// The binary lands with the optional dependency, so installation needs no download. Verify it
+// before setup or daemon reconciliation; neither follow-up can invalidate the installed CLI.
+// AGIT_SKIP_SETUP=1 leaves the installed binary available without configuring user integrations.
 //
 // npm displays postinstall output badly, so stay quiet: speak only when something is wrong.
 
@@ -59,6 +53,22 @@ function main() {
       env: { ...process.env, AGIT_INSTALL_CHANNEL: 'npm_global' },
     });
   }
+  if (truthy(process.env.npm_config_global) && process.env.npm_command !== 'exec') {
+    const reconciled = spawnSync(bin, ['rc', 'local', 'reconcile-installed', '--allow-other-installation'], {
+      encoding: 'utf8', timeout: 35000,
+      env: { ...env, AGIT_INTERNAL_UPDATE_RESTART: '1' },
+    });
+    if (reconciled.error || reconciled.status !== 0) {
+      log.warn(`RC daemon reconciliation failed: ${(reconciled.stderr || reconciled.error?.message || `exit ${reconciled.status}`).trim()}`);
+    } else {
+      try {
+        const outcome = JSON.parse(reconciled.stdout);
+        if (outcome.status === 'deferred') log.warn(`RC daemon upgrade is pending: ${outcome.message}`);
+      } catch {
+        log.warn('RC daemon returned an unreadable reconciliation result.');
+      }
+    }
+  }
   if (truthy(process.env.AGIT_SKIP_SETUP)) return;
   const setup = spawnSync(bin, ['setup'], { stdio: 'inherit', env });
   if (setup.status !== 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@einsia/agent-git",
-  "version": "0.2.10",
+  "version": "0.2.12",
   "description": "Version control for agent sessions — the agit CLI plus skills/hooks/MCP wiring for Claude Code, Codex, OpenCode and Cursor. The AgentGit hub deploys separately.",
   "keywords": [
     "agit",
@@ -49,10 +49,10 @@
     "access": "public"
   },
   "optionalDependencies": {
-    "@einsia/agent-git-linux-x64": "0.2.10",
-    "@einsia/agent-git-linux-arm64": "0.2.10",
-    "@einsia/agent-git-darwin-x64": "0.2.10",
-    "@einsia/agent-git-darwin-arm64": "0.2.10",
-    "@einsia/agent-git-win32-x64": "0.2.10"
+    "@einsia/agent-git-linux-x64": "0.2.12",
+    "@einsia/agent-git-linux-arm64": "0.2.12",
+    "@einsia/agent-git-darwin-x64": "0.2.12",
+    "@einsia/agent-git-darwin-arm64": "0.2.12",
+    "@einsia/agent-git-win32-x64": "0.2.12"
   }
 }