Self-hosted MCP server + dashboard giving Claude Code, Cursor & Hermes agents shared long-term memory over a git-backed markdown vault. Agent-native, Obsidian-compatible second brain — markdown RAG, no vector DB.
TypeScript agent-memoryai-agentsanthropicclaude-codecursorgitknowledge-baseknowledge-graphllmmarkdownmcpmcp-servermodel-context-protocolnote-takingobsidianpkmragsecond-brainself-hostedzettelkasten
fix(boot): defer vault git sync off the startup path (#2)
Ronalds Palacisdbcf5756132c
diff --git a/instrumentation.ts b/instrumentation.tsindex d29148e..8a18e6a 100644--- a/instrumentation.ts+++ b/instrumentation.ts@@ -1,11 +1,45 @@// Runs once when the server starts. Re-clones the active workspace's vault if missing// (e.g. a fresh volume), pulls the latest from its remote, then starts a periodic pull so// externally-pushed changes keep flowing in without a redeploy.+//+// The vault sync is deliberately DEFERRED off the startup path. It used to run inline here,+// which meant boot did: load Next.js -> immediately fork a git subprocess. That is the worst+// possible moment: Next is at its peak memory/thread usage, and on a small container the extra+// process tips it over — git dies with "getaddrinfo() thread failed to start" (pthread_create+// EAGAIN) and the runtime aborts (SIGABRT) before anything is served. The healthcheck then never+// passes, so the platform restart-loops forever and the whole service is down because a *background+// sync* failed. Serving the vault must not depend on being able to reach GitHub.+//+// So: return immediately (the server starts and /api/health answers), then do the git work once+// things have settled. A sync failure now degrades freshness instead of killing the process.+//+// Env knobs:+// ENGRAM_DISABLE_GIT_SYNC=1 — skip vault git entirely. Reads still work from the volume;+// use this to bring the service up when git is the thing breaking.+// ENGRAM_GIT_BOOT_DELAY_MS — how long to wait before the first sync (default 20s).export async function register() {if (process.env.NEXT_RUNTIME !== "nodejs") return;- const { ensureActiveCloned } = await import("@/lib/repos");- const { pullActive, startPullLoop } = await import("@/lib/git");- await ensureActiveCloned();- await pullActive().catch(() => {});- startPullLoop();++ if (process.env.ENGRAM_DISABLE_GIT_SYNC === "1") {+ console.warn("[boot] ENGRAM_DISABLE_GIT_SYNC=1 — serving the vault from disk, no git sync");+ return;+ }++ const delayMs = Number(process.env.ENGRAM_GIT_BOOT_DELAY_MS ?? 20_000);++ const timer = setTimeout(() => {+ void (async () => {+ try {+ const { ensureActiveCloned } = await import("@/lib/repos");+ const { pullActive, startPullLoop } = await import("@/lib/git");+ await ensureActiveCloned();+ await pullActive().catch(() => {});+ startPullLoop();+ } catch (e) {+ // Never rethrow: a broken sync must not take the server down with it.+ console.error("[boot] deferred vault sync failed — serving from disk anyway", e);+ }+ })();+ }, delayMs);+ timer.unref?.();}