outfitter 0.2.5 → 0.2.6

package/README.md

@@ -184,25 +184,28 @@ 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`

package/dist/actions.d.ts

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

package/dist/actions.js

@@ -0,0 +1,34 @@
+// @bun
+import {
+  outfitterActions
+} from "./shared/outfitter-rdc5v5ms.js";
+import"./shared/outfitter-mxz69pgy.js";
+import"./shared/outfitter-hws10ze7.js";
+import"./shared/outfitter-qn864k6h.js";
+import"./shared/outfitter-ehp18x1n.js";
+import"./shared/outfitter-1dd0k853.js";
+import"./shared/outfitter-9zqc2njf.js";
+import"./shared/outfitter-yvksv5qb.js";
+import"./shared/outfitter-d7pq7d0k.js";
+import"./shared/outfitter-bpr28y54.js";
+import"./shared/outfitter-ksyvwmb5.js";
+import"./shared/outfitter-1dvma85c.js";
+import"./shared/outfitter-4s9meh3j.js";
+import"./shared/outfitter-344t1r38.js";
+import"./shared/outfitter-2np85etz.js";
+import"./shared/outfitter-q9agarmb.js";
+import"./shared/outfitter-66b25bj8.js";
+import"./shared/outfitter-9x1brcmq.js";
+import"./shared/outfitter-j833sxws.js";
+import"./shared/outfitter-79vfxt6y.js";
+import"./shared/outfitter-mtbpabf3.js";
+import"./shared/outfitter-ttjr95y9.js";
+import"./shared/outfitter-7r12fj7f.js";
+import"./shared/outfitter-ara3djt0.js";
+import"./shared/outfitter-k112c427.js";
+import"./shared/outfitter-8y2dfx6n.js";
+import"./shared/outfitter-1h7k8xxt.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-k59f60cp.js";
 
 // src/cli.ts
 import { readFileSync } from "node:fs";

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;
+	/** Overwrite existing files */
+	readonly force: boolean;
+	/** Show what would be done without making changes */
+	readonly dryRun: boolean;
+	/** Working directory (defaults to cwd) */
+	readonly cwd?: string;
+}
+/**
+* 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.d.ts

@@ -0,0 +1,91 @@
+import { OutputMode } from "@outfitter/cli/types";
+import { Result } from "@outfitter/contracts";
+/**
+* Options for the check command.
+*/
+interface CheckOptions {
+	/** Working directory to check. */
+	readonly cwd: string;
+	/** Show diff information for drifted files. */
+	readonly verbose?: boolean;
+	/** Check a specific block only. */
+	readonly block?: string;
+	/** Machine-oriented output for CI. */
+	readonly ci?: boolean;
+	/** Output mode override. */
+	readonly outputMode?: OutputMode;
+}
+/**
+* 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 {
+	/** Block name. */
+	readonly name: string;
+	/** Comparison result. */
+	readonly status: "current" | "drifted" | "missing";
+	/** Tooling version the block was installed from. */
+	readonly installedFrom?: string;
+	/** Current tooling version providing the registry. */
+	readonly currentToolingVersion?: string;
+	/** Drifted file details (populated when verbose is true). */
+	readonly driftedFiles?: DriftedFileInfo[];
+}
+/**
+* Complete result of the check command.
+*/
+interface CheckResult {
+	/** Per-block comparison results. */
+	readonly blocks: BlockCheckStatus[];
+	/** Number of blocks checked. */
+	readonly totalChecked: number;
+	/** 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;
+}
+/**
+* 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-1dvma85c.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";
+/**
+* Options for forwarding to the demo CLI.
+*/
+interface DemoOptions {
+	readonly section?: string | undefined;
+	readonly list?: boolean | undefined;
+	readonly animate?: boolean | undefined;
+	readonly outputMode: CliOutputMode;
+}
+/**
+* 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-dd0btgec";
+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, doctorCommand, printDoctorResults, runDoctor } from "../shared/outfitter-pyy1zkfh";
+export { runDoctor, printDoctorResults, doctorCommand, PackageJsonCheck, DoctorSummary, DoctorResult, DoctorOptions, DirectoriesCheck, DependenciesCheck, ConfigFilesCheck, CheckResult, BunVersionCheck };

package/dist/commands/doctor.js

@@ -0,0 +1,13 @@
+// @bun
+import {
+  doctorCommand,
+  printDoctorResults,
+  runDoctor
+} from "../shared/outfitter-d7pq7d0k.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-bkwpbkr9";
+import "../shared/outfitter-y784nh31";
+import "../shared/outfitter-33w361tc";
+import "../shared/outfitter-k56rmt24";
+import "../shared/outfitter-3weh61w7";
+import "../shared/outfitter-amc4jbs1";
+export { runInit, printInitResults, initCommand, InitStructure, InitResult, InitPresetId, InitOptions, InitError };

package/dist/commands/init.js

@@ -0,0 +1,31 @@
+// @bun
+import {
+  InitError,
+  initCommand,
+  printInitResults,
+  runInit
+} from "../shared/outfitter-qn864k6h.js";
+import"../shared/outfitter-ehp18x1n.js";
+import"../shared/outfitter-1dd0k853.js";
+import"../shared/outfitter-4s9meh3j.js";
+import"../shared/outfitter-344t1r38.js";
+import"../shared/outfitter-2np85etz.js";
+import"../shared/outfitter-q9agarmb.js";
+import"../shared/outfitter-66b25bj8.js";
+import"../shared/outfitter-9x1brcmq.js";
+import"../shared/outfitter-j833sxws.js";
+import"../shared/outfitter-79vfxt6y.js";
+import"../shared/outfitter-mtbpabf3.js";
+import"../shared/outfitter-ttjr95y9.js";
+import"../shared/outfitter-7r12fj7f.js";
+import"../shared/outfitter-ara3djt0.js";
+import"../shared/outfitter-k112c427.js";
+import"../shared/outfitter-8y2dfx6n.js";
+import"../shared/outfitter-1h7k8xxt.js";
+import"../shared/outfitter-mdt37hqm.js";
+export {
+  runInit,
+  printInitResults,
+  initCommand,
+  InitError
+};

package/dist/commands/migrate-kit.d.ts

@@ -0,0 +1,2 @@
+import { MigrateKitError, MigrateKitOptions, MigrateKitResult, migrateKitCommand, printMigrateKitResults, runMigrateKit } from "../shared/outfitter-npemy7ta";
+export { runMigrateKit, printMigrateKitResults, migrateKitCommand, MigrateKitResult, MigrateKitOptions, MigrateKitError };

package/dist/commands/migrate-kit.js

@@ -0,0 +1,15 @@
+// @bun
+import {
+  MigrateKitError,
+  migrateKitCommand,
+  printMigrateKitResults,
+  runMigrateKit
+} from "../shared/outfitter-mxz69pgy.js";
+import"../shared/outfitter-7r12fj7f.js";
+import"../shared/outfitter-mdt37hqm.js";
+export {
+  runMigrateKit,
+  printMigrateKitResults,
+  migrateKitCommand,
+  MigrateKitError
+};

package/dist/commands/repo.d.ts

@@ -0,0 +1,3 @@
+import { CreateRepoCommandOptions, RepoCheckSubject, RepoCommandIo, RepoToolingInvocation, createRepoCommand } from "../shared/outfitter-j8yc7294";
+import "../shared/outfitter-dd0btgec";
+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-cwq39bv4";
+import "../shared/outfitter-3weh61w7";
+import "../shared/outfitter-amc4jbs1";
+export { scaffoldCommand, runScaffold, printScaffoldResults, ScaffoldOptions, ScaffoldCommandResult, ScaffoldCommandError };

package/dist/commands/scaffold.js

@@ -0,0 +1,31 @@
+// @bun
+import {
+  ScaffoldCommandError,
+  printScaffoldResults,
+  runScaffold,
+  scaffoldCommand
+} from "../shared/outfitter-hws10ze7.js";
+import"../shared/outfitter-ehp18x1n.js";
+import"../shared/outfitter-1dd0k853.js";
+import"../shared/outfitter-4s9meh3j.js";
+import"../shared/outfitter-344t1r38.js";
+import"../shared/outfitter-2np85etz.js";
+import"../shared/outfitter-q9agarmb.js";
+import"../shared/outfitter-66b25bj8.js";
+import"../shared/outfitter-9x1brcmq.js";
+import"../shared/outfitter-j833sxws.js";
+import"../shared/outfitter-79vfxt6y.js";
+import"../shared/outfitter-mtbpabf3.js";
+import"../shared/outfitter-ttjr95y9.js";
+import"../shared/outfitter-7r12fj7f.js";
+import"../shared/outfitter-ara3djt0.js";
+import"../shared/outfitter-k112c427.js";
+import"../shared/outfitter-8y2dfx6n.js";
+import"../shared/outfitter-1h7k8xxt.js";
+import"../shared/outfitter-mdt37hqm.js";
+export {
+  scaffoldCommand,
+  runScaffold,
+  printScaffoldResults,
+  ScaffoldCommandError
+};

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

@@ -0,0 +1,36 @@
+/**
+* Shared dependencies and scripts injected into all scaffolded projects.
+*
+* Edit this file to update versions across all templates. These are merged
+* with template-specific values, with template values taking precedence.
+*
+* @packageDocumentation
+*/
+/**
+* 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 "@biomejs/biome": "^2.3.12";
+	readonly "@outfitter/tooling": "^0.2.1";
+	readonly "@types/bun": "^1.3.7";
+	readonly lefthook: "^2.0.16";
+	readonly typescript: "^5.9.3";
+	readonly ultracite: "^7.1.1";
+};
+/**
+* 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,10 @@
+// @bun
+import {
+  SHARED_DEV_DEPS,
+  SHARED_SCRIPTS
+} from "../shared/outfitter-k112c427.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 targetDir: string;
+	readonly dryRun: boolean;
+}
+/** Result returned by a codemod's transform function. */
+interface CodemodResult {
+	readonly changedFiles: readonly string[];
+	readonly skippedFiles: readonly string[];
+	readonly errors: readonly string[];
+}
+/** A discovered codemod with resolved paths. */
+interface DiscoveredCodemod {
+	/** Path relative to the codemods directory. */
+	readonly relativePath: string;
+	/** Absolute path to the codemod file. */
+	readonly absolutePath: 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 };

package/dist/commands/upgrade-codemods.js

@@ -0,0 +1,15 @@
+// @bun
+import {
+  discoverCodemods,
+  findCodemodsDir,
+  runCodemod
+} from "../shared/outfitter-9zqc2njf.js";
+import"../shared/outfitter-yvksv5qb.js";
+import"../shared/outfitter-bpr28y54.js";
+import"../shared/outfitter-7r12fj7f.js";
+import"../shared/outfitter-mdt37hqm.js";
+export {
+  runCodemod,
+  findCodemodsDir,
+  discoverCodemods
+};

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

@@ -0,0 +1,58 @@
+/**
+* Pure, deterministic planner for the `outfitter upgrade` command.
+*
+* Classifies each installed package into one of four bump categories
+* based on the installed version, the latest available version, and
+* metadata about whether the bump contains breaking changes.
+*
+* Pre-1.0 packages (major version 0) treat minor bumps as breaking
+* per semver convention.
+*
+* @packageDocumentation
+*/
+/** Classification of a version bump for a single package. */
+type BumpClassification = "upToDate" | "upgradableNonBreaking" | "upgradableBreaking" | "blocked";
+/** Describes the planned action for a single package. */
+interface PackageUpgradeAction {
+	/** Full package name (e.g. "@outfitter/cli") */
+	readonly name: string;
+	/** Currently installed version */
+	readonly currentVersion: string;
+	/** Latest available version */
+	readonly latestVersion: string;
+	/** Bump classification */
+	readonly classification: BumpClassification;
+	/** Whether this update contains breaking changes */
+	readonly breaking: boolean;
+	/** Migration doc path if available */
+	readonly migrationDoc?: string;
+}
+/** The complete update plan with per-package actions and aggregate summary. */
+interface UpgradePlan {
+	/** Per-package update actions, sorted by name for deterministic output. */
+	readonly packages: PackageUpgradeAction[];
+	/** Aggregate counts by classification. */
+	readonly summary: {
+		readonly upToDate: number;
+		readonly upgradableNonBreaking: number;
+		readonly upgradableBreaking: number;
+		readonly blocked: number;
+	};
+}
+/**
+* Analyze installed packages against their latest versions and produce
+* a deterministic update plan.
+*
+* This function is **pure** — no side effects, no I/O, no process.env reads.
+* Same inputs always produce the same output.
+*
+* @param installed - Map of package name to currently installed version.
+* @param latest - Map of package name to latest version info (version string + breaking flag).
+* @param migrationDocs - Optional map of package name to migration doc path.
+* @returns A deterministic update plan with per-package actions and summary.
+*/
+declare function analyzeUpgrades(installed: Map<string, string>, latest: Map<string, {
+	version: string;
+	breaking?: boolean;
+}>, migrationDocs?: Map<string, string>): UpgradePlan;
+export { analyzeUpgrades, UpgradePlan, PackageUpgradeAction, BumpClassification };

package/dist/commands/upgrade-planner.js

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