/** * @file Keeps files AgentHub writes into a lane's directory out of git, through * the one `info/exclude` git actually reads for that lane. That is the COMMON * git dir's, not the lane's own: a linked worktree — every managed lane — has a * private `.git/worktrees//`, and git never reads an exclude file there. * A lane that is a subdirectory of its repo has no `.git` of its own at all. * * @author Nguyễn Ngọc Trí Vĩ */ const { execFileSync } = require("node:child_process"); const fs = require("node:fs"); const path = require("node:path"); // Hook variables that would point git at ANOTHER repo (the one whose hook, or // shell, started us) — the same set `worktree.js`'s git() scrubs. With // GIT_DIR set, `rev-parse` would name that repo and the entry land there. const REPO_VARS = [ "GIT_DIR", "GIT_WORK_TREE", "GIT_INDEX_FILE", "GIT_COMMON_DIR", "GIT_OBJECT_DIRECTORY", "GIT_ALTERNATE_OBJECT_DIRECTORIES", "GIT_PREFIX", "GIT_NAMESPACE", ]; /** * Idempotently exclude `relPaths` (relative to `laneDir`), each anchored to the * lane's own path so the entry hides nothing outside it. Best effort: a lane * that is not a repo, or a git dir that cannot be written, is left alone — * never a reason to fail the write that needed the exclude. * * @param {string} laneDir * @param {string[]} relPaths e.g. [".mcp.json", ".claude/.cc-config-backups/"] */ function excludeFromGit(laneDir, relPaths) { try { const env = { ...process.env }; for (const name of REPO_VARS) delete env[name]; const [commonDir, prefix = ""] = execFileSync( "git", ["rev-parse", "--git-common-dir", "--show-prefix"], { cwd: laneDir, env, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] } ).split("\n"); const lines = relPaths.map((rel) => `/${prefix}${rel}`); const excludePath = path.join(path.resolve(laneDir, commonDir), "info", "exclude"); fs.mkdirSync(path.dirname(excludePath), { recursive: true }); let existing = fs.existsSync(excludePath) ? fs.readFileSync(excludePath, "utf8") : ""; const present = new Set(existing.split("\n")); const missing = lines.filter((line) => !present.has(line)); if (missing.length === 0) return; if (existing && !existing.endsWith("\n")) existing += "\n"; fs.writeFileSync(excludePath, `${existing}${missing.join("\n")}\n`); } catch { /* not a repo, or unwritable — see above */ } } /** * The same, anchored at the REPOSITORY root rather than `dir` — for paths a * tool creates at the root whatever subdirectory it was started in (Claude * Code's `.claude/worktrees/`). Best effort, like `excludeFromGit`. */ function excludeFromRepoRoot(dir, relPaths) { try { const env = { ...process.env }; for (const name of REPO_VARS) delete env[name]; const root = execFileSync("git", ["rev-parse", "--show-toplevel"], { cwd: dir, env, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"], }).trim(); if (root) excludeFromGit(root, relPaths); } catch { /* not a repo */ } } module.exports = { excludeFromGit, excludeFromRepoRoot };