@outfitter/tooling 0.2.0

package/dist/cli/index.js

@@ -0,0 +1,353 @@
+#!/usr/bin/env bun
+
+// src/cli/index.ts
+import { Command } from "commander";
+
+// src/cli/check.ts
+function buildCheckCommand(options) {
+  const cmd = ["ultracite", "check"];
+  if (options.paths && options.paths.length > 0) {
+    cmd.push(...options.paths);
+  }
+  return cmd;
+}
+async function runCheck(paths = []) {
+  const cmd = buildCheckCommand({ paths });
+  console.log(`Running: bun x ${cmd.join(" ")}`);
+  const proc = Bun.spawn(["bun", "x", ...cmd], {
+    stdio: ["inherit", "inherit", "inherit"]
+  });
+  const exitCode = await proc.exited;
+  process.exit(exitCode);
+}
+
+// src/cli/fix.ts
+function buildFixCommand(options) {
+  const cmd = ["ultracite", "fix"];
+  if (options.paths && options.paths.length > 0) {
+    cmd.push(...options.paths);
+  }
+  return cmd;
+}
+async function runFix(paths = []) {
+  const cmd = buildFixCommand({ paths });
+  console.log(`Running: bun x ${cmd.join(" ")}`);
+  const proc = Bun.spawn(["bun", "x", ...cmd], {
+    stdio: ["inherit", "inherit", "inherit"]
+  });
+  const exitCode = await proc.exited;
+  process.exit(exitCode);
+}
+
+// src/cli/init.ts
+var FRAMEWORK_DETECTORS = {
+  react: ["react", "react-dom"],
+  next: ["next"],
+  vue: ["vue"],
+  nuxt: ["nuxt"],
+  svelte: ["svelte"],
+  angular: ["@angular/core"],
+  solid: ["solid-js"],
+  astro: ["astro"],
+  remix: ["@remix-run/react"],
+  qwik: ["@builder.io/qwik"]
+};
+function detectFrameworks(pkg) {
+  const allDeps = {
+    ...pkg.dependencies,
+    ...pkg.devDependencies
+  };
+  const detected = [];
+  for (const [framework, packages] of Object.entries(FRAMEWORK_DETECTORS)) {
+    if (packages.some((p) => (p in allDeps))) {
+      detected.push(framework);
+    }
+  }
+  if (detected.length === 0) {
+    return [];
+  }
+  return ["--frameworks", ...detected];
+}
+function buildUltraciteCommand(options) {
+  const cmd = ["ultracite", "init", "--linter", "biome", "--pm", "bun", "--quiet"];
+  if (options.frameworks && options.frameworks.length > 0) {
+    cmd.push("--frameworks", ...options.frameworks);
+  }
+  return cmd;
+}
+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.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(" ")}`);
+  const proc = Bun.spawn(["bun", "x", ...cmd], {
+    cwd,
+    stdio: ["inherit", "inherit", "inherit"]
+  });
+  const exitCode = await proc.exited;
+  process.exit(exitCode);
+}
+
+// src/cli/pre-push.ts
+var COLORS = {
+  reset: "\x1B[0m",
+  red: "\x1B[31m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  blue: "\x1B[34m"
+};
+function log(msg) {
+  console.log(msg);
+}
+function getCurrentBranch() {
+  const result = Bun.spawnSync(["git", "rev-parse", "--abbrev-ref", "HEAD"]);
+  return result.stdout.toString().trim();
+}
+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");
+}
+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(/^[│├└─◉◯ ]*/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 runTests() {
+  log("");
+  const result = Bun.spawnSync(["bun", "run", "test"], {
+    stdio: ["inherit", "inherit", "inherit"]
+  });
+  return result.exitCode === 0;
+}
+async function runPrePush(options = {}) {
+  log(`${COLORS.blue}Pre-push test${COLORS.reset} (TDD-aware)`);
+  log("");
+  const branch = getCurrentBranch();
+  if (isRedPhaseBranch(branch)) {
+    log(`${COLORS.yellow}TDD RED phase${COLORS.reset} detected: ${COLORS.blue}${branch}${COLORS.reset}`);
+    log(`${COLORS.yellow}Skipping test execution${COLORS.reset} - tests are expected to fail in RED phase`);
+    log("");
+    log("Remember: GREEN phase (implementation) must make these tests pass!");
+    process.exit(0);
+  }
+  if (isScaffoldBranch(branch)) {
+    if (hasRedPhaseBranchInContext(branch)) {
+      log(`${COLORS.yellow}Scaffold branch${COLORS.reset} with RED phase branch in context: ${COLORS.blue}${branch}${COLORS.reset}`);
+      log(`${COLORS.yellow}Skipping test execution${COLORS.reset} - RED phase tests expected to fail`);
+      log("");
+      process.exit(0);
+    }
+  }
+  if (options.force) {
+    log(`${COLORS.yellow}Force flag set${COLORS.reset} - skipping tests`);
+    process.exit(0);
+  }
+  log(`Running tests for branch: ${COLORS.blue}${branch}${COLORS.reset}`);
+  if (runTests()) {
+    log("");
+    log(`${COLORS.green}All tests passed${COLORS.reset}`);
+    process.exit(0);
+  } else {
+    log("");
+    log(`${COLORS.red}Tests failed${COLORS.reset}`);
+    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);
+  }
+}
+
+// src/cli/upgrade-bun.ts
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+var COLORS2 = {
+  reset: "\x1B[0m",
+  red: "\x1B[31m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  blue: "\x1B[34m"
+};
+function log2(msg) {
+  console.log(msg);
+}
+function info(msg) {
+  console.log(`${COLORS2.blue}▸${COLORS2.reset} ${msg}`);
+}
+function success(msg) {
+  console.log(`${COLORS2.green}✓${COLORS2.reset} ${msg}`);
+}
+function warn(msg) {
+  console.log(`${COLORS2.yellow}!${COLORS2.reset} ${msg}`);
+}
+async function fetchLatestVersion() {
+  const response = await fetch("https://api.github.com/repos/oven-sh/bun/releases/latest");
+  const data = await response.json();
+  const match = data.tag_name.match(/bun-v(.+)/);
+  if (!match?.[1]) {
+    throw new Error(`Could not parse version from tag: ${data.tag_name}`);
+  }
+  return match[1];
+}
+function findPackageJsonFiles(dir) {
+  const results = [];
+  const glob = new Bun.Glob("**/package.json");
+  for (const path of glob.scanSync({ cwd: dir })) {
+    if (!path.includes("node_modules")) {
+      results.push(join(dir, path));
+    }
+  }
+  return results;
+}
+function updateEnginesBun(filePath, version) {
+  const content = readFileSync(filePath, "utf-8");
+  const pattern = /"bun":\s*">=[\d.]+"/;
+  if (!pattern.test(content)) {
+    return false;
+  }
+  const updated = content.replace(pattern, `"bun": ">=${version}"`);
+  if (updated !== content) {
+    writeFileSync(filePath, updated);
+    return true;
+  }
+  return false;
+}
+function updateTypesBun(filePath, version) {
+  const content = readFileSync(filePath, "utf-8");
+  const pattern = /"@types\/bun":\s*"\^[\d.]+"/;
+  if (!pattern.test(content)) {
+    return false;
+  }
+  const updated = content.replace(pattern, `"@types/bun": "^${version}"`);
+  if (updated !== content) {
+    writeFileSync(filePath, updated);
+    return true;
+  }
+  return false;
+}
+async function runUpgradeBun(targetVersion, options = {}) {
+  const cwd = process.cwd();
+  const bunVersionFile = join(cwd, ".bun-version");
+  let version = targetVersion;
+  if (!version) {
+    info("Fetching latest Bun version...");
+    version = await fetchLatestVersion();
+    log2(`Latest version: ${version}`);
+  }
+  const currentVersion = existsSync(bunVersionFile) ? readFileSync(bunVersionFile, "utf-8").trim() : "unknown";
+  log2(`Current version: ${currentVersion}`);
+  if (currentVersion === version) {
+    success(`Already on version ${version}`);
+    return;
+  }
+  log2("");
+  info(`Upgrading Bun: ${currentVersion} → ${version}`);
+  log2("");
+  writeFileSync(bunVersionFile, `${version}
+`);
+  success("Updated .bun-version");
+  const packageFiles = findPackageJsonFiles(cwd);
+  info("Updating engines.bun...");
+  for (const file of packageFiles) {
+    if (updateEnginesBun(file, version)) {
+      log2(`  ${file.replace(cwd + "/", "")}`);
+    }
+  }
+  info("Updating @types/bun...");
+  for (const file of packageFiles) {
+    if (updateTypesBun(file, version)) {
+      log2(`  ${file.replace(cwd + "/", "")}`);
+    }
+  }
+  if (options.install !== false) {
+    log2("");
+    info(`Installing Bun ${version}...`);
+    const installResult = Bun.spawnSync([
+      "bash",
+      "-c",
+      `curl -fsSL https://bun.sh/install | bash -s "bun-v${version}"`
+    ]);
+    if (installResult.exitCode !== 0) {
+      warn("Could not install Bun automatically");
+      log2("Install manually: curl -fsSL https://bun.sh/install | bash");
+    } else {
+      success(`Bun ${version} installed`);
+      log2("");
+      info("Updating lockfile...");
+      const bunInstall = Bun.spawnSync(["bun", "install"], {
+        cwd,
+        env: {
+          ...process.env,
+          BUN_INSTALL: `${process.env["HOME"]}/.bun`,
+          PATH: `${process.env["HOME"]}/.bun/bin:${process.env["PATH"]}`
+        }
+      });
+      if (bunInstall.exitCode === 0) {
+        success("Lockfile updated");
+      } else {
+        warn("Could not update lockfile - run 'bun install' manually");
+      }
+    }
+  }
+  log2("");
+  success("Done! Changes ready to commit:");
+  log2("  - .bun-version");
+  log2("  - package.json files (engines.bun, @types/bun)");
+  log2("  - bun.lock");
+  log2("");
+  log2(`Commit with: git add -A && git commit -m 'chore: upgrade Bun to ${version}'`);
+}
+
+// src/cli/index.ts
+var program = new Command;
+program.name("tooling").description("Dev tooling configuration management for Outfitter projects").version("0.1.0-rc.1");
+program.command("init").description("Initialize tooling config in the current project").action(async () => {
+  await runInit();
+});
+program.command("check").description("Run linting checks (wraps ultracite)").argument("[paths...]", "Paths to check").action(async (paths) => {
+  await runCheck(paths);
+});
+program.command("fix").description("Fix linting issues (wraps ultracite)").argument("[paths...]", "Paths to fix").action(async (paths) => {
+  await runFix(paths);
+});
+program.command("upgrade-bun").description("Upgrade Bun version across the project").argument("[version]", "Target version (defaults to latest)").option("--no-install", "Skip installing Bun and updating lockfile").action(async (version, options) => {
+  await runUpgradeBun(version, options);
+});
+program.command("pre-push").description("TDD-aware pre-push test hook").option("-f, --force", "Skip tests entirely").action(async (options) => {
+  await runPrePush(options);
+});
+program.parse();

package/dist/cli/init.d.ts

@@ -0,0 +1,31 @@
+/**
+* CLI init command - Initialize tooling config in a project
+*/
+/** Package.json structure for framework detection */
+interface PackageJson {
+	dependencies?: Record<string, string>;
+	devDependencies?: Record<string, string>;
+}
+/** Options for building the ultracite command */
+interface UltraciteOptions {
+	frameworks?: string[];
+	quiet?: boolean;
+}
+/**
+* Detect frameworks from package.json dependencies
+* @param pkg - Package.json contents
+* @returns Array of CLI flags for detected frameworks
+*/
+declare function detectFrameworks(pkg: PackageJson): string[];
+/**
+* Build the ultracite init command with appropriate flags
+* @param options - Command options
+* @returns Array of command arguments
+*/
+declare function buildUltraciteCommand(options: UltraciteOptions): string[];
+/**
+* Run the init command
+* @param cwd - Working directory
+*/
+declare function runInit(cwd?: string): Promise<void>;
+export { runInit, detectFrameworks, buildUltraciteCommand };

package/dist/cli/init.js

@@ -0,0 +1,11 @@
+// @bun
+import {
+  buildUltraciteCommand,
+  detectFrameworks,
+  runInit
+} from "../shared/@outfitter/tooling-xaxdr9da.js";
+export {
+  runInit,
+  detectFrameworks,
+  buildUltraciteCommand
+};

package/dist/cli/pre-push.d.ts

@@ -0,0 +1,8 @@
+interface PrePushOptions {
+	force?: boolean;
+}
+/**
+* Main pre-push command
+*/
+declare function runPrePush(options?: PrePushOptions): Promise<void>;
+export { runPrePush, PrePushOptions };

package/dist/cli/pre-push.js

@@ -0,0 +1,7 @@
+// @bun
+import {
+  runPrePush
+} from "../shared/@outfitter/tooling-qm7jeg0d.js";
+export {
+  runPrePush
+};

package/dist/cli/upgrade-bun.d.ts

@@ -0,0 +1,8 @@
+interface UpgradeBunOptions {
+	install?: boolean;
+}
+/**
+* Main upgrade-bun command
+*/
+declare function runUpgradeBun(targetVersion?: string, options?: UpgradeBunOptions): Promise<void>;
+export { runUpgradeBun, UpgradeBunOptions };

package/dist/cli/upgrade-bun.js

@@ -0,0 +1,7 @@
+// @bun
+import {
+  runUpgradeBun
+} from "../shared/@outfitter/tooling-75j500dv.js";
+export {
+  runUpgradeBun
+};

package/dist/index.d.ts

@@ -0,0 +1,142 @@
+import { ZodType } from "zod";
+/**
+* File entry in a block.
+*/
+interface FileEntry {
+	/** Destination path relative to project root */
+	path: string;
+	/** File contents (embedded in registry) */
+	content: string;
+	/** Whether to chmod +x after copying */
+	executable?: boolean | undefined;
+	/** Whether to process as a template (future) */
+	template?: boolean | undefined;
+}
+/**
+* Schema for a file entry in a block.
+* Represents a file that will be copied to the user's project.
+*/
+declare const FileEntrySchema: ZodType<FileEntry>;
+/**
+* Block in the registry.
+*/
+interface Block {
+	/** Block name (matches the key in blocks record) */
+	name: string;
+	/** Human-readable description */
+	description: string;
+	/** Files included in this block */
+	files?: FileEntry[] | undefined;
+	/** npm dependencies to add to package.json */
+	dependencies?: Record<string, string> | undefined;
+	/** npm devDependencies to add to package.json */
+	devDependencies?: Record<string, string> | undefined;
+	/** Other blocks this block extends (for composite blocks) */
+	extends?: string[] | undefined;
+}
+/**
+* Schema for a block in the registry.
+* A block is a collection of related files that can be added together.
+*/
+declare const BlockSchema: ZodType<Block>;
+/**
+* Complete registry structure.
+*/
+interface Registry {
+	/** Registry schema version */
+	version: string;
+	/** Map of block name to block definition */
+	blocks: Record<string, Block>;
+}
+/**
+* Schema for the complete registry.
+* Contains all available blocks with their files and metadata.
+*/
+declare const RegistrySchema: ZodType<Registry>;
+/**
+* Block definition used in the build script.
+* Specifies how to collect source files into a block.
+*/
+interface BlockDefinition {
+	/** Human-readable description */
+	description: string;
+	/** Source file paths (relative to repo root) */
+	files?: string[];
+	/** Remap source paths to destination paths */
+	remap?: Record<string, string>;
+	/** npm dependencies */
+	dependencies?: Record<string, string>;
+	/** npm devDependencies */
+	devDependencies?: Record<string, string>;
+	/** Other blocks this block extends */
+	extends?: string[];
+}
+/**
+* Configuration for the registry build.
+*/
+interface RegistryBuildConfig {
+	/** Registry schema version */
+	version: string;
+	/** Block definitions */
+	blocks: Record<string, BlockDefinition>;
+}
+/**
+* Result of adding a block to a project.
+*/
+interface AddBlockResult {
+	/** Files that were created */
+	created: string[];
+	/** Files that were skipped (already exist) */
+	skipped: string[];
+	/** Files that were overwritten (with --force) */
+	overwritten: string[];
+	/** Dependencies added to package.json */
+	dependencies: Record<string, string>;
+	/** devDependencies added to package.json */
+	devDependencies: Record<string, string>;
+}
+/**
+* Options for the add command.
+*/
+interface AddBlockOptions {
+	/** Overwrite existing files */
+	force?: boolean;
+	/** Show what would be added without making changes */
+	dryRun?: boolean;
+	/** Working directory (defaults to cwd) */
+	cwd?: string;
+}
+/**
+* @outfitter/tooling
+*
+* Dev tooling configuration presets for Outfitter projects.
+* Provides standardized biome, TypeScript, lefthook, and markdownlint configurations.
+*
+* @example
+* ```json
+* // biome.json
+* {
+*   "extends": ["ultracite/biome/core", "@outfitter/tooling/biome.json"]
+* }
+* ```
+*
+* @example
+* ```json
+* // tsconfig.json
+* {
+*   "extends": "@outfitter/tooling/tsconfig.preset.bun.json"
+* }
+* ```
+*
+* @example
+* ```yaml
+* # .lefthook.yml
+* extends:
+*   - node_modules/@outfitter/tooling/lefthook.yml
+* ```
+*
+* @packageDocumentation
+*/
+/** Package version */
+declare const VERSION = "0.1.0-rc.1";
+export { VERSION, RegistrySchema, RegistryBuildConfig, Registry, FileEntrySchema, FileEntry, BlockSchema, BlockDefinition, Block, AddBlockResult, AddBlockOptions };

package/dist/index.js

@@ -0,0 +1,28 @@
+// src/registry/schema.ts
+import { z } from "zod";
+var FileEntrySchema = z.object({
+  path: z.string().min(1),
+  content: z.string(),
+  executable: z.boolean().optional(),
+  template: z.boolean().optional()
+});
+var BlockSchema = z.object({
+  name: z.string().min(1),
+  description: z.string().min(1),
+  files: z.array(FileEntrySchema).optional(),
+  dependencies: z.record(z.string()).optional(),
+  devDependencies: z.record(z.string()).optional(),
+  extends: z.array(z.string()).optional()
+});
+var RegistrySchema = z.object({
+  version: z.string(),
+  blocks: z.record(BlockSchema)
+});
+// src/index.ts
+var VERSION = "0.1.0-rc.1";
+export {
+  VERSION,
+  RegistrySchema,
+  FileEntrySchema,
+  BlockSchema
+};