@outfitter/tooling 0.3.3 → 0.3.5

package/.markdownlint-cli2.jsonc

@@ -1,66 +1,66 @@
 {
-	// Outfitter markdownlint preset
-	// https://github.com/DavidAnson/markdownlint
+  // 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.)
+  "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,
+    // 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
+    // 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
+    // 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))
+    // 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
+    // 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"
-			]
-		},
+    // 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**
-	},
+    // 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"
-	]
+  // Ignore patterns
+  "ignores": [
+    "node_modules/**",
+    "**/node_modules/**",
+    "dist/**",
+    "**/dist/**",
+    ".turbo/**",
+    "**/.turbo/**",
+    "CHANGELOG.md",
+    "**/CHANGELOG.md",
+  ],
 }

package/README.md

@@ -4,7 +4,7 @@ Dev tooling configuration presets and CLI for Outfitter projects.
 
 ## Features
 
-- **Configuration Presets**: Biome, TypeScript, Lefthook, and markdownlint configs
+- **Configuration Presets**: oxlint, TypeScript, Lefthook, and markdownlint configs
 - **CLI Commands**: Initialize configs, upgrade Bun, TDD-aware pre-push hooks
 - **Registry System**: Composable config blocks for scaffolding
 
@@ -15,7 +15,8 @@ bun add -D @outfitter/tooling
 ```
 
 Peer dependencies (optional):
-- `ultracite` — Biome wrapper for formatting/linting
+
+- `ultracite` — oxlint/oxfmt wrapper for formatting/linting
 - `lefthook` — Git hooks
 - `markdownlint-cli2` — Markdown linting
 
@@ -23,7 +24,7 @@ Peer dependencies (optional):
 
 ### `tooling init`
 
-Initialize tooling configuration in the current project. Copies preset configs for Biome, TypeScript, Lefthook, and markdownlint.
+Initialize tooling configuration in the current project. Copies preset configs for oxlint, TypeScript, Lefthook, and markdownlint.
 
 ```bash
 bunx @outfitter/tooling init
@@ -50,6 +51,7 @@ 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)
@@ -71,13 +73,16 @@ bunx @outfitter/tooling upgrade-bun 1.4.0 --no-install
 TDD-aware pre-push strict verification hook. Detects RED phase branches and skips verification 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`)
 
 Verification order:
-1. Run `verify:ci` if present.
-2. Otherwise run strict fallback: `typecheck`, `check|lint`, `build`, `test`.
+
+1. Run `verify:push` if present.
+2. Otherwise run `verify:ci` if present.
+3. Otherwise run strict fallback: `typecheck`, `check|lint`, `build`, `test`.
 
 ```bash
 # Normal usage (in lefthook.yml)
@@ -108,7 +113,15 @@ bunx @outfitter/tooling check-bunup-registry
 
 ### `tooling check-changeset`
 
-Validate that PRs touching package source include a changeset.
+Validate that release-relevant package changes in the current PR diff include a
+changeset.
+
+- In GitHub `pull_request` CI, the command diffs against the PR's current
+  `base.sha...head.sha` from the event payload. This keeps stacked PRs valid
+  after lower branches merge and Graphite retargets descendants.
+- Outside `pull_request` CI, it falls back to `origin/main...HEAD`.
+- Test-only package files are ignored: `src/__tests__/`, `src/__snapshots__/`,
+  `*.test.*`, and `*.spec.*`.
 
 ```bash
 bunx @outfitter/tooling check-changeset
@@ -169,16 +182,6 @@ bunx @outfitter/tooling check-readme-imports --json
 
 ## 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`:
@@ -207,6 +210,7 @@ extends:
 ```
 
 Default hooks:
+
 - **pre-commit**: Runs ultracite on staged files, typechecks
 - **pre-push**: Runs TDD-aware strict verification via `tooling pre-push`
 
@@ -224,8 +228,9 @@ cp node_modules/@outfitter/tooling/.markdownlint-cli2.jsonc .
 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
+- `linter` — oxlint/Ultracite configuration
 - `lefthook` — Git hooks configuration
 - `markdownlint` — Markdown linting configuration
 - `bootstrap` — Project bootstrap script
@@ -245,13 +250,17 @@ bun run apps/outfitter/src/cli.ts repo check boundary-invocations --cwd .
 
 ## 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 |
+| Export                       | Description                            |
+| ---------------------------- | -------------------------------------- |
+| `./registry`                 | Tooling block registry API             |
+| `./tsconfig`                 | Alias for `./tsconfig.preset.json`     |
+| `./tsconfig-bun`             | Alias for `./tsconfig.preset.bun.json` |
+| `./tsconfig.preset.json`     | TypeScript preset (general)            |
+| `./tsconfig.preset.bun.json` | TypeScript preset (Bun)                |
+| `./lefthook`                 | Alias for `./lefthook.yml`             |
+| `./lefthook.yml`             | Lefthook hooks configuration           |
+| `./.markdownlint-cli2`       | Alias for `./.markdownlint-cli2.jsonc` |
+| `./.markdownlint-cli2.jsonc` | markdownlint configuration             |
 
 ## Related
 

package/dist/bun-version-compat.d.ts

@@ -0,0 +1,2 @@
+import { ParsedSemver, isTypesBunVersionCompatible, parseSemver } from "./shared/@outfitter/tooling-vjmhvpjq.js";
+export { parseSemver, isTypesBunVersionCompatible, ParsedSemver };

package/dist/bun-version-compat.js

@@ -0,0 +1,10 @@
+// @bun
+import {
+  isTypesBunVersionCompatible,
+  parseSemver
+} from "./shared/@outfitter/tooling-mkynjra9.js";
+import"./shared/@outfitter/tooling-jnrs9rqd.js";
+export {
+  parseSemver,
+  isTypesBunVersionCompatible
+};

package/dist/cli/check-boundary-invocations.d.ts

@@ -0,0 +1,34 @@
+interface ScriptLocation {
+	readonly file: string;
+	readonly scriptName: string;
+	readonly command: string;
+}
+interface BoundaryViolation extends ScriptLocation {
+	readonly rule: "root-runs-package-src" | "cd-package-then-runs-src";
+}
+interface ReadScriptEntriesOptions {
+	readonly appManifestRelativePaths?: readonly string[];
+	readonly readPackageJson?: (filePath: string) => Promise<{
+		scripts?: Record<string, string>;
+	}>;
+}
+/**
+* Detect whether a single script command violates boundary invocation rules.
+*/
+declare function detectBoundaryViolation(location: ScriptLocation): BoundaryViolation | null;
+/**
+* Find all boundary violations across package/app script maps.
+*/
+declare function findBoundaryViolations(entries: readonly {
+	file: string;
+	scripts: Readonly<Record<string, string>>;
+}[]): BoundaryViolation[];
+declare function readScriptEntries(cwd: string, options?: ReadScriptEntriesOptions): Promise<{
+	file: string;
+	scripts: Record<string, string>;
+}[]>;
+/**
+* Run boundary invocation checks against root/apps package scripts.
+*/
+declare function runCheckBoundaryInvocations(): Promise<void>;
+export { runCheckBoundaryInvocations, readScriptEntries, findBoundaryViolations, detectBoundaryViolation, ScriptLocation, BoundaryViolation };

package/dist/cli/check-boundary-invocations.js

@@ -0,0 +1,14 @@
+// @bun
+import {
+  detectBoundaryViolation,
+  findBoundaryViolations,
+  readScriptEntries,
+  runCheckBoundaryInvocations
+} from "../shared/@outfitter/tooling-amrbp7cm.js";
+import"../shared/@outfitter/tooling-jnrs9rqd.js";
+export {
+  runCheckBoundaryInvocations,
+  readScriptEntries,
+  findBoundaryViolations,
+  detectBoundaryViolation
+};

package/dist/cli/check-bunup-registry.d.ts

@@ -0,0 +1,36 @@
+/** Result of checking bunup workspace registration */
+interface RegistryCheckResult {
+	readonly ok: boolean;
+	readonly missing: string[];
+}
+/**
+* Extract the package name from a build script containing `bunup --filter`.
+*
+* @example
+* extractBunupFilterName("bunup --filter @outfitter/logging")
+* // => "@outfitter/logging"
+*
+* extractBunupFilterName("cd ../.. && bunup --filter @outfitter/types")
+* // => "@outfitter/types"
+*
+* extractBunupFilterName("tsc --noEmit")
+* // => null
+*/
+declare function extractBunupFilterName(script: string): string | null;
+/**
+* Find packages that have `bunup --filter` build scripts but are not
+* registered in the bunup workspace config.
+*
+* @param packagesWithFilter - Package names that have `bunup --filter` in their build script
+* @param registeredNames - Package names registered in bunup.config.ts
+* @returns Result with sorted list of missing packages
+*/
+declare function findUnregisteredPackages(packagesWithFilter: string[], registeredNames: string[]): RegistryCheckResult;
+/**
+* Run bunup registry check across all workspace packages.
+*
+* Scans packages/*/package.json for build scripts containing `bunup --filter`,
+* then verifies each is registered in bunup.config.ts.
+*/
+declare function runCheckBunupRegistry(): Promise<void>;
+export { runCheckBunupRegistry, findUnregisteredPackages, extractBunupFilterName, RegistryCheckResult };

package/dist/cli/check-bunup-registry.js

@@ -0,0 +1,12 @@
+// @bun
+import {
+  extractBunupFilterName,
+  findUnregisteredPackages,
+  runCheckBunupRegistry
+} from "../shared/@outfitter/tooling-wwm97f47.js";
+import"../shared/@outfitter/tooling-jnrs9rqd.js";
+export {
+  runCheckBunupRegistry,
+  findUnregisteredPackages,
+  extractBunupFilterName
+};

package/dist/cli/check-changeset.d.ts

@@ -0,0 +1,82 @@
+/** Result of checking whether changesets are required */
+interface ChangesetCheckResult {
+	readonly ok: boolean;
+	readonly missingFor: string[];
+}
+interface ChangesetIgnoredReference {
+	readonly file: string;
+	readonly packages: string[];
+}
+interface GitDiffRange {
+	readonly base: string;
+	readonly head: string;
+	readonly label: string;
+	readonly source: "pull_request" | "default";
+}
+declare function getReleasableChangedPackages(changedPackages: readonly string[], ignoredPackages: readonly string[]): string[];
+/**
+* Extract unique package names from changed file paths.
+*
+* Only considers release-relevant files matching the pattern
+* "packages/NAME/src/...". Test-only sources are ignored so stacked follow-up
+* PRs do not need changesets for coverage-only edits.
+*
+* @param files - List of changed file paths relative to repo root
+* @returns Sorted array of unique package names
+*/
+declare function getChangedPackagePaths(files: string[]): string[];
+/**
+* Extract changeset filenames from changed file paths.
+*
+* Only considers files matching `.changeset/*.md`, excluding README.md.
+* This checks the git diff rather than disk, ensuring only changesets added
+* in the current PR are counted.
+*
+* @param files - List of changed file paths relative to repo root
+* @returns Array of changeset filenames (e.g. `["happy-turtle.md"]`)
+*/
+declare function getChangedChangesetFiles(files: string[]): string[];
+/**
+* Determine whether releasable packages are fully covered by the current PR changesets.
+*
+* Returns `ok: true` when either no releasable packages changed or every
+* releasable package is mentioned in at least one changed changeset file.
+* Returns `ok: false` with the list of uncovered releasable packages when
+* changeset coverage is incomplete.
+*
+* @param releasablePackages - Changed packages that are not ignored by changeset config
+* @param changesetFiles - Changeset filenames found in `.changeset/`
+* @param coveredPackages - Workspace package names referenced by the changed changesets
+*/
+declare function checkChangesetRequired(releasablePackages: string[], changesetFiles: string[], coveredPackages?: string[]): ChangesetCheckResult;
+declare function parseIgnoredPackagesFromChangesetConfig(jsonContent: string): string[];
+declare function parseChangesetFrontmatterPackageNames(markdownContent: string): string[];
+declare function resolveGitDiffRange(input: {
+	readonly eventName?: string | undefined;
+	readonly eventPath?: string | undefined;
+	readonly readEventFile?: ((path: string) => string) | undefined;
+}): GitDiffRange;
+declare function findIgnoredPackageReferences(input: {
+	readonly changesetFiles: readonly string[];
+	readonly ignoredPackages: readonly string[];
+	readonly readChangesetFile: (filename: string) => string;
+}): ChangesetIgnoredReference[];
+interface CheckChangesetOptions {
+	readonly skip?: boolean;
+}
+/**
+* Run check-changeset to verify release-relevant PR deltas include changeset files.
+*
+* Resolves the current diff range from pull request metadata in CI and falls
+* back to `origin/main...HEAD` elsewhere. Release-relevant package changes in
+* that diff must be covered by a current changeset.
+*
+* Skips silently when:
+* - `NO_CHANGESET=1` env var is set
+* - `--skip` flag is passed
+* - `GITHUB_EVENT_NAME=push` (post-merge on main)
+* - No packages have source changes
+* - Git diff fails (local dev without origin)
+*/
+declare function runCheckChangeset(options?: CheckChangesetOptions): Promise<void>;
+export { runCheckChangeset, resolveGitDiffRange, parseIgnoredPackagesFromChangesetConfig, parseChangesetFrontmatterPackageNames, getReleasableChangedPackages, getChangedPackagePaths, getChangedChangesetFiles, findIgnoredPackageReferences, checkChangesetRequired, GitDiffRange, CheckChangesetOptions, ChangesetIgnoredReference, ChangesetCheckResult };

package/dist/cli/check-changeset.js

@@ -0,0 +1,24 @@
+// @bun
+import {
+  checkChangesetRequired,
+  findIgnoredPackageReferences,
+  getChangedChangesetFiles,
+  getChangedPackagePaths,
+  getReleasableChangedPackages,
+  parseChangesetFrontmatterPackageNames,
+  parseIgnoredPackagesFromChangesetConfig,
+  resolveGitDiffRange,
+  runCheckChangeset
+} from "../shared/@outfitter/tooling-mq2xvz96.js";
+import"../shared/@outfitter/tooling-jnrs9rqd.js";
+export {
+  runCheckChangeset,
+  resolveGitDiffRange,
+  parseIgnoredPackagesFromChangesetConfig,
+  parseChangesetFrontmatterPackageNames,
+  getReleasableChangedPackages,
+  getChangedPackagePaths,
+  getChangedChangesetFiles,
+  findIgnoredPackageReferences,
+  checkChangesetRequired
+};

package/dist/cli/check-clean-tree.d.ts

@@ -0,0 +1,36 @@
+/**
+* Check-clean-tree command — asserts the working tree has no modified or untracked files.
+*
+* Pure core functions for parsing git output and determining tree cleanliness.
+* The CLI runner in {@link runCheckCleanTree} handles git invocation and output.
+*
+* @packageDocumentation
+*/
+/** Status of the working tree after verification steps */
+interface TreeStatus {
+	readonly clean: boolean;
+	readonly modified: string[];
+	readonly untracked: string[];
+}
+/**
+* Parse `git diff --name-only` output into a list of modified file paths.
+*/
+declare function parseGitDiff(diffOutput: string): string[];
+/**
+* Parse `git ls-files --others --exclude-standard` output into a list of untracked file paths.
+*/
+declare function parseUntrackedFiles(lsOutput: string): string[];
+/**
+* Determine if the tree status represents a clean working tree.
+*/
+declare function isCleanTree(status: TreeStatus): boolean;
+interface CheckCleanTreeOptions {
+	readonly paths?: string[];
+}
+/**
+* Run clean-tree check against the current working directory.
+*
+* Exits 0 if clean, 1 if dirty files are found.
+*/
+declare function runCheckCleanTree(options?: CheckCleanTreeOptions): Promise<void>;
+export { runCheckCleanTree, parseUntrackedFiles, parseGitDiff, isCleanTree, TreeStatus, CheckCleanTreeOptions };

package/dist/cli/check-clean-tree.js

@@ -0,0 +1,14 @@
+// @bun
+import {
+  isCleanTree,
+  parseGitDiff,
+  parseUntrackedFiles,
+  runCheckCleanTree
+} from "../shared/@outfitter/tooling-gcdvsqqp.js";
+import"../shared/@outfitter/tooling-jnrs9rqd.js";
+export {
+  runCheckCleanTree,
+  parseUntrackedFiles,
+  parseGitDiff,
+  isCleanTree
+};

package/dist/cli/check-exports.d.ts

@@ -0,0 +1,3 @@
+import { CheckExportsOptions, resolveJsonMode, runCheckExports } from "../shared/@outfitter/tooling-y43b117h.js";
+import { CheckResult, CompareInput, ExportDrift, ExportMap, PackageResult, compareExports, entryToSubpath } from "../shared/@outfitter/tooling-cb0b8wsx.js";
+export { runCheckExports, resolveJsonMode, entryToSubpath, compareExports, PackageResult, ExportMap, ExportDrift, CompareInput, CheckResult, CheckExportsOptions };

package/dist/cli/check-exports.js

@@ -0,0 +1,17 @@
+// @bun
+import {
+  resolveJsonMode,
+  runCheckExports
+} from "../shared/@outfitter/tooling-0zjz8eg9.js";
+import"../shared/@outfitter/tooling-a6q3zh7t.js";
+import {
+  compareExports,
+  entryToSubpath
+} from "../shared/@outfitter/tooling-ayps7c4x.js";
+import"../shared/@outfitter/tooling-jnrs9rqd.js";
+export {
+  runCheckExports,
+  resolveJsonMode,
+  entryToSubpath,
+  compareExports
+};

package/dist/cli/check-home-paths.d.ts

@@ -0,0 +1,31 @@
+interface HomePathLeak {
+	readonly line: number;
+	readonly column: number;
+	readonly matchedText: string;
+	readonly lineText: string;
+}
+interface FileHomePathLeak extends HomePathLeak {
+	readonly filePath: string;
+}
+interface HomePathScanReadFailure {
+	readonly filePath: string;
+	readonly reason: string;
+}
+declare function findHomePathLeaks(content: string, homePathOrPattern: string | RegExp): HomePathLeak[];
+interface ScanHomePathOptions {
+	readonly cwd?: string;
+	readonly homeDir?: string;
+	readonly readFile?: (path: string, encoding: "utf-8") => string;
+}
+interface RunCheckHomePathsOptions {
+	readonly setExitCode?: (code: number) => void;
+	readonly stderr?: Pick<typeof process.stderr, "write">;
+	readonly scanOptions?: ScanHomePathOptions;
+}
+interface HomePathScanResult {
+	readonly leaks: readonly FileHomePathLeak[];
+	readonly failures: readonly HomePathScanReadFailure[];
+}
+declare function scanFilesForHardcodedHomePaths(filePaths: readonly string[], options?: ScanHomePathOptions): HomePathScanResult;
+declare function runCheckHomePaths(paths: readonly string[], options?: RunCheckHomePathsOptions): void;
+export { scanFilesForHardcodedHomePaths, runCheckHomePaths, findHomePathLeaks, ScanHomePathOptions, RunCheckHomePathsOptions, HomePathScanResult, HomePathScanReadFailure, HomePathLeak, FileHomePathLeak };

package/dist/cli/check-home-paths.js

@@ -0,0 +1,12 @@
+// @bun
+import {
+  findHomePathLeaks,
+  runCheckHomePaths,
+  scanFilesForHardcodedHomePaths
+} from "../shared/@outfitter/tooling-h5dnevjw.js";
+import"../shared/@outfitter/tooling-jnrs9rqd.js";
+export {
+  scanFilesForHardcodedHomePaths,
+  runCheckHomePaths,
+  findHomePathLeaks
+};

package/dist/cli/check-markdown-links.d.ts

@@ -0,0 +1,42 @@
+/** A relative link extracted from a markdown file. */
+interface MarkdownLink {
+	/** The link target path (anchors stripped). */
+	readonly target: string;
+	/** 1-based line number where the link appears. */
+	readonly line: number;
+}
+/** A broken link with its source file context. */
+interface BrokenLink {
+	/** Relative path of the source markdown file. */
+	readonly source: string;
+	/** The link target that could not be resolved. */
+	readonly target: string;
+	/** 1-based line number in the source file. */
+	readonly line: number;
+}
+/**
+* Extract relative markdown links from content, skipping external URLs,
+* bare anchors, code fences, and inline code.
+*
+* @param content - Raw markdown content
+* @returns Array of extracted links with line numbers
+*/
+declare function extractMarkdownLinks(content: string): MarkdownLink[];
+/**
+* Validate that relative links in the given markdown files resolve to
+* existing files on disk.
+*
+* @param rootDir - Absolute path to the project root
+* @param files - Relative file paths (from rootDir) to check
+* @returns Array of broken links
+*/
+declare function validateLinks(rootDir: string, files: readonly string[]): Promise<BrokenLink[]>;
+/**
+* Run check-markdown-links across the project.
+*
+* @param rootDir - Project root directory
+* @param patterns - Glob patterns for file discovery (defaults to standard set)
+* @returns Exit code (0 = all valid, 1 = broken links found)
+*/
+declare function runCheckMarkdownLinks(rootDir: string, patterns?: readonly string[]): Promise<number>;
+export { validateLinks, runCheckMarkdownLinks, extractMarkdownLinks, MarkdownLink, BrokenLink };

package/dist/cli/check-markdown-links.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env bun
+// @bun
+import {
+  extractMarkdownLinks,
+  runCheckMarkdownLinks,
+  validateLinks
+} from "../shared/@outfitter/tooling-ja1zg5yc.js";
+import"../shared/@outfitter/tooling-jnrs9rqd.js";
+export {
+  validateLinks,
+  runCheckMarkdownLinks,
+  extractMarkdownLinks
+};