@outfitter/tooling 0.2.0 → 0.2.2

package/dist/shared/@outfitter/tooling-8sd32ts6.js

@@ -0,0 +1,277 @@
+// @bun
+// packages/tooling/src/cli/pre-push.ts
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+var COLORS = {
+  reset: "\x1B[0m",
+  red: "\x1B[31m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  blue: "\x1B[34m"
+};
+function log(msg) {
+  process.stdout.write(`${msg}
+`);
+}
+function getCurrentBranch() {
+  const result = Bun.spawnSync(["git", "rev-parse", "--abbrev-ref", "HEAD"]);
+  return result.stdout.toString().trim();
+}
+function runGit(args) {
+  try {
+    const result = Bun.spawnSync(["git", ...args], { stderr: "ignore" });
+    if (result.exitCode !== 0) {
+      return { ok: false, lines: [] };
+    }
+    return {
+      ok: true,
+      lines: result.stdout.toString().split(`
+`).map((line) => line.trim()).filter(Boolean)
+    };
+  } catch {
+    return { ok: false, lines: [] };
+  }
+}
+function isRedPhaseBranch(branch) {
+  return branch.endsWith("-tests") || branch.endsWith("/tests") || branch.endsWith("_tests");
+}
+function isScaffoldBranch(branch) {
+  return branch.endsWith("-scaffold") || branch.endsWith("/scaffold") || branch.endsWith("_scaffold");
+}
+var TEST_PATH_PATTERNS = [
+  /(^|\/)__tests__\//,
+  /(^|\/)__snapshots__\//,
+  /\.(test|spec)\.[cm]?[jt]sx?$/,
+  /\.snap$/,
+  /(^|\/)(vitest|jest|bun)\.config\.[cm]?[jt]s$/,
+  /(^|\/)tsconfig\.test\.json$/,
+  /(^|\/)\.env\.test(\.|$)/
+];
+function isTestOnlyPath(path) {
+  const normalized = path.replaceAll("\\", "/");
+  return TEST_PATH_PATTERNS.some((pattern) => pattern.test(normalized));
+}
+function areFilesTestOnly(paths) {
+  return paths.length > 0 && paths.every((path) => isTestOnlyPath(path));
+}
+function canBypassRedPhaseByChangedFiles(changedFiles) {
+  return changedFiles.deterministic && areFilesTestOnly(changedFiles.files);
+}
+function resolveBaseRef() {
+  const candidates = [
+    "origin/main",
+    "main",
+    "origin/trunk",
+    "trunk",
+    "origin/master",
+    "master"
+  ];
+  for (const candidate of candidates) {
+    const resolved = runGit(["rev-parse", "--verify", "--quiet", candidate]);
+    if (resolved.ok) {
+      return candidate;
+    }
+  }
+  return;
+}
+function changedFilesFromRange(range) {
+  const result = runGit(["diff", "--name-only", "--diff-filter=d", range]);
+  return {
+    ok: result.ok,
+    files: result.lines
+  };
+}
+function getChangedFilesForPush() {
+  const upstream = runGit([
+    "rev-parse",
+    "--abbrev-ref",
+    "--symbolic-full-name",
+    "@{upstream}"
+  ]);
+  if (upstream.ok && upstream.lines[0]) {
+    const rangeResult = changedFilesFromRange(`${upstream.lines[0]}...HEAD`);
+    if (rangeResult.ok) {
+      return {
+        files: rangeResult.files,
+        deterministic: true,
+        source: "upstream"
+      };
+    }
+  }
+  const baseRef = resolveBaseRef();
+  if (baseRef) {
+    const rangeResult = changedFilesFromRange(`${baseRef}...HEAD`);
+    if (rangeResult.ok) {
+      return {
+        files: rangeResult.files,
+        deterministic: true,
+        source: "baseRef"
+      };
+    }
+  }
+  return {
+    files: [],
+    deterministic: false,
+    source: "undetermined"
+  };
+}
+function maybeSkipForRedPhase(reason, branch) {
+  const changedFiles = getChangedFilesForPush();
+  if (!changedFiles.deterministic) {
+    log(`${COLORS.yellow}RED-phase bypass denied${COLORS.reset}: could not determine full push diff range`);
+    log("Running strict verification.");
+    log("");
+    return false;
+  }
+  if (!canBypassRedPhaseByChangedFiles(changedFiles)) {
+    log(`${COLORS.yellow}RED-phase bypass denied${COLORS.reset}: changed files are not test-only`);
+    if (changedFiles.files.length > 0) {
+      log(`Changed files (${changedFiles.source}): ${changedFiles.files.join(", ")}`);
+    } else {
+      log(`No changed files detected in ${changedFiles.source} range. Running strict verification.`);
+    }
+    log("");
+    return false;
+  }
+  if (reason === "branch") {
+    log(`${COLORS.yellow}TDD RED phase${COLORS.reset} detected: ${COLORS.blue}${branch}${COLORS.reset}`);
+  } else {
+    log(`${COLORS.yellow}Scaffold branch${COLORS.reset} with RED phase branch in context: ${COLORS.blue}${branch}${COLORS.reset}`);
+  }
+  log(`${COLORS.yellow}Skipping strict verification${COLORS.reset} - changed files are test-only`);
+  log(`Diff source: ${changedFiles.source}`);
+  log("");
+  log("Remember: GREEN phase (implementation) must make these tests pass!");
+  return true;
+}
+function hasRedPhaseBranchInContext(currentBranch) {
+  let branches = [];
+  try {
+    const gtResult = Bun.spawnSync(["gt", "ls"], { stderr: "pipe" });
+    if (gtResult.exitCode === 0) {
+      branches = gtResult.stdout.toString().split(`
+`).map((line) => line.replace(/^[\u2502\u251C\u2514\u2500\u25C9\u25EF ]*/g, "").replace(/ \(.*/, "")).filter(Boolean);
+    }
+  } catch {}
+  if (branches.length === 0) {
+    const gitResult = Bun.spawnSync([
+      "git",
+      "branch",
+      "--list",
+      "cli/*",
+      "types/*",
+      "contracts/*"
+    ]);
+    branches = gitResult.stdout.toString().split(`
+`).map((line) => line.replace(/^[* ]+/, "")).filter(Boolean);
+  }
+  for (const branch of branches) {
+    if (branch === currentBranch)
+      continue;
+    if (isRedPhaseBranch(branch))
+      return true;
+  }
+  return false;
+}
+function createVerificationPlan(scripts) {
+  if (scripts["verify:ci"]) {
+    return { ok: true, scripts: ["verify:ci"], source: "verify:ci" };
+  }
+  const requiredScripts = ["typecheck", "build", "test"];
+  const missingRequired = requiredScripts.filter((name) => !scripts[name]);
+  const checkOrLint = scripts["check"] ? "check" : scripts["lint"] ? "lint" : undefined;
+  if (!checkOrLint || missingRequired.length > 0) {
+    const missing = checkOrLint ? missingRequired : [...missingRequired, "check|lint"];
+    return {
+      ok: false,
+      error: `Missing required scripts for strict pre-push verification: ${missing.join(", ")}`
+    };
+  }
+  return {
+    ok: true,
+    scripts: ["typecheck", checkOrLint, "build", "test"],
+    source: "fallback"
+  };
+}
+function readPackageScripts(cwd = process.cwd()) {
+  const packageJsonPath = join(cwd, "package.json");
+  if (!existsSync(packageJsonPath)) {
+    return {};
+  }
+  try {
+    const parsed = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+    const scripts = parsed.scripts ?? {};
+    const normalized = {};
+    for (const [name, value] of Object.entries(scripts)) {
+      if (typeof value === "string") {
+        normalized[name] = value;
+      }
+    }
+    return normalized;
+  } catch {
+    return {};
+  }
+}
+function runScript(scriptName) {
+  log("");
+  log(`Running: ${COLORS.blue}bun run ${scriptName}${COLORS.reset}`);
+  const result = Bun.spawnSync(["bun", "run", scriptName], {
+    stdio: ["inherit", "inherit", "inherit"]
+  });
+  return result.exitCode === 0;
+}
+async function runPrePush(options = {}) {
+  log(`${COLORS.blue}Pre-push verify${COLORS.reset} (TDD-aware)`);
+  log("");
+  const branch = getCurrentBranch();
+  if (isRedPhaseBranch(branch)) {
+    if (maybeSkipForRedPhase("branch", branch)) {
+      process.exit(0);
+    }
+  }
+  if (isScaffoldBranch(branch)) {
+    if (hasRedPhaseBranchInContext(branch)) {
+      if (maybeSkipForRedPhase("context", branch)) {
+        process.exit(0);
+      }
+    }
+  }
+  if (options.force) {
+    log(`${COLORS.yellow}Force flag set${COLORS.reset} - skipping strict verification`);
+    process.exit(0);
+  }
+  const plan = createVerificationPlan(readPackageScripts());
+  if (!plan.ok) {
+    log(`${COLORS.red}Strict pre-push verification is not configured${COLORS.reset}`);
+    log(plan.error);
+    log("");
+    log("Add one of:");
+    log("  - verify:ci");
+    log("  - typecheck + (check or lint) + build + test");
+    process.exit(1);
+  }
+  log(`Running strict verification for branch: ${COLORS.blue}${branch}${COLORS.reset}`);
+  if (plan.source === "verify:ci") {
+    log("Using `verify:ci` script.");
+  } else {
+    log(`Using fallback scripts: ${plan.scripts.join(" -> ")}`);
+  }
+  for (const scriptName of plan.scripts) {
+    if (runScript(scriptName)) {
+      continue;
+    }
+    log("");
+    log(`${COLORS.red}Verification failed${COLORS.reset} on script: ${scriptName}`);
+    log("");
+    log("If this is intentional TDD RED phase work, name your branch:");
+    log("  - feature-tests");
+    log("  - feature/tests");
+    log("  - feature_tests");
+    process.exit(1);
+  }
+  log("");
+  log(`${COLORS.green}Strict verification passed${COLORS.reset}`);
+  process.exit(0);
+}
+
+export { isRedPhaseBranch, isScaffoldBranch, isTestOnlyPath, areFilesTestOnly, canBypassRedPhaseByChangedFiles, createVerificationPlan, runPrePush };

package/dist/shared/@outfitter/{tooling-s4eqq91d.js → tooling-9errkcvk.js}

@@ -9,7 +9,8 @@ function buildFixCommand(options) {
 }
 async function runFix(paths = []) {
   const cmd = buildFixCommand({ paths });
-  console.log(`Running: bun x ${cmd.join(" ")}`);
+  process.stdout.write(`Running: bun x ${cmd.join(" ")}
+`);
   const proc = Bun.spawn(["bun", "x", ...cmd], {
     stdio: ["inherit", "inherit", "inherit"]
   });

package/dist/shared/@outfitter/{tooling-75j500dv.js → tooling-9yzd08v1.js}

@@ -10,16 +10,20 @@ var COLORS = {
   blue: "\x1B[34m"
 };
 function log(msg) {
-  console.log(msg);
+  process.stdout.write(`${msg}
+`);
 }
 function info(msg) {
-  console.log(`${COLORS.blue}\u25B8${COLORS.reset} ${msg}`);
+  process.stdout.write(`${COLORS.blue}\u25B8${COLORS.reset} ${msg}
+`);
 }
 function success(msg) {
-  console.log(`${COLORS.green}\u2713${COLORS.reset} ${msg}`);
+  process.stdout.write(`${COLORS.green}\u2713${COLORS.reset} ${msg}
+`);
 }
 function warn(msg) {
-  console.log(`${COLORS.yellow}!${COLORS.reset} ${msg}`);
+  process.stdout.write(`${COLORS.yellow}!${COLORS.reset} ${msg}
+`);
 }
 async function fetchLatestVersion() {
   const response = await fetch("https://api.github.com/repos/oven-sh/bun/releases/latest");
@@ -91,13 +95,13 @@ async function runUpgradeBun(targetVersion, options = {}) {
   info("Updating engines.bun...");
   for (const file of packageFiles) {
     if (updateEnginesBun(file, version)) {
-      log(`  ${file.replace(cwd + "/", "")}`);
+      log(`  ${file.replace(`${cwd}/`, "")}`);
     }
   }
   info("Updating @types/bun...");
   for (const file of packageFiles) {
     if (updateTypesBun(file, version)) {
-      log(`  ${file.replace(cwd + "/", "")}`);
+      log(`  ${file.replace(`${cwd}/`, "")}`);
     }
   }
   if (options.install !== false) {

package/dist/shared/@outfitter/{tooling-xaxdr9da.js → tooling-mxwc1n8w.js}

@@ -29,7 +29,15 @@ function detectFrameworks(pkg) {
   return ["--frameworks", ...detected];
 }
 function buildUltraciteCommand(options) {
-  const cmd = ["ultracite", "init", "--linter", "biome", "--pm", "bun", "--quiet"];
+  const cmd = [
+    "ultracite",
+    "init",
+    "--linter",
+    "biome",
+    "--pm",
+    "bun",
+    "--quiet"
+  ];
   if (options.frameworks && options.frameworks.length > 0) {
     cmd.push("--frameworks", ...options.frameworks);
   }
@@ -39,14 +47,16 @@ async function runInit(cwd = process.cwd()) {
   const pkgPath = `${cwd}/package.json`;
   const pkgFile = Bun.file(pkgPath);
   if (!await pkgFile.exists()) {
-    console.error("No package.json found in current directory");
+    process.stderr.write(`No package.json found in current directory
+`);
     process.exit(1);
   }
   const pkg = await pkgFile.json();
   const frameworkFlags = detectFrameworks(pkg);
   const frameworks = frameworkFlags.length > 0 ? frameworkFlags.slice(1) : [];
   const cmd = buildUltraciteCommand({ frameworks });
-  console.log(`Running: bun x ${cmd.join(" ")}`);
+  process.stdout.write(`Running: bun x ${cmd.join(" ")}
+`);
   const proc = Bun.spawn(["bun", "x", ...cmd], {
     cwd,
     stdio: ["inherit", "inherit", "inherit"]

package/lefthook.yml

@@ -20,11 +20,9 @@ pre-commit:
 pre-push:
   parallel: false
   commands:
-    build:
-      run: bun run build
-
-    test:
-      # TDD-aware: skips tests on RED phase branches (*-tests, */tests, *_tests)
-      # Override with `run: bun run test` if you don't want TDD support
-      # Requires: @outfitter/tooling must be a devDependency in your project
+    verify:
+      # TDD-aware: skips strict verification on explicit RED phase branches
+      # (*-tests, */tests, *_tests). Otherwise runs verify:ci (or a strict
+      # fallback: typecheck/check-or-lint/build/test).
+      # Requires: @outfitter/tooling as a dev dependency.
       run: bunx @outfitter/tooling pre-push

package/package.json

@@ -1,116 +1,123 @@
 {
-  "name": "@outfitter/tooling",
-  "description": "Dev tooling configuration presets for Outfitter projects (biome, typescript, lefthook, markdownlint)",
-  "version": "0.2.0",
-  "type": "module",
-  "files": [
-    "dist",
-    "registry",
-    "biome.json",
-    "tsconfig.preset.json",
-    "tsconfig.preset.bun.json",
-    "lefthook.yml",
-    ".markdownlint-cli2.jsonc"
-  ],
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      }
-    },
-    "./registry": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      }
-    },
-    "./cli/init": {
-      "import": {
-        "types": "./dist/cli/init.d.ts",
-        "default": "./dist/cli/init.js"
-      }
-    },
-    "./cli/fix": {
-      "import": {
-        "types": "./dist/cli/fix.d.ts",
-        "default": "./dist/cli/fix.js"
-      }
-    },
-    "./cli/check": {
-      "import": {
-        "types": "./dist/cli/check.d.ts",
-        "default": "./dist/cli/check.js"
-      }
-    },
-    "./package.json": "./package.json",
-    "./biome.json": "./biome.json",
-    "./tsconfig.preset.json": "./tsconfig.preset.json",
-    "./tsconfig.preset.bun.json": "./tsconfig.preset.bun.json",
-    "./lefthook.yml": "./lefthook.yml",
-    "./.markdownlint-cli2.jsonc": "./.markdownlint-cli2.jsonc"
-  },
-  "bin": {
-    "tooling": "./dist/cli/index.js"
-  },
-  "sideEffects": false,
-  "scripts": {
-    "build:registry": "bun run src/registry/build.ts",
-    "prebuild": "bun run build:registry",
-    "build": "bunup --filter @outfitter/tooling",
-    "lint": "biome lint ./src",
-    "lint:fix": "biome lint --write ./src",
-    "test": "bun test",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist registry"
-  },
-  "dependencies": {
-    "commander": "^14.0.2",
-    "zod": "^3.25.17"
-  },
-  "devDependencies": {
-    "@types/bun": "^1.3.7",
-    "typescript": "^5.9.3",
-    "yaml": "^2.8.2"
-  },
-  "peerDependencies": {
-    "ultracite": "^7.0.0",
-    "lefthook": "^2.0.0",
-    "markdownlint-cli2": ">=0.17.0"
-  },
-  "peerDependenciesMeta": {
-    "ultracite": {
-      "optional": true
-    },
-    "lefthook": {
-      "optional": true
-    },
-    "markdownlint-cli2": {
-      "optional": true
-    }
-  },
-  "engines": {
-    "bun": ">=1.3.7"
-  },
-  "keywords": [
-    "outfitter",
-    "tooling",
-    "biome",
-    "typescript",
-    "lefthook",
-    "markdownlint",
-    "config",
-    "presets"
-  ],
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/outfitter-dev/outfitter.git",
-    "directory": "packages/tooling"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
+	"name": "@outfitter/tooling",
+	"description": "Dev tooling configuration presets for Outfitter projects (biome, typescript, lefthook, markdownlint)",
+	"version": "0.2.2",
+	"type": "module",
+	"files": [
+		"dist",
+		"registry",
+		"biome.json",
+		"tsconfig.preset.json",
+		"tsconfig.preset.bun.json",
+		"lefthook.yml",
+		".markdownlint-cli2.jsonc"
+	],
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"import": {
+				"types": "./dist/index.d.ts",
+				"default": "./dist/index.js"
+			}
+		},
+		"./registry": {
+			"import": {
+				"types": "./dist/index.d.ts",
+				"default": "./dist/index.js"
+			}
+		},
+		"./cli/init": {
+			"import": {
+				"types": "./dist/cli/init.d.ts",
+				"default": "./dist/cli/init.js"
+			}
+		},
+		"./cli/fix": {
+			"import": {
+				"types": "./dist/cli/fix.d.ts",
+				"default": "./dist/cli/fix.js"
+			}
+		},
+		"./cli/check": {
+			"import": {
+				"types": "./dist/cli/check.d.ts",
+				"default": "./dist/cli/check.js"
+			}
+		},
+		"./package.json": "./package.json",
+		"./biome": "./biome.json",
+		"./biome.json": "./biome.json",
+		"./tsconfig": "./tsconfig.preset.json",
+		"./tsconfig.preset.json": "./tsconfig.preset.json",
+		"./tsconfig-bun": "./tsconfig.preset.bun.json",
+		"./tsconfig.preset.bun.json": "./tsconfig.preset.bun.json",
+		"./lefthook": "./lefthook.yml",
+		"./lefthook.yml": "./lefthook.yml",
+		"./.markdownlint-cli2": "./.markdownlint-cli2.jsonc",
+		"./.markdownlint-cli2.jsonc": "./.markdownlint-cli2.jsonc"
+	},
+	"bin": {
+		"tooling": "./dist/cli/index.js"
+	},
+	"sideEffects": false,
+	"scripts": {
+		"build:registry": "bun run src/registry/build.ts",
+		"sync:exports": "bun run scripts/sync-exports.ts",
+		"prebuild": "bun run build:registry && bun run sync:exports",
+		"build": "bunup --filter @outfitter/tooling",
+		"prepack": "bun run sync:exports",
+		"lint": "biome lint ./src",
+		"lint:fix": "biome lint --write ./src",
+		"test": "bun test",
+		"typecheck": "tsc --noEmit",
+		"clean": "rm -rf dist registry"
+	},
+	"dependencies": {
+		"commander": "^14.0.2",
+		"zod": "^3.25.17"
+	},
+	"devDependencies": {
+		"@types/bun": "^1.3.7",
+		"typescript": "^5.9.3",
+		"yaml": "^2.8.2"
+	},
+	"peerDependencies": {
+		"ultracite": "^7.0.0",
+		"lefthook": "^2.0.0",
+		"markdownlint-cli2": ">=0.17.0"
+	},
+	"peerDependenciesMeta": {
+		"ultracite": {
+			"optional": true
+		},
+		"lefthook": {
+			"optional": true
+		},
+		"markdownlint-cli2": {
+			"optional": true
+		}
+	},
+	"engines": {
+		"bun": ">=1.3.7"
+	},
+	"keywords": [
+		"outfitter",
+		"tooling",
+		"biome",
+		"typescript",
+		"lefthook",
+		"markdownlint",
+		"config",
+		"presets"
+	],
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/outfitter-dev/outfitter.git",
+		"directory": "packages/tooling"
+	},
+	"publishConfig": {
+		"access": "public"
+	}
 }