@bridge_gpt/mcp-server 0.1.16 → 0.2.0

package/build/git-ignore-utils.js

@@ -0,0 +1,63 @@
+/**
+ * Local-only ignore helpers.
+ *
+ * Two idempotent, exact-line appenders:
+ *   - `ensureGitignored` writes the tracked `<cwd>/.gitignore` (shared with the
+ *     existing `--init` scaffolding behavior).
+ *   - `ensureGitInfoExcluded` writes the UNtracked `<worktreeRoot>/.git/info/exclude`,
+ *     used for Tier-3 file credentials that must never enter version control and
+ *     must never touch the tracked `.gitignore`.
+ *
+ * Both are dependency-injected so they are unit-testable without real I/O, and
+ * neither ever includes credential file contents in an error.
+ */
+import path from "path";
+/** True when `content` already contains `entry` as its own exact (trimmed) line. */
+function hasExactLine(content, entry) {
+    return content.split("\n").some((line) => line.trim() === entry);
+}
+/** Append `entry` to `content`, inserting a separating newline only if needed. */
+function appendLine(content, entry) {
+    const separator = content.length > 0 && !content.endsWith("\n") ? "\n" : "";
+    return content + separator + entry + "\n";
+}
+/**
+ * Idempotently ensure `filePath` is listed in `<cwd>/.gitignore`. An absolute
+ * `filePath` is made relative to `cwd`; an already-relative path is used as-is.
+ * No-op when the exact line already exists.
+ */
+export async function ensureGitignored(cwd, filePath, deps) {
+    const gitignorePath = path.join(cwd, ".gitignore");
+    const entry = path.isAbsolute(filePath) ? path.relative(cwd, filePath) : filePath;
+    let content = "";
+    try {
+        content = await deps.readFile(gitignorePath);
+    }
+    catch {
+        /* .gitignore doesn't exist yet */
+    }
+    if (hasExactLine(content, entry))
+        return;
+    await deps.writeFile(gitignorePath, appendLine(content, entry));
+}
+/**
+ * Idempotently ensure `relativePath` is listed in the worktree's local-only
+ * `<worktreeRoot>/.git/info/exclude`. Creates `<worktreeRoot>/.git/info` if it
+ * does not exist. Matching is exact-line (so `dw.json` is not treated as present
+ * just because `dw.json.bak` exists). Never edits the tracked `.gitignore`.
+ */
+export async function ensureGitInfoExcluded(worktreeRoot, relativePath, deps) {
+    const infoDir = path.join(worktreeRoot, ".git", "info");
+    const excludePath = path.join(infoDir, "exclude");
+    let content = "";
+    try {
+        content = await deps.readFile(excludePath);
+    }
+    catch {
+        /* exclude file (or .git/info) doesn't exist yet */
+    }
+    if (hasExactLine(content, relativePath))
+        return;
+    await deps.mkdir(infoDir, { recursive: true });
+    await deps.writeFile(excludePath, appendLine(content, relativePath));
+}