@einsia/agent-git 0.2.11 → 0.2.12

package/CHANGELOG.md

@@ -8,6 +8,15 @@ its [GitHub Release](https://github.com/Einsia/agent-git/releases), and the
 
 ## [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

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@einsia/agent-git",
-  "version": "0.2.11",
+  "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.11",
-    "@einsia/agent-git-linux-arm64": "0.2.11",
-    "@einsia/agent-git-darwin-x64": "0.2.11",
-    "@einsia/agent-git-darwin-arm64": "0.2.11",
-    "@einsia/agent-git-win32-x64": "0.2.11"
+    "@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"
   }
 }