@outfitter/tooling 0.2.4 → 0.3.3

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

@@ -1,64 +0,0 @@
-/**
-* 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[];
-}
-/**
-* Extract unique package names from changed file paths.
-*
-* Only considers files matching the pattern "packages/NAME/src/..." and
-* ignores apps/, root files, and package-level config.
-*
-* @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 a changeset is required and present.
-*
-* Returns `ok: true` when either no packages were changed or at least one
-* changeset file exists. Returns `ok: false` with the list of changed
-* packages when changesets are missing.
-*
-* @param changedPackages - Package names with source changes
-* @param changesetFiles - Changeset filenames found in `.changeset/`
-*/
-declare function checkChangesetRequired(changedPackages: string[], changesetFiles: string[]): ChangesetCheckResult;
-interface CheckChangesetOptions {
-	readonly skip?: boolean;
-}
-/**
-* Run check-changeset to verify PRs include changeset files.
-*
-* Uses `git diff --name-only origin/main...HEAD` to detect changed files,
-* then checks for changeset presence when package source files are modified.
-*
-* 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, getChangedPackagePaths, getChangedChangesetFiles, checkChangesetRequired, CheckChangesetOptions, ChangesetCheckResult };

package/dist/cli/check-changeset.js

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

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

@@ -1,36 +0,0 @@
-/**
-* 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

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

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

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

package/dist/cli/check-exports.js

@@ -1,14 +0,0 @@
-// @bun
-import {
-  compareExports,
-  entryToSubpath,
-  resolveJsonMode,
-  runCheckExports
-} 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,61 +0,0 @@
-import { ExportMap } from "../shared/@outfitter/tooling-wesswf21";
-/** An import example extracted from a markdown code block */
-interface ImportExample {
-	/** Package name, e.g. "@outfitter/cli" */
-	readonly packageName: string;
-	/** Export subpath, e.g. "./output" or "." */
-	readonly subpath: string;
-	/** Full import specifier, e.g. "@outfitter/cli/output" */
-	readonly fullSpecifier: string;
-	/** File where the import was found */
-	readonly file: string;
-	/** 1-based line number */
-	readonly line: number;
-}
-/** Result of checking imports in a single file */
-interface ImportCheckResult {
-	readonly file: string;
-	readonly valid: ImportExample[];
-	readonly invalid: ImportExample[];
-}
-/**
-* Parse a full import specifier into package name and subpath.
-*
-* Only recognizes `@outfitter/*` scoped packages.
-*
-* @example
-* parseSpecifier("@outfitter/cli/output")
-* // { packageName: "@outfitter/cli", subpath: "./output" }
-*
-* parseSpecifier("@outfitter/contracts")
-* // { packageName: "@outfitter/contracts", subpath: "." }
-*/
-declare function parseSpecifier(specifier: string): {
-	packageName: string;
-	subpath: string;
-} | null;
-/**
-* Extract import specifiers from markdown content.
-*
-* Only extracts imports from fenced code blocks (typescript, ts,
-* javascript, js). Skips blocks preceded by a non-contractual HTML comment.
-* Deduplicates by full specifier within a single file.
-*/
-declare function extractImports(content: string, file: string): ImportExample[];
-/**
-* Check whether a subpath exists in a package.json map.
-*/
-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.
-*
-* Finds README.md files in `packages/` and `docs/packages/`, extracts
-* import examples, and validates each subpath against the corresponding
-* package.json exports.
-*/
-declare function runCheckReadmeImports(options?: CheckReadmeImportsOptions): Promise<void>;
-export { runCheckReadmeImports, resolveJsonMode, parseSpecifier, isExportedSubpath, extractImports, ImportExample, ImportCheckResult, ExportMap, CheckReadmeImportsOptions };

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

@@ -1,198 +0,0 @@
-// @bun
-import"../shared/@outfitter/tooling-dvwh9qve.js";
-
-// packages/tooling/src/cli/check-readme-imports.ts
-import { resolve } from "path";
-function parseSpecifier(specifier) {
-  if (!specifier.startsWith("@outfitter/")) {
-    return null;
-  }
-  const parts = specifier.split("/");
-  if (parts.length < 2) {
-    return null;
-  }
-  const packageName = `${parts[0]}/${parts[1]}`;
-  const rest = parts.slice(2);
-  if (rest.length === 0) {
-    return { packageName, subpath: "." };
-  }
-  return { packageName, subpath: `./${rest.join("/")}` };
-}
-function extractImports(content, file) {
-  const lines = content.split(`
-`);
-  const results = [];
-  const seen = new Set;
-  const CODE_FENCE_OPEN = /^```(?:typescript|ts|javascript|js)\s*$/;
-  const CODE_FENCE_CLOSE = /^```\s*$/;
-  const IMPORT_RE = /from\s+["'](@outfitter\/[^"']+)["']/;
-  const NON_CONTRACTUAL = /<!--\s*non-contractual\s*-->/;
-  let inCodeBlock = false;
-  let skipBlock = false;
-  for (let i = 0;i < lines.length; i++) {
-    const line = lines[i];
-    if (!inCodeBlock) {
-      if (CODE_FENCE_OPEN.test(line)) {
-        inCodeBlock = true;
-        skipBlock = false;
-        for (let j = i - 1;j >= 0; j--) {
-          const prev = lines[j].trim();
-          if (prev === "")
-            continue;
-          if (NON_CONTRACTUAL.test(prev)) {
-            skipBlock = true;
-          }
-          break;
-        }
-      }
-      continue;
-    }
-    if (CODE_FENCE_CLOSE.test(line) && !CODE_FENCE_OPEN.test(line)) {
-      inCodeBlock = false;
-      skipBlock = false;
-      continue;
-    }
-    if (skipBlock)
-      continue;
-    const match = IMPORT_RE.exec(line);
-    if (!match?.[1])
-      continue;
-    const fullSpecifier = match[1];
-    if (seen.has(fullSpecifier))
-      continue;
-    seen.add(fullSpecifier);
-    const parsed = parseSpecifier(fullSpecifier);
-    if (!parsed)
-      continue;
-    results.push({
-      packageName: parsed.packageName,
-      subpath: parsed.subpath,
-      fullSpecifier,
-      file,
-      line: i + 1
-    });
-  }
-  return results;
-}
-function isExportedSubpath(subpath, exports) {
-  return subpath in exports;
-}
-var COLORS = {
-  reset: "\x1B[0m",
-  red: "\x1B[31m",
-  green: "\x1B[32m",
-  yellow: "\x1B[33m",
-  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");
-  const readmeDirs = ["packages", "docs/packages"];
-  const readmePaths = [];
-  for (const dir of readmeDirs) {
-    const fullDir = resolve(cwd, dir);
-    try {
-      for (const match of readmeGlob.scanSync({ cwd: fullDir, dot: false })) {
-        const segments = match.split("/");
-        if (segments.length === 2 && segments[1] === "README.md") {
-          readmePaths.push(resolve(fullDir, match));
-        }
-      }
-    } catch {}
-  }
-  if (readmePaths.length === 0) {
-    process.stdout.write(`No README.md files found.
-`);
-    return;
-  }
-  const exportsCache = new Map;
-  async function getExportsForPackage(packageName) {
-    if (exportsCache.has(packageName)) {
-      return exportsCache.get(packageName) ?? null;
-    }
-    const shortName = packageName.replace("@outfitter/", "");
-    const pkgPath = resolve(cwd, "packages", shortName, "package.json");
-    try {
-      const pkg = await Bun.file(pkgPath).json();
-      const exports = typeof pkg.exports === "object" && pkg.exports !== null ? pkg.exports : {};
-      exportsCache.set(packageName, exports);
-      return exports;
-    } catch {
-      return null;
-    }
-  }
-  const results = [];
-  let hasInvalid = false;
-  for (const readmePath of readmePaths.sort()) {
-    const content = await Bun.file(readmePath).text();
-    const relativePath = readmePath.replace(`${cwd}/`, "");
-    const imports = extractImports(content, relativePath);
-    if (imports.length === 0)
-      continue;
-    const valid = [];
-    const invalid = [];
-    for (const imp of imports) {
-      const exports = await getExportsForPackage(imp.packageName);
-      if (exports === null) {
-        invalid.push(imp);
-        continue;
-      }
-      if (isExportedSubpath(imp.subpath, exports)) {
-        valid.push(imp);
-      } else {
-        invalid.push(imp);
-      }
-    }
-    if (valid.length > 0 || invalid.length > 0) {
-      results.push({ file: relativePath, valid, invalid });
-    }
-    if (invalid.length > 0) {
-      hasInvalid = true;
-    }
-  }
-  if (resolveJsonMode(options)) {
-    const output = {
-      ok: !hasInvalid,
-      files: results
-    };
-    process.stdout.write(`${JSON.stringify(output, null, 2)}
-`);
-  } else {
-    const totalValid = results.reduce((n, r) => n + r.valid.length, 0);
-    const totalInvalid = results.reduce((n, r) => n + r.invalid.length, 0);
-    if (!hasInvalid) {
-      process.stdout.write(`${COLORS.green}All ${totalValid} README import examples match package exports.${COLORS.reset}
-`);
-    } else {
-      process.stderr.write(`${COLORS.red}Invalid README import examples found:${COLORS.reset}
-
-`);
-      for (const result of results) {
-        if (result.invalid.length === 0)
-          continue;
-        process.stderr.write(`  ${COLORS.yellow}${result.file}${COLORS.reset}
-`);
-        for (const imp of result.invalid) {
-          process.stderr.write(`    ${COLORS.red}line ${imp.line}:${COLORS.reset} ${imp.fullSpecifier}  ${COLORS.dim}(subpath ${imp.subpath} not in ${imp.packageName} exports)${COLORS.reset}
-`);
-        }
-        process.stderr.write(`
-`);
-      }
-      process.stderr.write(`${totalInvalid} invalid, ${totalValid} valid across ${results.length} file(s).
-`);
-    }
-  }
-  process.exit(hasInvalid ? 1 : 0);
-}
-export {
-  runCheckReadmeImports,
-  resolveJsonMode,
-  parseSpecifier,
-  isExportedSubpath,
-  extractImports
-};

package/dist/cli/check.d.ts

@@ -1,19 +0,0 @@
-/**
-* 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

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

package/dist/cli/fix.d.ts

@@ -1,19 +0,0 @@
-/**
-* 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

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

package/dist/cli/init.d.ts

@@ -1,31 +0,0 @@
-/**
-* 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

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

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

@@ -1,41 +0,0 @@
-/**
-* Check if branch is a TDD RED phase branch
-*/
-declare function isRedPhaseBranch(branch: string): boolean;
-/**
-* Check if branch is a scaffold branch
-*/
-declare function isScaffoldBranch(branch: string): boolean;
-declare function isTestOnlyPath(path: string): boolean;
-declare function areFilesTestOnly(paths: readonly string[]): boolean;
-interface PushChangedFiles {
-	readonly files: readonly string[];
-	readonly deterministic: boolean;
-	readonly source: "upstream" | "baseRef" | "undetermined";
-}
-declare function canBypassRedPhaseByChangedFiles(changedFiles: PushChangedFiles): boolean;
-type ScriptMap = Readonly<Record<string, string | undefined>>;
-type VerificationPlan = {
-	readonly ok: true;
-	readonly scripts: readonly string[];
-	readonly source: "verify:ci" | "fallback";
-} | {
-	readonly ok: false;
-	readonly error: string;
-};
-/**
-* Derive strict pre-push verification from package scripts.
-*
-* Priority:
-* 1) `verify:ci`
-* 2) fallback sequence: `typecheck`, `check|lint`, `build`, `test`
-*/
-declare function createVerificationPlan(scripts: ScriptMap): VerificationPlan;
-interface PrePushOptions {
-	force?: boolean;
-}
-/**
-* Main pre-push command
-*/
-declare function runPrePush(options?: PrePushOptions): Promise<void>;
-export { runPrePush, isTestOnlyPath, isScaffoldBranch, isRedPhaseBranch, createVerificationPlan, canBypassRedPhaseByChangedFiles, areFilesTestOnly, VerificationPlan, PushChangedFiles, PrePushOptions };

package/dist/cli/pre-push.js

@@ -1,20 +0,0 @@
-// @bun
-import {
-  areFilesTestOnly,
-  canBypassRedPhaseByChangedFiles,
-  createVerificationPlan,
-  isRedPhaseBranch,
-  isScaffoldBranch,
-  isTestOnlyPath,
-  runPrePush
-} from "../shared/@outfitter/tooling-8sd32ts6.js";
-import"../shared/@outfitter/tooling-dvwh9qve.js";
-export {
-  runPrePush,
-  isTestOnlyPath,
-  isScaffoldBranch,
-  isRedPhaseBranch,
-  createVerificationPlan,
-  canBypassRedPhaseByChangedFiles,
-  areFilesTestOnly
-};

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

@@ -1,8 +0,0 @@
-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

@@ -1,8 +0,0 @@
-// @bun
-import {
-  runUpgradeBun
-} from "../shared/@outfitter/tooling-9yzd08v1.js";
-import"../shared/@outfitter/tooling-dvwh9qve.js";
-export {
-  runUpgradeBun
-};

package/dist/registry/build.d.ts

@@ -1,6 +0,0 @@
-import { RegistryBuildConfig } from "../shared/@outfitter/tooling-sjm8nebx";
-/**
-* Registry build configuration
-*/
-declare const REGISTRY_CONFIG: RegistryBuildConfig;
-export { REGISTRY_CONFIG };