@praxisflux/gates 0.59.6 → 0.60.0

package/codebase-to-course/lib/installer.mjs

@@ -4,8 +4,8 @@
 // These helpers make that dotfile-safe, idempotent, and honest (verify on disk, never clobber
 // what the user has grown). Zero-dependency.
 
-import { cpSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { join, dirname } from "node:path";
+import { cpSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { join, dirname, resolve } from "node:path";
 
 /**
  * Recursively copy `src` → `dest`. Uses node:fs cp, which copies dotfiles (e.g. `.template/`)
@@ -38,6 +38,43 @@ export function ensureGitignore(root, entry) {
   return true;
 }
 
+/**
+ * Resolve the real git dir for `root`: the `.git` directory itself, or — when `.git` is a
+ * worktree pointer file (`gitdir: <path>`) — the path it points at. `null` when `.git` is
+ * absent (pre-`git init`, spec 060 R6) or unreadable.
+ */
+function resolveGitDir(root) {
+  const p = join(root, ".git");
+  if (!existsSync(p)) return null;
+  if (statSync(p).isDirectory()) return p;
+  try {
+    const m = /^gitdir:\s*(.+?)\s*$/m.exec(readFileSync(p, "utf8"));
+    return m ? resolve(root, m[1]) : null;
+  } catch { return null; }
+}
+
+/**
+ * Ensure `<gitdir>/info/exclude` contains every line in `entries` (local-only planting,
+ * spec 060 R1/R2), creating `info/` as needed and appending only lines not already present.
+ * Never touches `.gitignore`. Returns `{ status: "no-git" }` (nothing written — R6) when
+ * `root` has no `.git`, else `{ status: "added"|"unchanged", added: string[] }`.
+ * `dryRun: true` (plant's `--check`) reports what would happen without writing.
+ */
+export function ensureExclude(root, entries, { dryRun = false } = {}) {
+  const gitDir = resolveGitDir(root);
+  if (!gitDir) return { status: "no-git", added: [] };
+  const p = join(gitDir, "info", "exclude");
+  const existing = existsSync(p) ? readFileSync(p, "utf8") : "";
+  const have = new Set(existing.split("\n").map((l) => l.trim()));
+  const toAdd = entries.map((e) => e.trim()).filter((e) => !have.has(e));
+  if (toAdd.length === 0) return { status: "unchanged", added: [] };
+  if (dryRun) return { status: "added", added: toAdd };
+  mkdirSync(dirname(p), { recursive: true });
+  const prefix = existing === "" ? "" : existing.replace(/\n*$/, "\n");
+  writeFileSync(p, prefix + toAdd.join("\n") + "\n");
+  return { status: "added", added: toAdd };
+}
+
 /** Which of `relPaths` (relative to `root`) are missing on disk. Empty = all present. */
 export function verifyPresent(root, relPaths) {
   return relPaths.filter((r) => !existsSync(join(root, r)));

package/grounding-wiki/lib/installer.mjs

@@ -4,8 +4,8 @@
 // These helpers make that dotfile-safe, idempotent, and honest (verify on disk, never clobber
 // what the user has grown). Zero-dependency.
 
-import { cpSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { join, dirname } from "node:path";
+import { cpSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { join, dirname, resolve } from "node:path";
 
 /**
  * Recursively copy `src` → `dest`. Uses node:fs cp, which copies dotfiles (e.g. `.template/`)
@@ -38,6 +38,43 @@ export function ensureGitignore(root, entry) {
   return true;
 }
 
+/**
+ * Resolve the real git dir for `root`: the `.git` directory itself, or — when `.git` is a
+ * worktree pointer file (`gitdir: <path>`) — the path it points at. `null` when `.git` is
+ * absent (pre-`git init`, spec 060 R6) or unreadable.
+ */
+function resolveGitDir(root) {
+  const p = join(root, ".git");
+  if (!existsSync(p)) return null;
+  if (statSync(p).isDirectory()) return p;
+  try {
+    const m = /^gitdir:\s*(.+?)\s*$/m.exec(readFileSync(p, "utf8"));
+    return m ? resolve(root, m[1]) : null;
+  } catch { return null; }
+}
+
+/**
+ * Ensure `<gitdir>/info/exclude` contains every line in `entries` (local-only planting,
+ * spec 060 R1/R2), creating `info/` as needed and appending only lines not already present.
+ * Never touches `.gitignore`. Returns `{ status: "no-git" }` (nothing written — R6) when
+ * `root` has no `.git`, else `{ status: "added"|"unchanged", added: string[] }`.
+ * `dryRun: true` (plant's `--check`) reports what would happen without writing.
+ */
+export function ensureExclude(root, entries, { dryRun = false } = {}) {
+  const gitDir = resolveGitDir(root);
+  if (!gitDir) return { status: "no-git", added: [] };
+  const p = join(gitDir, "info", "exclude");
+  const existing = existsSync(p) ? readFileSync(p, "utf8") : "";
+  const have = new Set(existing.split("\n").map((l) => l.trim()));
+  const toAdd = entries.map((e) => e.trim()).filter((e) => !have.has(e));
+  if (toAdd.length === 0) return { status: "unchanged", added: [] };
+  if (dryRun) return { status: "added", added: toAdd };
+  mkdirSync(dirname(p), { recursive: true });
+  const prefix = existing === "" ? "" : existing.replace(/\n*$/, "\n");
+  writeFileSync(p, prefix + toAdd.join("\n") + "\n");
+  return { status: "added", added: toAdd };
+}
+
 /** Which of `relPaths` (relative to `root`) are missing on disk. Empty = all present. */
 export function verifyPresent(root, relPaths) {
   return relPaths.filter((r) => !existsSync(join(root, r)));

package/lib/installer.mjs

@@ -4,8 +4,8 @@
 // These helpers make that dotfile-safe, idempotent, and honest (verify on disk, never clobber
 // what the user has grown). Zero-dependency.
 
-import { cpSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { join, dirname } from "node:path";
+import { cpSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { join, dirname, resolve } from "node:path";
 
 /**
  * Recursively copy `src` → `dest`. Uses node:fs cp, which copies dotfiles (e.g. `.template/`)
@@ -38,6 +38,43 @@ export function ensureGitignore(root, entry) {
   return true;
 }
 
+/**
+ * Resolve the real git dir for `root`: the `.git` directory itself, or — when `.git` is a
+ * worktree pointer file (`gitdir: <path>`) — the path it points at. `null` when `.git` is
+ * absent (pre-`git init`, spec 060 R6) or unreadable.
+ */
+function resolveGitDir(root) {
+  const p = join(root, ".git");
+  if (!existsSync(p)) return null;
+  if (statSync(p).isDirectory()) return p;
+  try {
+    const m = /^gitdir:\s*(.+?)\s*$/m.exec(readFileSync(p, "utf8"));
+    return m ? resolve(root, m[1]) : null;
+  } catch { return null; }
+}
+
+/**
+ * Ensure `<gitdir>/info/exclude` contains every line in `entries` (local-only planting,
+ * spec 060 R1/R2), creating `info/` as needed and appending only lines not already present.
+ * Never touches `.gitignore`. Returns `{ status: "no-git" }` (nothing written — R6) when
+ * `root` has no `.git`, else `{ status: "added"|"unchanged", added: string[] }`.
+ * `dryRun: true` (plant's `--check`) reports what would happen without writing.
+ */
+export function ensureExclude(root, entries, { dryRun = false } = {}) {
+  const gitDir = resolveGitDir(root);
+  if (!gitDir) return { status: "no-git", added: [] };
+  const p = join(gitDir, "info", "exclude");
+  const existing = existsSync(p) ? readFileSync(p, "utf8") : "";
+  const have = new Set(existing.split("\n").map((l) => l.trim()));
+  const toAdd = entries.map((e) => e.trim()).filter((e) => !have.has(e));
+  if (toAdd.length === 0) return { status: "unchanged", added: [] };
+  if (dryRun) return { status: "added", added: toAdd };
+  mkdirSync(dirname(p), { recursive: true });
+  const prefix = existing === "" ? "" : existing.replace(/\n*$/, "\n");
+  writeFileSync(p, prefix + toAdd.join("\n") + "\n");
+  return { status: "added", added: toAdd };
+}
+
 /** Which of `relPaths` (relative to `root`) are missing on disk. Empty = all present. */
 export function verifyPresent(root, relPaths) {
   return relPaths.filter((r) => !existsSync(join(root, r)));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisflux/gates",
-  "version": "0.59.6",
+  "version": "0.60.0",
   "description": "praxisflux gate checks as a zero-dependency CLI (spec-bridge, wiki-freshness, course) — status can't exceed proven artifacts",
   "license": "MIT",
   "repository": {

package/spec-bridge/lib/installer.mjs

@@ -4,8 +4,8 @@
 // These helpers make that dotfile-safe, idempotent, and honest (verify on disk, never clobber
 // what the user has grown). Zero-dependency.
 
-import { cpSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { join, dirname } from "node:path";
+import { cpSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { join, dirname, resolve } from "node:path";
 
 /**
  * Recursively copy `src` → `dest`. Uses node:fs cp, which copies dotfiles (e.g. `.template/`)
@@ -38,6 +38,43 @@ export function ensureGitignore(root, entry) {
   return true;
 }
 
+/**
+ * Resolve the real git dir for `root`: the `.git` directory itself, or — when `.git` is a
+ * worktree pointer file (`gitdir: <path>`) — the path it points at. `null` when `.git` is
+ * absent (pre-`git init`, spec 060 R6) or unreadable.
+ */
+function resolveGitDir(root) {
+  const p = join(root, ".git");
+  if (!existsSync(p)) return null;
+  if (statSync(p).isDirectory()) return p;
+  try {
+    const m = /^gitdir:\s*(.+?)\s*$/m.exec(readFileSync(p, "utf8"));
+    return m ? resolve(root, m[1]) : null;
+  } catch { return null; }
+}
+
+/**
+ * Ensure `<gitdir>/info/exclude` contains every line in `entries` (local-only planting,
+ * spec 060 R1/R2), creating `info/` as needed and appending only lines not already present.
+ * Never touches `.gitignore`. Returns `{ status: "no-git" }` (nothing written — R6) when
+ * `root` has no `.git`, else `{ status: "added"|"unchanged", added: string[] }`.
+ * `dryRun: true` (plant's `--check`) reports what would happen without writing.
+ */
+export function ensureExclude(root, entries, { dryRun = false } = {}) {
+  const gitDir = resolveGitDir(root);
+  if (!gitDir) return { status: "no-git", added: [] };
+  const p = join(gitDir, "info", "exclude");
+  const existing = existsSync(p) ? readFileSync(p, "utf8") : "";
+  const have = new Set(existing.split("\n").map((l) => l.trim()));
+  const toAdd = entries.map((e) => e.trim()).filter((e) => !have.has(e));
+  if (toAdd.length === 0) return { status: "unchanged", added: [] };
+  if (dryRun) return { status: "added", added: toAdd };
+  mkdirSync(dirname(p), { recursive: true });
+  const prefix = existing === "" ? "" : existing.replace(/\n*$/, "\n");
+  writeFileSync(p, prefix + toAdd.join("\n") + "\n");
+  return { status: "added", added: toAdd };
+}
+
 /** Which of `relPaths` (relative to `root`) are missing on disk. Empty = all present. */
 export function verifyPresent(root, relPaths) {
   return relPaths.filter((r) => !existsSync(join(root, r)));