@outfitter/tooling 0.2.0

package/.markdownlint-cli2.jsonc

@@ -0,0 +1,66 @@
+{
+  // Outfitter markdownlint preset
+  // https://github.com/DavidAnson/markdownlint
+
+  "config": {
+    // Headings
+    "MD003": { "style": "atx" },           // ATX-style headings (# Heading)
+    "MD022": { "lines_above": 1, "lines_below": 1 }, // Blank lines around headings
+    "MD024": { "siblings_only": true },    // Allow duplicate headings in different sections
+    "MD041": false,                         // First line doesn't need to be h1 (frontmatter, etc.)
+
+    // Line length - disabled for prose flexibility
+    "MD013": false,
+
+    // Lists
+    "MD004": { "style": "dash" },           // Unordered list style: dash (-)
+    "MD007": { "indent": 2 },               // List indentation: 2 spaces
+    "MD032": true,                          // Blank lines around lists
+
+    // Code blocks
+    "MD040": true,                          // Fenced code blocks should have a language
+    "MD046": { "style": "fenced" },         // Code block style: fenced (```)
+    "MD048": { "style": "backtick" },       // Code fence style: backticks
+
+    // Links
+    "MD034": true,                          // No bare URLs (use <url> or [text](url))
+
+    // Whitespace
+    "MD009": { "br_spaces": 2 },            // Allow 2 trailing spaces for <br>
+    "MD010": { "spaces_per_tab": 2 },       // Tabs to spaces
+    "MD012": { "maximum": 1 },              // Max 1 consecutive blank line
+    "MD047": true,                          // Files should end with newline
+
+    // HTML - allow for GitHub-specific elements
+    "MD033": {
+      "allowed_elements": [
+        "details",
+        "summary",
+        "kbd",
+        "br",
+        "sup",
+        "sub",
+        "img",
+        "picture",
+        "source",
+        "a"
+      ]
+    },
+
+    // Emphasis
+    "MD049": { "style": "asterisk" },       // Emphasis style: *italic*
+    "MD050": { "style": "asterisk" }        // Strong style: **bold**
+  },
+
+  // Ignore patterns
+  "ignores": [
+    "node_modules/**",
+    "**/node_modules/**",
+    "dist/**",
+    "**/dist/**",
+    ".turbo/**",
+    "**/.turbo/**",
+    "CHANGELOG.md",
+    "**/CHANGELOG.md"
+  ]
+}

package/README.md

@@ -0,0 +1,168 @@
+# @outfitter/tooling
+
+Dev tooling configuration presets and CLI for Outfitter projects.
+
+## Features
+
+- **Configuration Presets**: Biome, TypeScript, Lefthook, and markdownlint configs
+- **CLI Commands**: Initialize configs, upgrade Bun, TDD-aware pre-push hooks
+- **Registry System**: Composable config blocks for scaffolding
+
+## Installation
+
+```bash
+bun add -D @outfitter/tooling
+```
+
+Peer dependencies (optional):
+- `ultracite` — Biome wrapper for formatting/linting
+- `lefthook` — Git hooks
+- `markdownlint-cli2` — Markdown linting
+
+## CLI Commands
+
+### `tooling init`
+
+Initialize tooling configuration in the current project. Copies preset configs for Biome, TypeScript, Lefthook, and markdownlint.
+
+```bash
+bunx @outfitter/tooling init
+```
+
+### `tooling check [paths...]`
+
+Run linting checks (wraps ultracite).
+
+```bash
+bunx @outfitter/tooling check
+bunx @outfitter/tooling check src/
+```
+
+### `tooling fix [paths...]`
+
+Fix linting issues (wraps ultracite).
+
+```bash
+bunx @outfitter/tooling fix
+bunx @outfitter/tooling fix src/
+```
+
+### `tooling upgrade-bun [version]`
+
+Upgrade Bun version across the project. Updates:
+- `.bun-version`
+- `engines.bun` in all package.json files
+- `@types/bun` dependency versions (leaves "latest" alone)
+- `bun.lock`
+
+```bash
+# Upgrade to latest
+bunx @outfitter/tooling upgrade-bun
+
+# Upgrade to specific version
+bunx @outfitter/tooling upgrade-bun 1.4.0
+
+# Skip installing Bun and updating lockfile
+bunx @outfitter/tooling upgrade-bun 1.4.0 --no-install
+```
+
+### `tooling pre-push`
+
+TDD-aware pre-push test hook. Detects RED phase branches and skips tests by design.
+
+RED phase branches follow these patterns:
+- `*-tests` (e.g., `feature/auth-tests`)
+- `*/tests` (e.g., `feature/auth/tests`)
+- `*_tests` (e.g., `feature/auth_tests`)
+
+```bash
+# Normal usage (in lefthook.yml)
+bunx @outfitter/tooling pre-push
+
+# Force skip tests
+bunx @outfitter/tooling pre-push --force
+```
+
+## Configuration Presets
+
+### Biome
+
+Extends our Biome config in your `biome.json`:
+
+```json
+{
+  "extends": ["@outfitter/tooling/biome.json"]
+}
+```
+
+### TypeScript
+
+Extends our TypeScript config in your `tsconfig.json`:
+
+```json
+{
+  "extends": "@outfitter/tooling/tsconfig.preset.json"
+}
+```
+
+Or for Bun-specific projects:
+
+```json
+{
+  "extends": "@outfitter/tooling/tsconfig.preset.bun.json"
+}
+```
+
+### Lefthook
+
+Extends our git hooks in your `.lefthook.yml`:
+
+```yaml
+extends:
+  - node_modules/@outfitter/tooling/lefthook.yml
+```
+
+Default hooks:
+- **pre-commit**: Runs ultracite on staged files, typechecks
+- **pre-push**: Runs build, then TDD-aware tests via `tooling pre-push`
+
+### markdownlint
+
+Copy or reference the config:
+
+```bash
+# Copy to project
+cp node_modules/@outfitter/tooling/.markdownlint-cli2.jsonc .
+```
+
+## Registry System
+
+The tooling package includes a registry of composable config blocks for the `outfitter` CLI scaffolding system.
+
+Available blocks:
+- `claude` — Claude Code settings and hooks
+- `biome` — Biome/Ultracite configuration
+- `lefthook` — Git hooks configuration
+- `markdownlint` — Markdown linting configuration
+- `bootstrap` — Project bootstrap script
+- `scaffolding` — Full starter kit (combines all above)
+
+## Exports
+
+| Export | Description |
+|--------|-------------|
+| `./biome.json` | Biome configuration preset |
+| `./tsconfig.preset.json` | TypeScript preset (general) |
+| `./tsconfig.preset.bun.json` | TypeScript preset (Bun) |
+| `./lefthook.yml` | Lefthook hooks configuration |
+| `./.markdownlint-cli2.jsonc` | markdownlint configuration |
+
+## Related
+
+- [@outfitter/contracts](../contracts/README.md) — Result types and error patterns
+- [@outfitter/cli](../cli/README.md) — CLI framework
+- [@outfitter/kit](../kit/README.md) — Version coordination
+
+## License
+
+MIT

package/biome.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+  "root": false,
+  "javascript": {
+    "globals": ["Bun"]
+  },
+  "linter": {
+    "rules": {
+      "complexity": {
+        "useLiteralKeys": "off",
+        "noVoid": "off",
+        "noExcessiveCognitiveComplexity": "off"
+      },
+      "performance": {
+        "useTopLevelRegex": "off"
+      },
+      "style": {
+        "useBlockStatements": "off"
+      },
+      "suspicious": {
+        "noConsole": "error"
+      }
+    }
+  },
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "files": {
+    "ignoreUnknown": true,
+    "includes": ["!**/node_modules", "!**/dist", "!**/.turbo", "!**/*.gen.ts"]
+  },
+  "overrides": [
+    {
+      "includes": ["packages/*/src/index.ts", "apps/*/src/index.ts", "**/index.ts"],
+      "linter": {
+        "rules": {
+          "performance": {
+            "noBarrelFile": "off"
+          }
+        }
+      }
+    },
+    {
+      "includes": ["**/*.test.ts", "**/__tests__/**/*"],
+      "linter": {
+        "rules": {
+          "suspicious": {
+            "useAwait": "off",
+            "noConsole": "off"
+          },
+          "performance": {
+            "noDelete": "off"
+          }
+        }
+      }
+    },
+    {
+      "includes": [
+        "apps/**/*.ts",
+        "scripts/**/*.ts",
+        "**/scripts/**/*.ts"
+      ],
+      "linter": {
+        "rules": {
+          "suspicious": {
+            "noConsole": "off"
+          }
+        }
+      }
+    }
+  ]
+}

package/dist/cli/check.d.ts

@@ -0,0 +1,19 @@
+/**
+* CLI check command - Run linting checks (wraps ultracite)
+*/
+/** Options for the check command */
+interface CheckOptions {
+	paths?: string[];
+}
+/**
+* Build the ultracite check command
+* @param options - Command options
+* @returns Array of command arguments
+*/
+declare function buildCheckCommand(options: CheckOptions): string[];
+/**
+* Run the check command
+* @param paths - Paths to check
+*/
+declare function runCheck(paths?: string[]): Promise<void>;
+export { runCheck, buildCheckCommand };

package/dist/cli/check.js

@@ -0,0 +1,9 @@
+// @bun
+import {
+  buildCheckCommand,
+  runCheck
+} from "../shared/@outfitter/tooling-xx1146e3.js";
+export {
+  runCheck,
+  buildCheckCommand
+};

package/dist/cli/fix.d.ts

@@ -0,0 +1,19 @@
+/**
+* CLI fix command - Fix linting issues (wraps ultracite)
+*/
+/** Options for the fix command */
+interface FixOptions {
+	paths?: string[];
+}
+/**
+* Build the ultracite fix command
+* @param options - Command options
+* @returns Array of command arguments
+*/
+declare function buildFixCommand(options: FixOptions): string[];
+/**
+* Run the fix command
+* @param paths - Paths to fix
+*/
+declare function runFix(paths?: string[]): Promise<void>;
+export { runFix, buildFixCommand };

package/dist/cli/fix.js

@@ -0,0 +1,9 @@
+// @bun
+import {
+  buildFixCommand,
+  runFix
+} from "../shared/@outfitter/tooling-s4eqq91d.js";
+export {
+  runFix,
+  buildFixCommand
+};