@outfitter/tooling 0.3.4 → 0.3.5

package/dist/shared/@outfitter/tooling-mq2xvz96.js

@@ -0,0 +1,285 @@
+// @bun
+// packages/tooling/src/cli/check-changeset.ts
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+function toWorkspacePackageName(packageName) {
+  return packageName.startsWith("@outfitter/") ? packageName : `@outfitter/${packageName}`;
+}
+function getReleasableChangedPackages(changedPackages, ignoredPackages) {
+  const ignored = new Set(ignoredPackages.map(toWorkspacePackageName));
+  return changedPackages.filter((packageName) => !ignored.has(toWorkspacePackageName(packageName)));
+}
+function getChangedPackagePaths(files) {
+  const packageNames = new Set;
+  const pattern = /^packages\/([^/]+)\/src\/(.+)$/;
+  for (const file of files) {
+    const match = pattern.exec(file);
+    if (match?.[1] && match[2] && isReleaseRelevantSourcePath(match[2])) {
+      packageNames.add(match[1]);
+    }
+  }
+  return [...packageNames].toSorted();
+}
+function getChangedChangesetFiles(files) {
+  const pattern = /^\.changeset\/([^/]+\.md)$/;
+  const results = [];
+  for (const file of files) {
+    const match = pattern.exec(file);
+    if (match?.[1] && match[1] !== "README.md") {
+      results.push(match[1]);
+    }
+  }
+  return results.toSorted();
+}
+function checkChangesetRequired(releasablePackages, changesetFiles, coveredPackages = []) {
+  if (releasablePackages.length === 0) {
+    return { ok: true, missingFor: [] };
+  }
+  if (changesetFiles.length === 0) {
+    return { ok: false, missingFor: releasablePackages };
+  }
+  const covered = new Set(coveredPackages);
+  const missingFor = releasablePackages.filter((packageName) => !covered.has(toWorkspacePackageName(packageName)));
+  return missingFor.length === 0 ? { ok: true, missingFor: [] } : { ok: false, missingFor };
+}
+function parseIgnoredPackagesFromChangesetConfig(jsonContent) {
+  try {
+    const parsed = JSON.parse(jsonContent);
+    if (!Array.isArray(parsed.ignore)) {
+      return [];
+    }
+    return parsed.ignore.filter((entry) => typeof entry === "string");
+  } catch {
+    return [];
+  }
+}
+function parseChangesetFrontmatterPackageNames(markdownContent) {
+  const frontmatterMatch = /^---\r?\n([\s\S]*?)\r?\n---/.exec(markdownContent);
+  if (!frontmatterMatch?.[1]) {
+    return [];
+  }
+  const packages = new Set;
+  for (const line of frontmatterMatch[1].split(/\r?\n/)) {
+    const trimmed = line.trim();
+    const match = /^(["']?)(@[^"':\s]+\/[^"':\s]+)\1\s*:/.exec(trimmed);
+    if (match?.[2]) {
+      packages.add(match[2]);
+    }
+  }
+  return [...packages].toSorted();
+}
+function isReleaseRelevantSourcePath(relativePath) {
+  if (/(^|\/)__tests__\//.test(relativePath)) {
+    return false;
+  }
+  if (/(^|\/)__snapshots__\//.test(relativePath)) {
+    return false;
+  }
+  if (/\.(test|spec)\.[^/]+$/.test(relativePath)) {
+    return false;
+  }
+  return true;
+}
+function getDefaultGitDiffRange() {
+  return {
+    base: "origin/main",
+    head: "HEAD",
+    label: "origin/main...HEAD",
+    source: "default"
+  };
+}
+function resolveGitDiffRange(input) {
+  if (input.eventName !== "pull_request" || !input.eventPath) {
+    return getDefaultGitDiffRange();
+  }
+  const readEventFile = input.readEventFile ?? ((path) => readFileSync(path, "utf-8"));
+  try {
+    const payload = JSON.parse(readEventFile(input.eventPath));
+    const baseRef = payload.pull_request?.base?.ref;
+    const baseSha = payload.pull_request?.base?.sha;
+    const headRef = payload.pull_request?.head?.ref;
+    const headSha = payload.pull_request?.head?.sha;
+    if (!baseSha || !headSha) {
+      return getDefaultGitDiffRange();
+    }
+    return {
+      base: baseSha,
+      head: headSha,
+      label: `${baseRef ?? "base"} (${baseSha})...${headRef ?? "head"} (${headSha})`,
+      source: "pull_request"
+    };
+  } catch {
+    return getDefaultGitDiffRange();
+  }
+}
+function analyzeChangesetReferences(referencedPackages, ignored) {
+  const coveredPackages = referencedPackages.filter((packageName) => !ignored.has(packageName));
+  const ignoredReferences = referencedPackages.filter((packageName) => ignored.has(packageName));
+  return {
+    coveredPackages: coveredPackages.toSorted(),
+    ignoredReferences: ignoredReferences.toSorted()
+  };
+}
+function findIgnoredPackageReferences(input) {
+  if (input.ignoredPackages.length === 0 || input.changesetFiles.length === 0) {
+    return [];
+  }
+  const ignored = new Set(input.ignoredPackages);
+  const results = [];
+  for (const file of input.changesetFiles) {
+    const content = input.readChangesetFile(file);
+    const referencedPackages = parseChangesetFrontmatterPackageNames(content);
+    const invalidReferences = analyzeChangesetReferences(referencedPackages, ignored).ignoredReferences;
+    if (invalidReferences.length > 0) {
+      results.push({ file, packages: invalidReferences.toSorted() });
+    }
+  }
+  return results.toSorted((a, b) => a.file.localeCompare(b.file));
+}
+function loadIgnoredPackages(cwd) {
+  const configPath = join(cwd, ".changeset", "config.json");
+  if (!existsSync(configPath)) {
+    return [];
+  }
+  try {
+    return parseIgnoredPackagesFromChangesetConfig(readFileSync(configPath, "utf-8"));
+  } catch {
+    return [];
+  }
+}
+function analyzeChangedChangesets(cwd, changesetFiles, ignoredPackages) {
+  const covered = new Set;
+  const ignored = new Set(ignoredPackages);
+  const ignoredReferences = [];
+  for (const filename of changesetFiles) {
+    try {
+      const content = readFileSync(join(cwd, ".changeset", filename), "utf-8");
+      const referencedPackages = parseChangesetFrontmatterPackageNames(content);
+      const analysis = analyzeChangesetReferences(referencedPackages, ignored);
+      for (const packageName of analysis.coveredPackages) {
+        covered.add(packageName);
+      }
+      if (analysis.ignoredReferences.length > 0) {
+        ignoredReferences.push({
+          file: filename,
+          packages: analysis.ignoredReferences
+        });
+      }
+    } catch {
+      continue;
+    }
+  }
+  return {
+    coveredPackages: [...covered].toSorted(),
+    ignoredReferences: ignoredReferences.toSorted((a, b) => a.file.localeCompare(b.file))
+  };
+}
+var COLORS = {
+  reset: "\x1B[0m",
+  red: "\x1B[31m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  blue: "\x1B[34m",
+  dim: "\x1B[2m"
+};
+async function runCheckChangeset(options = {}) {
+  if (options.skip || process.env["NO_CHANGESET"] === "1") {
+    process.stdout.write(`${COLORS.dim}check-changeset skipped (NO_CHANGESET=1)${COLORS.reset}
+`);
+    process.exitCode = 0;
+    return;
+  }
+  if (process.env["GITHUB_EVENT_NAME"] === "push") {
+    process.stdout.write(`${COLORS.dim}check-changeset skipped (push event)${COLORS.reset}
+`);
+    process.exitCode = 0;
+    return;
+  }
+  const cwd = process.cwd();
+  const diffRange = resolveGitDiffRange({
+    eventName: process.env["GITHUB_EVENT_NAME"],
+    eventPath: process.env["GITHUB_EVENT_PATH"],
+    readEventFile: (path) => readFileSync(path, "utf-8")
+  });
+  let changedFiles;
+  try {
+    const proc = Bun.spawnSync(["git", "diff", "--name-only", `${diffRange.base}...${diffRange.head}`], { cwd });
+    if (proc.exitCode !== 0) {
+      process.exitCode = 0;
+      return;
+    }
+    changedFiles = proc.stdout.toString().trim().split(`
+`).filter((line) => line.length > 0);
+  } catch {
+    process.exitCode = 0;
+    return;
+  }
+  if (process.env["GITHUB_EVENT_NAME"]) {
+    process.stdout.write(`${COLORS.dim}check-changeset diff basis: ${diffRange.label}${COLORS.reset}
+`);
+  }
+  const changedPackages = getChangedPackagePaths(changedFiles);
+  if (changedPackages.length === 0) {
+    process.stdout.write(`${COLORS.green}No package source changes detected.${COLORS.reset}
+`);
+    process.exitCode = 0;
+    return;
+  }
+  const changesetFiles = getChangedChangesetFiles(changedFiles);
+  const ignoredPackages = loadIgnoredPackages(cwd);
+  const releasablePackages = getReleasableChangedPackages(changedPackages, ignoredPackages);
+  const changesetAnalysis = analyzeChangedChangesets(cwd, changesetFiles, ignoredPackages);
+  const check = checkChangesetRequired(releasablePackages, changesetFiles, changesetAnalysis.coveredPackages);
+  const ignoredReferences = changesetAnalysis.ignoredReferences;
+  let hasErrors = false;
+  if (!check.ok) {
+    process.stderr.write(`${COLORS.red}Changeset coverage missing.${COLORS.reset} ` + `Every changed releasable package must be mentioned in at least one current PR changeset.
+
+`);
+    process.stderr.write(`Packages missing changeset coverage:
+
+`);
+    for (const pkg of check.missingFor) {
+      process.stderr.write(`  ${COLORS.yellow}${toWorkspacePackageName(pkg)}${COLORS.reset}
+`);
+    }
+    process.stderr.write(`
+Run ${COLORS.blue}bun run changeset${COLORS.reset} for a custom changelog entry, ` + `or add ${COLORS.blue}release:none${COLORS.reset} to skip.
+`);
+    hasErrors = true;
+  }
+  if (ignoredReferences.length > 0) {
+    process.stderr.write(`${COLORS.red}Invalid changeset package reference(s).${COLORS.reset}
+
+`);
+    process.stderr.write(`Changesets must not reference packages listed in .changeset/config.json ignore:
+
+`);
+    for (const reference of ignoredReferences) {
+      process.stderr.write(`  ${COLORS.yellow}${reference.file}${COLORS.reset}
+`);
+      for (const pkg of reference.packages) {
+        process.stderr.write(`    - ${pkg}
+`);
+      }
+    }
+    process.stderr.write(`
+Update the affected changeset files to remove ignored packages before merging.
+`);
+    hasErrors = true;
+  }
+  if (hasErrors) {
+    process.exitCode = 1;
+    return;
+  }
+  if (releasablePackages.length === 0) {
+    process.stdout.write(`${COLORS.green}Only ignored package source changes detected.${COLORS.reset}
+`);
+  } else {
+    process.stdout.write(`${COLORS.green}Changesets cover ${releasablePackages.length} changed package(s).${COLORS.reset}
+`);
+  }
+  process.exitCode = 0;
+}
+
+export { getReleasableChangedPackages, getChangedPackagePaths, getChangedChangesetFiles, checkChangesetRequired, parseIgnoredPackagesFromChangesetConfig, parseChangesetFrontmatterPackageNames, resolveGitDiffRange, findIgnoredPackageReferences, runCheckChangeset };

package/dist/shared/@outfitter/tooling-stgnc2zx.d.ts

@@ -0,0 +1,85 @@
+import { CheckTsDocOptions, CoverageLevel, DeclarationCoverage, PackageCoverage, TsDocCheckResult } from "./tooling-tj9p41vj.js";
+import ts from "typescript";
+/**
+* Check whether a node is an exported declaration worth checking.
+*
+* Returns true for function, interface, type alias, class, enum, and variable
+* declarations that carry the `export` keyword. Re-exports (`{ ... } from`)
+* and `*` are excluded since TSDoc belongs at the definition site.
+*/
+declare function isExportedDeclaration(node: ts.Node): boolean;
+/**
+* Extract the name of a declaration node.
+*
+* For variable statements, returns the name of the first variable declarator.
+* Returns `undefined` for anonymous declarations (e.g., `function() {}`).
+*/
+declare function getDeclarationName(node: ts.Node): string | undefined;
+/**
+* Determine the kind label for a declaration node.
+*
+* Maps AST node types to human-readable kind strings used in coverage reports.
+*/
+declare function getDeclarationKind(node: ts.Node): string;
+/**
+* Classify a declaration's TSDoc coverage level.
+*
+* - `"documented"` -- has a JSDoc comment with a description. For interfaces
+*   and classes, all members must also have JSDoc comments.
+* - `"partial"` -- the declaration has a JSDoc comment but some members
+*   (in interfaces/classes) lack documentation.
+* - `"undocumented"` -- no JSDoc comment at all.
+*/
+declare function classifyDeclaration(node: ts.Node, sourceFile: ts.SourceFile): CoverageLevel;
+/**
+* Analyze all exported declarations in a source file for TSDoc coverage.
+*
+* Walks top-level statements, filters to exported declarations, and
+* classifies each for documentation coverage.
+*/
+declare function analyzeSourceFile(sourceFile: ts.SourceFile): DeclarationCoverage[];
+/**
+* Calculate aggregate coverage statistics from declaration results.
+*
+* Partial documentation counts as half coverage in the percentage calculation.
+* An empty array returns 100% (no declarations to check).
+*/
+declare function calculateCoverage(declarations: readonly DeclarationCoverage[]): {
+	documented: number;
+	partial: number;
+	undocumented: number;
+	total: number;
+	percentage: number;
+};
+/** Discover packages with src/index.ts entry points. */
+declare function discoverPackages(cwd: string): Array<{
+	name: string;
+	path: string;
+	entryPoint: string;
+}>;
+/**
+* Collect source files referenced by re-exports in a barrel file.
+*
+* For `{ ... } from "./foo"` and `* from "./bar"`, resolves
+* the module specifier to a source file in the program. Returns only files
+* within the package (skips external modules).
+*/
+declare function collectReExportedSourceFiles(sourceFile: ts.SourceFile, program: ts.Program, pkgPath: string): ts.SourceFile[];
+/** Analyze a single package entry point, returning coverage data. */
+declare function analyzePackage(pkg: {
+	name: string;
+	path: string;
+	entryPoint: string;
+}, workspaceCwd: string): PackageCoverage;
+/**
+* Analyze TSDoc coverage across workspace packages.
+*
+* Pure function that discovers packages, analyzes TSDoc coverage on exported
+* declarations, and returns the aggregated result. Does not print output or
+* call `process.exit()`.
+*
+* @param options - Analysis options (paths, strict mode, coverage threshold)
+* @returns Aggregated coverage result across all packages, or `null` if no packages found
+*/
+declare function analyzeCheckTsdoc(options?: CheckTsDocOptions): TsDocCheckResult | null;
+export { isExportedDeclaration, getDeclarationName, getDeclarationKind, classifyDeclaration, analyzeSourceFile, calculateCoverage, discoverPackages, collectReExportedSourceFiles, analyzePackage, analyzeCheckTsdoc };

package/dist/shared/@outfitter/tooling-tj9p41vj.d.ts

@@ -0,0 +1,55 @@
+import { ZodType } from "zod";
+/** Coverage classification for a single declaration. */
+type CoverageLevel = "documented" | "partial" | "undocumented";
+/** Result for a single exported declaration. */
+interface DeclarationCoverage {
+	readonly name: string;
+	readonly kind: string;
+	readonly level: CoverageLevel;
+	readonly file: string;
+	readonly line: number;
+}
+/** Coverage summary statistics. */
+interface CoverageSummary {
+	readonly documented: number;
+	readonly partial: number;
+	readonly undocumented: number;
+	readonly total: number;
+	readonly percentage: number;
+}
+/** Per-package TSDoc coverage stats. */
+interface PackageCoverage {
+	readonly name: string;
+	readonly path: string;
+	readonly declarations: readonly DeclarationCoverage[];
+	readonly documented: number;
+	readonly partial: number;
+	readonly undocumented: number;
+	readonly total: number;
+	readonly percentage: number;
+}
+/** Aggregated result across all packages. */
+interface TsDocCheckResult {
+	readonly ok: boolean;
+	readonly packages: readonly PackageCoverage[];
+	readonly summary: CoverageSummary;
+}
+/** Zod schema for {@link CoverageLevel}. */
+declare const coverageLevelSchema: ZodType<CoverageLevel>;
+/** Zod schema for {@link DeclarationCoverage}. */
+declare const declarationCoverageSchema: ZodType<DeclarationCoverage>;
+/** Zod schema for {@link CoverageSummary}. */
+declare const coverageSummarySchema: ZodType<CoverageSummary>;
+/** Zod schema for {@link PackageCoverage}. */
+declare const packageCoverageSchema: ZodType<PackageCoverage>;
+/** Zod schema for {@link TsDocCheckResult}. */
+declare const tsDocCheckResultSchema: ZodType<TsDocCheckResult>;
+/** Options for the check-tsdoc command. */
+interface CheckTsDocOptions {
+	readonly strict?: boolean | undefined;
+	readonly json?: boolean | undefined;
+	readonly minCoverage?: number | undefined;
+	readonly cwd?: string | undefined;
+	readonly paths?: readonly string[] | undefined;
+}
+export { CoverageLevel, DeclarationCoverage, CoverageSummary, PackageCoverage, TsDocCheckResult, coverageLevelSchema, declarationCoverageSchema, coverageSummarySchema, packageCoverageSchema, tsDocCheckResultSchema, CheckTsDocOptions };

package/dist/shared/@outfitter/tooling-y43b117h.d.ts

@@ -0,0 +1,13 @@
+/** Options for the check-exports command */
+interface CheckExportsOptions {
+	readonly json?: boolean;
+}
+/** Resolve whether to output JSON based on options and env */
+declare function resolveJsonMode(options?: CheckExportsOptions): boolean;
+/**
+* Run check-exports across all workspace packages.
+*
+* Reads the bunup workspace config to discover packages and their * settings, then compares expected vs actual exports in each package.json.
+*/
+declare function runCheckExports(options?: CheckExportsOptions): Promise<void>;
+export { CheckExportsOptions, resolveJsonMode, runCheckExports };

package/lefthook.yml

@@ -13,6 +13,10 @@ pre-commit:
       run: bun x ultracite fix {staged_files}
       stage_fixed: true
 
+    home-paths:
+      glob: "*.{js,jsx,json,jsonc,css,md,ts,tsx,yaml,yml}"
+      run: bun x @outfitter/tooling check-home-paths {staged_files}
+
     typecheck:
       glob: "*.{ts,tsx}"
       run: bun run typecheck
@@ -25,4 +29,4 @@ pre-push:
       # (*-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
+      run: bun x @outfitter/tooling pre-push

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@outfitter/tooling",
   "description": "Dev tooling configuration presets for Outfitter projects (oxlint/oxfmt, typescript, lefthook, markdownlint)",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "type": "module",
   "files": [
     "dist",
@@ -28,6 +28,12 @@
         "default": "./dist/cli/check.js"
       }
     },
+    "./cli/check-home-paths": {
+      "import": {
+        "types": "./dist/cli/check-home-paths.d.ts",
+        "default": "./dist/cli/check-home-paths.js"
+      }
+    },
     "./cli/check-markdown-links": {
       "import": {
         "types": "./dist/cli/check-markdown-links.d.ts",
@@ -74,7 +80,7 @@
     "build:registry": "bun run src/registry/build.ts",
     "sync:exports": "bun run scripts/sync-exports.ts",
     "sync:exports:check": "bun run scripts/sync-exports.ts --check",
-    "build": "bun run build:registry && bun run sync:exports:check && cd ../.. && bunup --filter @outfitter/tooling",
+    "build": "bun run build:registry && bun run sync:exports:check && cd ../.. && bash ./scripts/run-bunup-with-lock.sh bunup --filter @outfitter/tooling",
     "prepack": "bun run sync:exports",
     "lint": "oxlint ./src",
     "lint:fix": "oxlint --fix ./src",
@@ -84,13 +90,13 @@
     "prepublishOnly": "bun ../../scripts/check-publish-manifest.ts"
   },
   "dependencies": {
-    "@outfitter/cli": "0.5.3",
+    "@outfitter/cli": "1.0.0",
     "commander": "^14.0.2",
     "typescript": "^5.9.3",
     "zod": "^4.3.5"
   },
   "devDependencies": {
-    "@outfitter/presets": "0.2.1",
+    "@outfitter/presets": "0.3.0",
     "@types/bun": "^1.3.9",
     "yaml": "^2.8.2"
   },

package/registry/registry.json

@@ -7,7 +7,7 @@
 			"files": [
 				{
 					"path": ".claude/settings.json",
-					"content": "{\n  \"hooks\": {\n    \"SessionStart\": [\n      {\n        \"matcher\": \"*\",\n        \"hooks\": [\n          {\n            \"type\": \"command\",\n            \"command\": \"bash \\\"$CLAUDE_PROJECT_DIR/scripts/bootstrap.sh\\\"\",\n            \"timeout\": 120\n          }\n        ]\n      }\n    ],\n    \"Stop\": [\n      {\n        \"matcher\": \"*\",\n        \"hooks\": [\n          {\n            \"type\": \"command\",\n            \"command\": \"bash \\\"$CLAUDE_PROJECT_DIR/.claude/hooks/format-code-on-stop.sh\\\"\",\n            \"timeout\": 60\n          }\n        ]\n      }\n    ]\n  },\n  \"enabledPlugins\": {},\n  \"extraKnownMarketplaces\": {}\n}\n"
+					"content": "{\n  \"hooks\": {\n    \"SessionStart\": [\n      {\n        \"matcher\": \"*\",\n        \"hooks\": [\n          {\n            \"type\": \"command\",\n            \"command\": \"bash \\\"$CLAUDE_PROJECT_DIR/scripts/bootstrap.sh\\\"\",\n            \"timeout\": 120\n          }\n        ]\n      }\n    ],\n    \"Stop\": [\n      {\n        \"matcher\": \"*\",\n        \"hooks\": [\n          {\n            \"type\": \"command\",\n            \"command\": \"bash \\\"$CLAUDE_PROJECT_DIR/.claude/hooks/format-code-on-stop.sh\\\"\",\n            \"timeout\": 60\n          }\n        ]\n      }\n    ]\n  },\n  \"enabledPlugins\": {\n    \"outfitter@outfitter\": true,\n    \"fieldguides@outfitter\": true\n  },\n  \"extraKnownMarketplaces\": {\n    \"outfitter\": {\n      \"source\": {\n        \"source\": \"github\",\n        \"repo\": \"outfitter-dev/outfitter\",\n        \"sparsePaths\": [\".claude-plugin\", \"plugins\"]\n      }\n    }\n  }\n}\n"
 				},
 				{
 					"path": ".claude/hooks/format-code-on-stop.sh",
@@ -22,7 +22,7 @@
 			"files": [
 				{
 					"path": ".oxlintrc.json",
-					"content": "{\n  \"$schema\": \"./node_modules/oxlint/configuration_schema.json\",\n  \"plugins\": [\"eslint\"],\n  \"jsPlugins\": [\n    {\n      \"name\": \"outfitter\",\n      \"specifier\": \"@outfitter/oxlint-plugin\"\n    }\n  ],\n  \"globals\": { \"Bun\": \"readonly\" },\n  \"categories\": {\n    \"correctness\": \"error\",\n    \"suspicious\": \"error\",\n    \"pedantic\": \"off\",\n    \"perf\": \"off\",\n    \"style\": \"off\",\n    \"restriction\": \"off\"\n  },\n  \"ignorePatterns\": [\n    \"**/node_modules/**\",\n    \"**/dist/**\",\n    \"**/.turbo/**\",\n    \"**/*.gen.ts\"\n  ],\n  \"rules\": {\n    \"no-void\": \"off\",\n    \"outfitter/action-must-register\": \"warn\",\n    \"outfitter/handler-must-return-result\": \"error\",\n    \"outfitter/max-file-lines\": [\"error\", { \"warn\": 200, \"error\": 400 }],\n    \"outfitter/no-console-in-packages\": \"error\",\n    \"outfitter/no-cross-tier-import\": \"error\",\n    \"outfitter/no-deep-relative-import\": \"warn\",\n    \"outfitter/no-nested-barrel\": \"warn\",\n    \"outfitter/no-process-env-in-packages\": \"warn\",\n    \"outfitter/no-process-exit-in-packages\": \"error\",\n    \"outfitter/no-throw-in-handler\": \"error\",\n    \"outfitter/prefer-bun-api\": \"warn\",\n    \"outfitter/snapshot-location\": \"warn\",\n    \"outfitter/test-file-naming\": \"warn\",\n    \"outfitter/use-error-taxonomy\": \"warn\"\n  }\n}\n"
+					"content": "{\n  \"$schema\": \"./node_modules/oxlint/configuration_schema.json\",\n  \"plugins\": [\"eslint\"],\n  \"jsPlugins\": [\n    {\n      \"name\": \"outfitter\",\n      \"specifier\": \"@outfitter/oxlint-plugin\"\n    }\n  ],\n  \"globals\": { \"Bun\": \"readonly\" },\n  \"categories\": {\n    \"correctness\": \"error\",\n    \"suspicious\": \"error\",\n    \"pedantic\": \"off\",\n    \"perf\": \"off\",\n    \"style\": \"off\",\n    \"restriction\": \"off\"\n  },\n  \"ignorePatterns\": [\n    \"**/node_modules/**\",\n    \"**/dist/**\",\n    \"**/.turbo/**\",\n    \"**/*.gen.ts\",\n    \"**/__tests__/fixtures/**\"\n  ],\n  \"rules\": {\n    \"no-void\": \"off\",\n    \"outfitter/action-must-register\": \"warn\",\n    \"outfitter/handler-must-return-result\": \"error\",\n    \"outfitter/max-file-lines\": [\"error\", { \"warn\": 200, \"error\": 400 }],\n    \"outfitter/no-console-in-packages\": \"error\",\n    \"outfitter/no-cross-tier-import\": \"error\",\n    \"outfitter/no-deep-relative-import\": \"warn\",\n    \"outfitter/no-nested-barrel\": \"warn\",\n    \"outfitter/no-process-env-in-packages\": [\n      \"warn\",\n      { \"allowedPackages\": [\"config\"] }\n    ],\n    \"outfitter/no-process-exit-in-packages\": \"error\",\n    \"outfitter/no-throw-in-handler\": \"error\",\n    \"outfitter/prefer-bun-api\": \"warn\",\n    \"outfitter/snapshot-location\": \"warn\",\n    \"outfitter/test-file-naming\": \"warn\",\n    \"outfitter/use-error-taxonomy\": \"warn\"\n  }\n}\n"
 				},
 				{
 					"path": ".oxfmtrc.jsonc",
@@ -30,7 +30,7 @@
 				}
 			],
 			"devDependencies": {
-				"@outfitter/oxlint-plugin": "^0.1.0",
+				"@outfitter/oxlint-plugin": "^0.2.0",
 				"ultracite": "7.2.3",
 				"oxlint": "1.50.0",
 				"oxfmt": "0.35.0"
@@ -42,11 +42,11 @@
 			"files": [
 				{
 					"path": ".lefthook.yml",
-					"content": "# Lefthook configuration preset for Outfitter projects\n# https://github.com/evilmartians/lefthook\n#\n# Usage: In your project's .lefthook.yml, add:\n#   extends:\n#     - node_modules/@outfitter/tooling/lefthook.yml\n\npre-commit:\n  parallel: true\n  commands:\n    ultracite:\n      glob: \"*.{js,jsx,ts,tsx,json,jsonc,css}\"\n      run: bun x ultracite fix {staged_files}\n      stage_fixed: true\n\n    typecheck:\n      glob: \"*.{ts,tsx}\"\n      run: bun run typecheck\n\npre-push:\n  parallel: false\n  commands:\n    verify:\n      # TDD-aware: skips strict verification on explicit RED phase branches\n      # (*-tests, */tests, *_tests). Otherwise runs verify:ci (or a strict\n      # fallback: typecheck/check-or-lint/build/test).\n      # Requires: @outfitter/tooling as a dev dependency.\n      run: bunx @outfitter/tooling pre-push\n"
+					"content": "# Lefthook configuration preset for Outfitter projects\n# https://github.com/evilmartians/lefthook\n#\n# Usage: In your project's .lefthook.yml, add:\n#   extends:\n#     - node_modules/@outfitter/tooling/lefthook.yml\n\npre-commit:\n  parallel: true\n  commands:\n    ultracite:\n      glob: \"*.{js,jsx,ts,tsx,json,jsonc,css}\"\n      run: bun x ultracite fix {staged_files}\n      stage_fixed: true\n\n    home-paths:\n      glob: \"*.{js,jsx,json,jsonc,css,md,ts,tsx,yaml,yml}\"\n      run: bun x @outfitter/tooling check-home-paths {staged_files}\n\n    typecheck:\n      glob: \"*.{ts,tsx}\"\n      run: bun run typecheck\n\npre-push:\n  parallel: false\n  commands:\n    verify:\n      # TDD-aware: skips strict verification on explicit RED phase branches\n      # (*-tests, */tests, *_tests). Otherwise runs verify:ci (or a strict\n      # fallback: typecheck/check-or-lint/build/test).\n      # Requires: @outfitter/tooling as a dev dependency.\n      run: bun x @outfitter/tooling pre-push\n"
 				}
 			],
 			"devDependencies": {
-				"@outfitter/tooling": "^0.3.4",
+				"@outfitter/tooling": "^0.3.5",
 				"lefthook": "^2.1.1",
 				"ultracite": "7.2.3"
 			}