outfitter 0.2.5 → 0.2.7

package/README.md

@@ -40,8 +40,7 @@ Top-level commands:
 - `scaffold <target> [name]` - Add a new capability to an existing project
 - `add <block>` - Add a tooling block (`claude`, `biome`, `lefthook`, `bootstrap`, `scaffolding`)
 - `repo <action> <subject>` - Repository maintenance namespace (`check|sync|export`)
-- `migrate kit [directory]` - Migrate foundation imports and dependencies to `@outfitter/kit`
-- `update` - Check installed `@outfitter/*` versions and optionally show migration guidance
+- `upgrade` - Check installed `@outfitter/*` versions and optionally show migration guidance
 - `doctor` - Validate local environment and project dependencies
 - `demo [section]` - Forward to the dedicated demo CLI (`outfitter-demo`)
 
@@ -165,44 +164,28 @@ outfitter repo check exports --json
 outfitter repo check readme
 ```
 
-### `migrate kit`
-
-Codemod for kit-first foundation adoption.
-
-```bash
-outfitter migrate kit [directory] [options]
-```
-
-Options:
-
-- `--dry-run` - Preview changes without writing files
-
-Examples:
-
-```bash
-outfitter migrate kit --dry-run
-outfitter migrate kit .
-```
-
-### `update`
+### `upgrade`
 
 Check installed `@outfitter/*` packages against npm versions.
 
 ```bash
-outfitter update [options]
+outfitter upgrade [options]
 ```
 
 Options:
 
 - `--guide` - Include composed migration guidance
+- `--all` - Include breaking changes
+- `--dry-run` - Preview without making changes
+- `--yes` - Skip interactive prompts
 - `--cwd <path>` - Working directory to inspect
 
 Examples:
 
 ```bash
-outfitter update
-outfitter update --guide
-outfitter update --json --cwd .
+outfitter upgrade
+outfitter upgrade --guide
+outfitter upgrade --json --cwd .
 ```
 
 ### `doctor`
@@ -228,10 +211,58 @@ Options:
 
 Use `outfitter-demo` (or `cli-demo`) directly for the dedicated demo app.
 
+### `schema`
+
+Machine-readable introspection of registered actions. Agents can discover CLI capabilities without scraping `--help`.
+
+```bash
+outfitter schema                          # Human-readable summary
+outfitter schema <action-id>              # Detail view for a single action
+outfitter schema --output json            # Machine-readable JSON manifest
+outfitter schema --output json --pretty   # Pretty-printed JSON
+outfitter schema --surface cli            # Filter by surface
+```
+
+Subcommands for surface map management:
+
+```bash
+outfitter schema generate                 # Write .outfitter/surface.json
+outfitter schema generate --dry-run       # Print without writing
+outfitter schema diff                     # Compare runtime vs committed
+outfitter schema diff --output json       # Structured diff as JSON
+```
+
+### `check`
+
+Compare local config blocks against the registry for drift detection.
+
+```bash
+outfitter check [options]
+outfitter check tsdoc [options]
+```
+
+Options:
+
+- `-v, --verbose` - Show diffs for drifted files
+- `-b, --block <name>` - Check a specific block only
+- `-o, --output <mode>` - Output mode (`human`, `json`, `jsonl`)
+- `--cwd <path>` - Working directory
+
+`check tsdoc` checks TSDoc coverage on exported declarations:
+
+```bash
+outfitter check tsdoc                     # Human-readable coverage report
+outfitter check tsdoc --strict            # Fail if coverage is below threshold
+outfitter check tsdoc --output json       # Machine-readable JSON output
+outfitter check tsdoc --summary           # Compact output
+outfitter check tsdoc --level undocumented # Filter by coverage level
+outfitter check tsdoc --package @outfitter/cli # Filter to specific package
+```
+
 ## Command Conventions
 
 Canonical boundary and command conventions are documented in
-[`docs/BOUNDARY-CONVENTIONS.md`](../../docs/BOUNDARY-CONVENTIONS.md).
+[Architecture: Boundary Conventions](../../docs/ARCHITECTURE.md#boundary-conventions).
 
 Quick model status:
 
@@ -247,10 +278,8 @@ Root exports:
 import {
   runDoctor,
   runInit,
-  runMigrateKit,
   runScaffold,
   type InitOptions,
-  type MigrateKitOptions,
   type ScaffoldOptions,
 } from "outfitter";
 ```
@@ -259,7 +288,7 @@ Command subpath exports:
 
 ```typescript
 import { runAdd } from "outfitter/commands/add";
-import { runUpdate } from "outfitter/commands/update";
+import { runUpgrade } from "outfitter/commands/upgrade";
 ```
 
 Example:
@@ -281,7 +310,7 @@ if (result.isErr()) {
 
 ## Requirements
 
-- Bun >= 1.3.7
+- Bun >= 1.3.9
 
 ## Related Packages
 

package/dist/actions.d.ts

@@ -0,0 +1,2 @@
+import { outfitterActions } from "./shared/outfitter-6bkqjk86.js";
+export { outfitterActions };

package/dist/actions.js

@@ -0,0 +1,35 @@
+// @bun
+import {
+  outfitterActions
+} from "./shared/outfitter-7ch26yq8.js";
+import"./shared/outfitter-pj9vp00r.js";
+import"./shared/outfitter-mt7d1ek2.js";
+import"./shared/outfitter-ksyvwmb5.js";
+import"./shared/outfitter-w1j80j1r.js";
+import"./shared/outfitter-5y646xzk.js";
+import"./shared/outfitter-63gse8fv.js";
+import"./shared/outfitter-pcj9gg2g.js";
+import"./shared/outfitter-bpr28y54.js";
+import"./shared/outfitter-yvksv5qb.js";
+import"./shared/outfitter-4s9meh3j.js";
+import"./shared/outfitter-ehp18x1n.js";
+import"./shared/outfitter-xe5mzgdc.js";
+import"./shared/outfitter-1h7k8xxt.js";
+import"./shared/outfitter-ttjr95y9.js";
+import"./shared/outfitter-344t1r38.js";
+import"./shared/outfitter-5akzvppx.js";
+import"./shared/outfitter-ha89qf8q.js";
+import"./shared/outfitter-20f6a2n4.js";
+import"./shared/outfitter-m44n0qzw.js";
+import"./shared/outfitter-9x1brcmq.js";
+import"./shared/outfitter-j833sxws.js";
+import"./shared/outfitter-79vfxt6y.js";
+import"./shared/outfitter-1fy7byz5.js";
+import"./shared/outfitter-4q1zfmvc.js";
+import"./shared/outfitter-8y2dfx6n.js";
+import"./shared/outfitter-mtbpabf3.js";
+import"./shared/outfitter-7r12fj7f.js";
+import"./shared/outfitter-mdt37hqm.js";
+export {
+  outfitterActions
+};

package/dist/cli.js

@@ -2,7 +2,7 @@
 import {
   createRepoCommand,
   outfitterActions
-} from "./shared/chunk-tpwtpa74.js";
+} from "./shared/chunk-x6644tk8.js";
 
 // src/cli.ts
 import { readFileSync } from "node:fs";
@@ -43,7 +43,8 @@ function createProgram() {
         requestId,
         logger: logger.child({ action: action.id, requestId })
       });
-    }
+    },
+    schema: { programName: "outfitter", surface: {} }
   })) {
     cli.register(command);
   }

package/dist/commands/add.d.ts

@@ -0,0 +1,54 @@
+import { OutputMode } from "@outfitter/cli/types";
+import { Result } from "@outfitter/contracts";
+import { AddBlockResult } from "@outfitter/tooling";
+/**
+* Input for the add command.
+*/
+interface AddInput {
+	/** Block name to add */
+	readonly block: string;
+	/** Working directory (defaults to cwd) */
+	readonly cwd?: string;
+	/** Show what would be done without making changes */
+	readonly dryRun: boolean;
+	/** Overwrite existing files */
+	readonly force: boolean;
+}
+/**
+* Error returned when adding a block fails.
+*/
+declare class AddError extends Error {
+	readonly _tag: "AddError";
+	constructor(message: string);
+}
+/**
+* Runs the add command programmatically.
+*
+* @param input - Add command input
+* @returns Result with details of what was added
+*
+* @example
+* ```typescript
+* const result = await runAdd({
+*   block: "scaffolding",
+*   force: false,
+*   dryRun: false,
+* });
+*
+* if (result.isOk()) {
+*   console.log(`Created ${result.value.created.length} files`);
+* }
+* ```
+*/
+declare function runAdd(input: AddInput): Promise<Result<AddBlockResult, AddError>>;
+/**
+* Prints the results of the add command.
+*/
+declare function printAddResults(result: AddBlockResult, dryRun: boolean, options?: {
+	mode?: OutputMode;
+}): Promise<void>;
+/**
+* Lists available blocks.
+*/
+declare function listBlocks(): Result<string[], AddError>;
+export { runAdd, printAddResults, listBlocks, AddInput, AddError };

package/dist/commands/add.js

@@ -0,0 +1,16 @@
+// @bun
+import {
+  AddError,
+  listBlocks,
+  printAddResults,
+  runAdd
+} from "../shared/outfitter-79vfxt6y.js";
+import"../shared/outfitter-mtbpabf3.js";
+import"../shared/outfitter-7r12fj7f.js";
+import"../shared/outfitter-mdt37hqm.js";
+export {
+  runAdd,
+  printAddResults,
+  listBlocks,
+  AddError
+};

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

@@ -0,0 +1,22 @@
+import { CliOutputMode } from "../shared/outfitter-a79xrm12.js";
+import { Result } from "@outfitter/contracts";
+import { CoverageLevel, TsDocCheckResult } from "@outfitter/tooling";
+/** Validated input for the check-tsdoc action handler. */
+interface CheckTsDocInput {
+	readonly cwd: string;
+	readonly jq: string | undefined;
+	readonly level: CoverageLevel | undefined;
+	readonly minCoverage: number;
+	readonly outputMode: CliOutputMode;
+	readonly packages: readonly string[];
+	readonly strict: boolean;
+	readonly summary: boolean;
+}
+/**
+* Run TSDoc coverage analysis and format output.
+*
+* @param input - Validated action input
+* @returns Result containing the coverage analysis
+*/
+declare function runCheckTsdoc(input: CheckTsDocInput): Promise<Result<TsDocCheckResult, Error>>;
+export { runCheckTsdoc, CheckTsDocInput };

package/dist/commands/check-tsdoc.js

@@ -0,0 +1,8 @@
+// @bun
+import {
+  runCheckTsdoc
+} from "../shared/outfitter-63gse8fv.js";
+import"../shared/outfitter-mdt37hqm.js";
+export {
+  runCheckTsdoc
+};

package/dist/commands/check.d.ts

@@ -0,0 +1,91 @@
+import { OutputMode } from "@outfitter/cli/types";
+import { Result } from "@outfitter/contracts";
+/**
+* Options for the check command.
+*/
+interface CheckOptions {
+	/** Check a specific block only. */
+	readonly block?: string;
+	/** Machine-oriented output for CI. */
+	readonly ci?: boolean;
+	/** Working directory to check. */
+	readonly cwd: string;
+	/** Output mode override. */
+	readonly outputMode?: OutputMode;
+	/** Show diff information for drifted files. */
+	readonly verbose?: boolean;
+}
+/**
+* Information about a drifted file (included in verbose mode).
+*/
+interface DriftedFileInfo {
+	/** File path relative to project root. */
+	readonly path: string;
+	/** Reason for drift classification. */
+	readonly reason: "modified" | "missing";
+}
+/**
+* Status of a single block after comparison.
+*/
+interface BlockCheckStatus {
+	/** Current tooling version providing the registry. */
+	readonly currentToolingVersion?: string;
+	/** Drifted file details (populated when verbose is true). */
+	readonly driftedFiles?: DriftedFileInfo[];
+	/** Tooling version the block was installed from. */
+	readonly installedFrom?: string;
+	/** Block name. */
+	readonly name: string;
+	/** Comparison result. */
+	readonly status: "current" | "drifted" | "missing";
+}
+/**
+* Complete result of the check command.
+*/
+interface CheckResult {
+	/** Per-block comparison results. */
+	readonly blocks: BlockCheckStatus[];
+	/** Number of blocks matching the registry. */
+	readonly currentCount: number;
+	/** Number of blocks with local modifications. */
+	readonly driftedCount: number;
+	/** Number of blocks with missing files. */
+	readonly missingCount: number;
+	/** Number of blocks checked. */
+	readonly totalChecked: number;
+}
+/**
+* Error returned when the check command fails.
+*/
+declare class CheckError extends Error {
+	readonly _tag: "CheckError";
+	constructor(message: string);
+}
+/**
+* Runs the check command programmatically.
+*
+* Reads the manifest (or falls back to file-presence heuristic) and
+* compares each installed block against the registry.
+*
+* @param options - Check command options
+* @returns Result with per-block comparison statuses
+*
+* @example
+* ```typescript
+* const result = await runCheck({ cwd: process.cwd() });
+* if (result.isOk()) {
+*   if (result.value.driftedCount > 0) {
+*     console.log("Some blocks have drifted from the registry");
+*   }
+* }
+* ```
+*/
+declare function runCheck(options: CheckOptions): Promise<Result<CheckResult, CheckError>>;
+/**
+* Formats and outputs check results.
+*/
+declare function printCheckResults(result: CheckResult, options?: {
+	mode?: OutputMode;
+	verbose?: boolean;
+}): Promise<void>;
+export { runCheck, printCheckResults, DriftedFileInfo, CheckResult, CheckOptions, CheckError, BlockCheckStatus };

package/dist/commands/check.js

@@ -0,0 +1,14 @@
+// @bun
+import {
+  CheckError,
+  printCheckResults,
+  runCheck
+} from "../shared/outfitter-w1j80j1r.js";
+import"../shared/outfitter-mtbpabf3.js";
+import"../shared/outfitter-7r12fj7f.js";
+import"../shared/outfitter-mdt37hqm.js";
+export {
+  runCheck,
+  printCheckResults,
+  CheckError
+};

package/dist/commands/demo.d.ts

@@ -0,0 +1,21 @@
+import { CliOutputMode } from "../shared/outfitter-a79xrm12.js";
+/**
+* Options for forwarding to the demo CLI.
+*/
+interface DemoOptions {
+	readonly animate?: boolean | undefined;
+	readonly list?: boolean | undefined;
+	readonly outputMode: CliOutputMode;
+	readonly section?: string | undefined;
+}
+/**
+* Result of forwarding the demo command.
+*/
+interface DemoResult {
+	readonly exitCode: number;
+}
+/**
+* Runs the demo command through available entrypoints.
+*/
+declare function runDemo(options: DemoOptions): Promise<DemoResult>;
+export { runDemo, DemoResult, DemoOptions };

package/dist/commands/demo.js

@@ -0,0 +1,8 @@
+// @bun
+import {
+  runDemo
+} from "../shared/outfitter-ksyvwmb5.js";
+import"../shared/outfitter-mdt37hqm.js";
+export {
+  runDemo
+};

package/dist/commands/docs-module-loader.d.ts

@@ -0,0 +1,2 @@
+import { CreateDocsCommandOptions, DocsCommandIo, DocsExportTarget, ExecuteCheckCommandOptions, ExecuteExportCommandOptions, ExecuteSyncCommandOptions, loadDocsModule } from "../shared/outfitter-6fgk6adm.js";
+export { loadDocsModule, ExecuteSyncCommandOptions, ExecuteExportCommandOptions, ExecuteCheckCommandOptions, DocsExportTarget, DocsCommandIo, CreateDocsCommandOptions };

package/dist/commands/docs-module-loader.js

@@ -0,0 +1,8 @@
+// @bun
+import {
+  loadDocsModule
+} from "../shared/outfitter-zwyvewr1.js";
+import"../shared/outfitter-mdt37hqm.js";
+export {
+  loadDocsModule
+};

package/dist/commands/doctor.d.ts

@@ -0,0 +1,2 @@
+import { BunVersionCheck, CheckResult, ConfigFilesCheck, DependenciesCheck, DirectoriesCheck, DoctorOptions, DoctorResult, DoctorSummary, PackageJsonCheck, WorkspaceMemberHealth, doctorCommand, printDoctorResults, runDoctor } from "../shared/outfitter-hsp8vy5m.js";
+export { runDoctor, printDoctorResults, doctorCommand, WorkspaceMemberHealth, PackageJsonCheck, DoctorSummary, DoctorResult, DoctorOptions, DirectoriesCheck, DependenciesCheck, ConfigFilesCheck, CheckResult, BunVersionCheck };

package/dist/commands/doctor.js

@@ -0,0 +1,25 @@
+// @bun
+import {
+  doctorCommand,
+  printDoctorResults,
+  runDoctor
+} from "../shared/outfitter-5y646xzk.js";
+import"../shared/outfitter-344t1r38.js";
+import"../shared/outfitter-5akzvppx.js";
+import"../shared/outfitter-ha89qf8q.js";
+import"../shared/outfitter-20f6a2n4.js";
+import"../shared/outfitter-m44n0qzw.js";
+import"../shared/outfitter-9x1brcmq.js";
+import"../shared/outfitter-j833sxws.js";
+import"../shared/outfitter-79vfxt6y.js";
+import"../shared/outfitter-1fy7byz5.js";
+import"../shared/outfitter-4q1zfmvc.js";
+import"../shared/outfitter-8y2dfx6n.js";
+import"../shared/outfitter-mtbpabf3.js";
+import"../shared/outfitter-7r12fj7f.js";
+import"../shared/outfitter-mdt37hqm.js";
+export {
+  runDoctor,
+  printDoctorResults,
+  doctorCommand
+};

package/dist/commands/init.d.ts

@@ -0,0 +1,7 @@
+import { InitError, InitOptions, InitPresetId, InitResult, InitStructure, initCommand, printInitResults, runInit } from "../shared/outfitter-z0we32cp.js";
+import "../shared/outfitter-z5sx06qe.js";
+import "../shared/outfitter-y784nh31.js";
+import "../shared/outfitter-s7jetkge.js";
+import "../shared/outfitter-r419zfgs.js";
+import "../shared/outfitter-amc4jbs1.js";
+export { runInit, printInitResults, initCommand, InitStructure, InitResult, InitPresetId, InitOptions, InitError };

package/dist/commands/init.js

@@ -0,0 +1,32 @@
+// @bun
+import {
+  InitError,
+  initCommand,
+  printInitResults,
+  runInit
+} from "../shared/outfitter-mt7d1ek2.js";
+import"../shared/outfitter-4s9meh3j.js";
+import"../shared/outfitter-ehp18x1n.js";
+import"../shared/outfitter-xe5mzgdc.js";
+import"../shared/outfitter-1h7k8xxt.js";
+import"../shared/outfitter-ttjr95y9.js";
+import"../shared/outfitter-344t1r38.js";
+import"../shared/outfitter-5akzvppx.js";
+import"../shared/outfitter-ha89qf8q.js";
+import"../shared/outfitter-20f6a2n4.js";
+import"../shared/outfitter-m44n0qzw.js";
+import"../shared/outfitter-9x1brcmq.js";
+import"../shared/outfitter-j833sxws.js";
+import"../shared/outfitter-79vfxt6y.js";
+import"../shared/outfitter-1fy7byz5.js";
+import"../shared/outfitter-4q1zfmvc.js";
+import"../shared/outfitter-8y2dfx6n.js";
+import"../shared/outfitter-mtbpabf3.js";
+import"../shared/outfitter-7r12fj7f.js";
+import"../shared/outfitter-mdt37hqm.js";
+export {
+  runInit,
+  printInitResults,
+  initCommand,
+  InitError
+};

package/dist/commands/repo.d.ts

@@ -0,0 +1,3 @@
+import { CreateRepoCommandOptions, RepoCheckSubject, RepoCommandIo, RepoToolingInvocation, createRepoCommand } from "../shared/outfitter-5yjr404v.js";
+import "../shared/outfitter-6fgk6adm.js";
+export { createRepoCommand, RepoToolingInvocation, RepoCommandIo, RepoCheckSubject, CreateRepoCommandOptions };

package/dist/commands/repo.js

@@ -0,0 +1,9 @@
+// @bun
+import {
+  createRepoCommand
+} from "../shared/outfitter-bn9c8p2e.js";
+import"../shared/outfitter-zwyvewr1.js";
+import"../shared/outfitter-mdt37hqm.js";
+export {
+  createRepoCommand
+};

package/dist/commands/scaffold.d.ts

@@ -0,0 +1,4 @@
+import { ScaffoldCommandError, ScaffoldCommandResult, ScaffoldOptions, printScaffoldResults, runScaffold, scaffoldCommand } from "../shared/outfitter-h3q6ae6d.js";
+import "../shared/outfitter-z5sx06qe.js";
+import "../shared/outfitter-amc4jbs1.js";
+export { scaffoldCommand, runScaffold, printScaffoldResults, ScaffoldOptions, ScaffoldCommandResult, ScaffoldCommandError };

package/dist/commands/scaffold.js

@@ -0,0 +1,32 @@
+// @bun
+import {
+  ScaffoldCommandError,
+  printScaffoldResults,
+  runScaffold,
+  scaffoldCommand
+} from "../shared/outfitter-pj9vp00r.js";
+import"../shared/outfitter-4s9meh3j.js";
+import"../shared/outfitter-ehp18x1n.js";
+import"../shared/outfitter-xe5mzgdc.js";
+import"../shared/outfitter-1h7k8xxt.js";
+import"../shared/outfitter-ttjr95y9.js";
+import"../shared/outfitter-344t1r38.js";
+import"../shared/outfitter-5akzvppx.js";
+import"../shared/outfitter-ha89qf8q.js";
+import"../shared/outfitter-20f6a2n4.js";
+import"../shared/outfitter-m44n0qzw.js";
+import"../shared/outfitter-9x1brcmq.js";
+import"../shared/outfitter-j833sxws.js";
+import"../shared/outfitter-79vfxt6y.js";
+import"../shared/outfitter-1fy7byz5.js";
+import"../shared/outfitter-4q1zfmvc.js";
+import"../shared/outfitter-8y2dfx6n.js";
+import"../shared/outfitter-mtbpabf3.js";
+import"../shared/outfitter-7r12fj7f.js";
+import"../shared/outfitter-mdt37hqm.js";
+export {
+  scaffoldCommand,
+  runScaffold,
+  printScaffoldResults,
+  ScaffoldCommandError
+};

package/dist/commands/shared-deps.d.ts

@@ -0,0 +1,21 @@
+/**
+* Shared devDependencies injected into all scaffolded projects.
+* Template-specific devDependencies take precedence over these defaults.
+*
+* Keep these in sync with the root package.json versions.
+*/
+declare const SHARED_DEV_DEPS: Readonly<Record<string, string>>;
+/**
+* Shared scripts injected into all scaffolded projects.
+* Template-specific scripts take precedence over these defaults.
+*/
+declare const SHARED_SCRIPTS: {
+	readonly check: "ultracite check";
+	readonly "clean:artifacts": "rm -rf dist .turbo";
+	readonly "verify:ci": "bun run typecheck && bun run check && bun run build && bun run test";
+	readonly lint: "biome check .";
+	readonly "lint:fix": "biome check . --write";
+	readonly format: "biome format --write .";
+	readonly typecheck: "tsc --noEmit";
+};
+export { SHARED_SCRIPTS, SHARED_DEV_DEPS };

package/dist/commands/shared-deps.js

@@ -0,0 +1,11 @@
+// @bun
+import {
+  SHARED_DEV_DEPS,
+  SHARED_SCRIPTS
+} from "../shared/outfitter-20f6a2n4.js";
+import"../shared/outfitter-m44n0qzw.js";
+import"../shared/outfitter-mdt37hqm.js";
+export {
+  SHARED_SCRIPTS,
+  SHARED_DEV_DEPS
+};

package/dist/commands/upgrade-codemods.d.ts

@@ -0,0 +1,42 @@
+import { OutfitterError } from "@outfitter/contracts";
+import { Result } from "@outfitter/contracts";
+/** Options passed to a codemod's transform function. */
+interface CodemodOptions {
+	readonly dryRun: boolean;
+	readonly targetDir: string;
+}
+/** Result returned by a codemod's transform function. */
+interface CodemodResult {
+	readonly changedFiles: readonly string[];
+	readonly errors: readonly string[];
+	readonly skippedFiles: readonly string[];
+}
+/** A discovered codemod with resolved paths. */
+interface DiscoveredCodemod {
+	/** Absolute path to the codemod file. */
+	readonly absolutePath: string;
+	/** Path relative to the codemods directory. */
+	readonly relativePath: string;
+}
+/**
+* Find the codemods directory, checking known locations.
+*
+* Searches:
+* 1. Relative to the target cwd
+* 2. Walking up parent directories from cwd (monorepo root detection)
+* 3. Relative to the outfitter binary itself (development mode)
+*/
+declare function findCodemodsDir(cwd: string, binaryDir?: string): string | null;
+/**
+* Discover codemods referenced in migration docs for a package version range.
+*
+* Scans migration doc frontmatter for `codemod` references in the `changes`
+* array, resolves them to absolute paths in the codemods directory, and
+* deduplicates.
+*/
+declare function discoverCodemods(migrationsDir: string, codemodsDir: string, shortName: string, fromVersion: string, toVersion: string): DiscoveredCodemod[];
+/**
+* Run a single codemod by importing and executing its `transform` function.
+*/
+declare function runCodemod(codemodPath: string, targetDir: string, dryRun: boolean): Promise<Result<CodemodResult, OutfitterError>>;
+export { runCodemod, findCodemodsDir, discoverCodemods, DiscoveredCodemod, CodemodResult, CodemodOptions };