@outfitter/tooling 0.2.3 → 0.3.0

package/README.md

@@ -98,6 +98,75 @@ bunx @outfitter/tooling check-boundary-invocations
 When this fails, replace direct source execution with canonical command surfaces
 (`outfitter repo ...` in monorepo scripts, or package bins for standalone use).
 
+### `tooling check-bunup-registry`
+
+Validate that packages using `bunup --filter` are registered in `bunup.config.ts`.
+
+```bash
+bunx @outfitter/tooling check-bunup-registry
+```
+
+### `tooling check-changeset`
+
+Validate that PRs touching package source include a changeset.
+
+```bash
+bunx @outfitter/tooling check-changeset
+
+# Skip the check (e.g. for non-package changes)
+bunx @outfitter/tooling check-changeset --skip
+```
+
+### `tooling check-exports`
+
+Validate that `package.json` exports match source entry points.
+
+```bash
+bunx @outfitter/tooling check-exports
+
+# Machine-readable output
+bunx @outfitter/tooling check-exports --json
+```
+
+### `tooling check-tsdoc`
+
+Check TSDoc coverage on exported declarations.
+
+```bash
+bunx @outfitter/tooling check-tsdoc
+
+# Check specific packages
+bunx @outfitter/tooling check-tsdoc packages/cli packages/contracts
+
+# Strict mode with coverage threshold
+bunx @outfitter/tooling check-tsdoc --strict --min-coverage 80
+
+# JSON output
+bunx @outfitter/tooling check-tsdoc --json
+```
+
+### `tooling check-clean-tree`
+
+Assert the working tree is clean (no modified or untracked files).
+
+```bash
+bunx @outfitter/tooling check-clean-tree
+
+# Check specific paths only
+bunx @outfitter/tooling check-clean-tree --paths packages/cli packages/contracts
+```
+
+### `tooling check-readme-imports`
+
+Validate that README import examples match package exports.
+
+```bash
+bunx @outfitter/tooling check-readme-imports
+
+# Machine-readable output
+bunx @outfitter/tooling check-readme-imports --json
+```
+
 ## Configuration Presets
 
 ### Biome
@@ -188,7 +257,6 @@ bun run apps/outfitter/src/cli.ts repo check boundary-invocations --cwd .
 
 - [@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
 

package/biome.json

@@ -1,5 +1,5 @@
 {
-	"$schema": "https://biomejs.dev/schemas/2.3.12/schema.json",
+	"$schema": "https://biomejs.dev/schemas/2.4.4/schema.json",
 	"root": false,
 	"javascript": {
 		"globals": ["Bun"]

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

@@ -1,17 +1,12 @@
-/**
-* Check-changeset command — validates PRs touching package source include a changeset.
-*
-* Pure core functions for detecting changed packages and verifying changeset
-* presence. The CLI runner in {@link runCheckChangeset} handles git discovery
-* and output.
-*
-* @packageDocumentation
-*/
 /** Result of checking whether changesets are required */
 interface ChangesetCheckResult {
 	readonly ok: boolean;
 	readonly missingFor: string[];
 }
+interface ChangesetIgnoredReference {
+	readonly file: string;
+	readonly packages: string[];
+}
 /**
 * Extract unique package names from changed file paths.
 *
@@ -44,6 +39,13 @@ declare function getChangedChangesetFiles(files: string[]): string[];
 * @param changesetFiles - Changeset filenames found in `.changeset/`
 */
 declare function checkChangesetRequired(changedPackages: string[], changesetFiles: string[]): ChangesetCheckResult;
+declare function parseIgnoredPackagesFromChangesetConfig(jsonContent: string): string[];
+declare function parseChangesetFrontmatterPackageNames(markdownContent: string): string[];
+declare function findIgnoredPackageReferences(input: {
+	readonly changesetFiles: readonly string[];
+	readonly ignoredPackages: readonly string[];
+	readonly readChangesetFile: (filename: string) => string;
+}): ChangesetIgnoredReference[];
 interface CheckChangesetOptions {
 	readonly skip?: boolean;
 }
@@ -61,4 +63,4 @@ interface CheckChangesetOptions {
 * - Git diff fails (local dev without origin)
 */
 declare function runCheckChangeset(options?: CheckChangesetOptions): Promise<void>;
-export { runCheckChangeset, getChangedPackagePaths, getChangedChangesetFiles, checkChangesetRequired, CheckChangesetOptions, ChangesetCheckResult };
+export { runCheckChangeset, parseIgnoredPackagesFromChangesetConfig, parseChangesetFrontmatterPackageNames, getChangedPackagePaths, getChangedChangesetFiles, findIgnoredPackageReferences, checkChangesetRequired, CheckChangesetOptions, ChangesetIgnoredReference, ChangesetCheckResult };

package/dist/cli/check-changeset.js

@@ -1,14 +1,20 @@
 // @bun
 import {
   checkChangesetRequired,
+  findIgnoredPackageReferences,
   getChangedChangesetFiles,
   getChangedPackagePaths,
+  parseChangesetFrontmatterPackageNames,
+  parseIgnoredPackagesFromChangesetConfig,
   runCheckChangeset
-} from "../shared/@outfitter/tooling-3w8vr2w3.js";
+} from "../shared/@outfitter/tooling-cj5vsa9k.js";
 import"../shared/@outfitter/tooling-dvwh9qve.js";
 export {
   runCheckChangeset,
+  parseIgnoredPackagesFromChangesetConfig,
+  parseChangesetFrontmatterPackageNames,
   getChangedPackagePaths,
   getChangedChangesetFiles,
+  findIgnoredPackageReferences,
   checkChangesetRequired
 };

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

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

package/dist/cli/check-exports.js

@@ -2,11 +2,13 @@
 import {
   compareExports,
   entryToSubpath,
+  resolveJsonMode,
   runCheckExports
-} from "../shared/@outfitter/tooling-tf22zt9p.js";
+} from "../shared/@outfitter/tooling-enjcenja.js";
 import"../shared/@outfitter/tooling-dvwh9qve.js";
 export {
   runCheckExports,
+  resolveJsonMode,
   entryToSubpath,
   compareExports
 };

package/dist/cli/check-readme-imports.d.ts

@@ -1,4 +1,4 @@
-import { ExportMap } from "../shared/@outfitter/tooling-q0d60xb3";
+import { ExportMap } from "../shared/@outfitter/tooling-wesswf21.js";
 /** An import example extracted from a markdown code block */
 interface ImportExample {
 	/** Package name, e.g. "@outfitter/cli" */
@@ -49,6 +49,7 @@ declare function isExportedSubpath(subpath: string, exports: ExportMap): boolean
 interface CheckReadmeImportsOptions {
 	readonly json?: boolean;
 }
+declare function resolveJsonMode(options?: CheckReadmeImportsOptions): boolean;
 /**
 * Run check-readme-imports across all workspace packages.
 *
@@ -57,4 +58,4 @@ interface CheckReadmeImportsOptions {
 * package.json exports.
 */
 declare function runCheckReadmeImports(options?: CheckReadmeImportsOptions): Promise<void>;
-export { runCheckReadmeImports, parseSpecifier, isExportedSubpath, extractImports, ImportExample, ImportCheckResult, ExportMap, CheckReadmeImportsOptions };
+export { runCheckReadmeImports, resolveJsonMode, parseSpecifier, isExportedSubpath, extractImports, ImportExample, ImportCheckResult, ExportMap, CheckReadmeImportsOptions };

package/dist/cli/check-readme-imports.js

@@ -85,6 +85,9 @@ var COLORS = {
   blue: "\x1B[34m",
   dim: "\x1B[2m"
 };
+function resolveJsonMode(options = {}) {
+  return options.json ?? process.env["OUTFITTER_JSON"] === "1";
+}
 async function runCheckReadmeImports(options = {}) {
   const cwd = process.cwd();
   const readmeGlob = new Bun.Glob("**/README.md");
@@ -151,7 +154,7 @@ async function runCheckReadmeImports(options = {}) {
       hasInvalid = true;
     }
   }
-  if (options.json) {
+  if (resolveJsonMode(options)) {
     const output = {
       ok: !hasInvalid,
       files: results
@@ -188,6 +191,7 @@ async function runCheckReadmeImports(options = {}) {
 }
 export {
   runCheckReadmeImports,
+  resolveJsonMode,
   parseSpecifier,
   isExportedSubpath,
   extractImports

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

@@ -0,0 +1,2 @@
+import { CheckTsDocOptions, CoverageLevel, CoverageSummary, DeclarationCoverage, PackageCoverage, TsDocCheckResult, analyzeCheckTsdoc, analyzeSourceFile, calculateCoverage, classifyDeclaration, coverageLevelSchema, coverageSummarySchema, declarationCoverageSchema, getDeclarationKind, getDeclarationName, isExportedDeclaration, packageCoverageSchema, printCheckTsdocHuman, resolveJsonMode, runCheckTsdoc, tsDocCheckResultSchema } from "../shared/@outfitter/tooling-njw4z34x.js";
+export { tsDocCheckResultSchema, runCheckTsdoc, resolveJsonMode, printCheckTsdocHuman, packageCoverageSchema, isExportedDeclaration, getDeclarationName, getDeclarationKind, declarationCoverageSchema, coverageSummarySchema, coverageLevelSchema, classifyDeclaration, calculateCoverage, analyzeSourceFile, analyzeCheckTsdoc, TsDocCheckResult, PackageCoverage, DeclarationCoverage, CoverageSummary, CoverageLevel, CheckTsDocOptions };

package/dist/cli/check-tsdoc.js

@@ -0,0 +1,36 @@
+// @bun
+import {
+  analyzeCheckTsdoc,
+  analyzeSourceFile,
+  calculateCoverage,
+  classifyDeclaration,
+  coverageLevelSchema,
+  coverageSummarySchema,
+  declarationCoverageSchema,
+  getDeclarationKind,
+  getDeclarationName,
+  isExportedDeclaration,
+  packageCoverageSchema,
+  printCheckTsdocHuman,
+  resolveJsonMode,
+  runCheckTsdoc,
+  tsDocCheckResultSchema
+} from "../shared/@outfitter/tooling-qk5xgmxr.js";
+import"../shared/@outfitter/tooling-dvwh9qve.js";
+export {
+  tsDocCheckResultSchema,
+  runCheckTsdoc,
+  resolveJsonMode,
+  printCheckTsdocHuman,
+  packageCoverageSchema,
+  isExportedDeclaration,
+  getDeclarationName,
+  getDeclarationKind,
+  declarationCoverageSchema,
+  coverageSummarySchema,
+  coverageLevelSchema,
+  classifyDeclaration,
+  calculateCoverage,
+  analyzeSourceFile,
+  analyzeCheckTsdoc
+};