@tractorcow/beefup 0.0.0 → 1.0.0

package/dist/commands/stage.js

@@ -0,0 +1,60 @@
+import path from "node:path";
+import { loadConfig } from "../config/load.js";
+import { defaultProcessRunner } from "../pm/runner.js";
+import { assertNpmVersion, resolveProtectedPm } from "../pm/safe-chain.js";
+import { regenerateLockfile } from "../pm/update.js";
+import { collectStagedOutputs } from "../project/collect.js";
+import { detectProject } from "../project/detect.js";
+import { PackageManagers } from "../project/types.js";
+import { lockfilePathFor, repinWorkspace, rewriteWorkspace } from "../rewrite/workspace.js";
+import { createStageStrategy } from "../strategy/index.js";
+import { runReport } from "./report.js";
+/**
+ * Stages a dependency upgrade into `.beefup/staged`, then regenerates the report.
+ * Uses the selected isolation strategy and restores the workspace on exit or signal.
+ */
+export async function runStage(options) {
+    const projectRoot = path.resolve(options.projectRoot);
+    const runner = options.runner ?? defaultProcessRunner;
+    const project = await detectProject(projectRoot);
+    const config = await loadConfig(projectRoot, options.mode);
+    const protectedPm = await resolveProtectedPm(project.packageManager);
+    if (project.packageManager === PackageManagers.Npm) {
+        await assertNpmVersion(protectedPm);
+    }
+    const strategy = createStageStrategy(options.strategy, projectRoot, project.lockfileName);
+    /**
+     * Cleans up the staging strategy and exits when the process receives SIGINT/SIGTERM.
+     */
+    const onSignal = () => {
+        void strategy.cleanup().finally(() => process.exit(1));
+    };
+    process.on("SIGINT", onSignal);
+    process.on("SIGTERM", onSignal);
+    try {
+        const workspace = await strategy.prepare();
+        await rewriteWorkspace(workspace.root, config.mode);
+        await regenerateLockfile({
+            pm: protectedPm,
+            packageManager: project.packageManager,
+            cwd: workspace.root,
+            runner,
+        });
+        await repinWorkspace(workspace.root, lockfilePathFor(workspace.root, project.lockfileName), project.packageManager);
+        await collectStagedOutputs(workspace.root, projectRoot, project.lockfileName);
+    }
+    finally {
+        process.off("SIGINT", onSignal);
+        process.off("SIGTERM", onSignal);
+        await strategy.cleanup();
+    }
+    return runReport({
+        projectRoot,
+        mode: config.mode,
+        strategy: options.strategy,
+        format: options.format,
+        runner,
+    });
+}
+export { printReport } from "./report.js";
+//# sourceMappingURL=stage.js.map

package/dist/commands/stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage.js","sourceRoot":"","sources":["../../src/commands/stage.ts"],"names":[],"mappings":"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"}

package/dist/config/load.d.ts

@@ -0,0 +1,6 @@
+import { type BeefupConfig, type UpgradeMode } from "./types.js";
+/**
+ * Loads and merges Beefup config from package.json and pnpm-workspace.yaml.
+ * An optional mode override (e.g. CLI `--mode`) wins over file config.
+ */
+export declare function loadConfig(projectRoot: string, modeOverride?: UpgradeMode): Promise<BeefupConfig>;

package/dist/config/load.js

@@ -0,0 +1,103 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
+import { BeefupError } from "../errors.js";
+import { pathExists, readJsonFile } from "../fsutil.js";
+import { DEFAULT_CONFIG, isAlignmentAction, isUpgradeMode, } from "./types.js";
+/**
+ * Returns a string array when `value` is an array of strings; otherwise undefined.
+ */
+function asStringArray(value) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    if (value.every((item) => typeof item === "string")) {
+        return value;
+    }
+    return undefined;
+}
+/**
+ * Extracts known Beefup config fields from a raw object, ignoring unknown shapes.
+ */
+function parsePartial(raw) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+        return {};
+    }
+    const input = raw;
+    const partial = {};
+    if (isUpgradeMode(input.mode)) {
+        partial.mode = input.mode;
+    }
+    const banned = asStringArray(input.bannedRanges);
+    if (banned) {
+        partial.bannedRanges = banned;
+    }
+    if (typeof input.preferExact === "boolean") {
+        partial.preferExact = input.preferExact;
+    }
+    if (isAlignmentAction(input.alignment)) {
+        partial.alignment = input.alignment;
+    }
+    if (Array.isArray(input.alignedGroups)) {
+        partial.alignedGroups = input.alignedGroups.flatMap((group) => {
+            if (!group || typeof group !== "object" || Array.isArray(group)) {
+                return [];
+            }
+            const g = group;
+            if (typeof g.name !== "string" || typeof g.source !== "string") {
+                return [];
+            }
+            const packages = asStringArray(g.packages);
+            if (!packages) {
+                return [];
+            }
+            return [
+                {
+                    name: g.name,
+                    source: g.source,
+                    packages,
+                    onMismatch: isAlignmentAction(g.onMismatch)
+                        ? g.onMismatch
+                        : undefined,
+                },
+            ];
+        });
+    }
+    return partial;
+}
+/**
+ * Loads and merges Beefup config from package.json and pnpm-workspace.yaml.
+ * An optional mode override (e.g. CLI `--mode`) wins over file config.
+ */
+export async function loadConfig(projectRoot, modeOverride) {
+    const pkgPath = path.join(projectRoot, "package.json");
+    if (!(await pathExists(pkgPath))) {
+        throw new BeefupError(`no package.json at ${pkgPath}`);
+    }
+    const pkg = await readJsonFile(pkgPath);
+    const fromPkg = parsePartial(pkg.beefup);
+    let fromWorkspace = {};
+    const workspacePath = path.join(projectRoot, "pnpm-workspace.yaml");
+    if (await pathExists(workspacePath)) {
+        const parsed = parseYaml(await readFile(workspacePath, "utf8"));
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            fromWorkspace = parsePartial(parsed.beefup);
+        }
+    }
+    const merged = {
+        ...DEFAULT_CONFIG,
+        ...fromPkg,
+        ...fromWorkspace,
+        bannedRanges: fromWorkspace.bannedRanges ??
+            fromPkg.bannedRanges ??
+            DEFAULT_CONFIG.bannedRanges,
+        alignedGroups: fromWorkspace.alignedGroups ??
+            fromPkg.alignedGroups ??
+            DEFAULT_CONFIG.alignedGroups,
+    };
+    if (modeOverride) {
+        merged.mode = modeOverride;
+    }
+    return merged;
+}
+//# sourceMappingURL=load.js.map

package/dist/config/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"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"}

package/dist/config/types.d.ts

@@ -0,0 +1,75 @@
+/** Closed set of upgrade modes Beefup can apply when rewriting constraints. */
+export declare const UpgradeModes: {
+    readonly SameMajor: "same-major";
+    readonly Latest: "latest";
+};
+/** Upgrade mode selecting same-major or latest constraint rewriting. */
+export type UpgradeMode = (typeof UpgradeModes)[keyof typeof UpgradeModes];
+/** Closed set of isolation strategies used while staging an upgrade. */
+export declare const StageStrategies: {
+    readonly Worktree: "worktree";
+    readonly Inplace: "inplace";
+};
+/** Strategy name for how the staging workspace is isolated. */
+export type StageStrategyName = (typeof StageStrategies)[keyof typeof StageStrategies];
+/** Closed set of report formats written to stdout. */
+export declare const ReportFormats: {
+    readonly Color: "color";
+    readonly Text: "text";
+    readonly Markdown: "markdown";
+    readonly Json: "json";
+    readonly Html: "html";
+};
+/** Format used when printing a stage/report result to stdout. */
+export type ReportFormat = (typeof ReportFormats)[keyof typeof ReportFormats];
+/** Closed set of policy actions for alignment and similar findings. */
+export declare const AlignmentActions: {
+    readonly Error: "error";
+    readonly Warn: "warn";
+};
+/** Whether an alignment mismatch fails the run or only warns. */
+export type AlignmentAction = (typeof AlignmentActions)[keyof typeof AlignmentActions];
+/** Floating tags/ranges that projects may ban in dependency specs. */
+export declare const BannedRangeTags: {
+    readonly Latest: "latest";
+    readonly Any: "*";
+};
+/** Top-level CLI command names Beefup accepts. */
+export declare const CliCommands: {
+    readonly Stage: "stage";
+    readonly Report: "report";
+    readonly Accept: "accept";
+};
+/** CLI command name (`stage`, `report`, or `accept`). */
+export type CliCommand = (typeof CliCommands)[keyof typeof CliCommands];
+/**
+ * Returns true when `value` is a known upgrade mode.
+ */
+export declare function isUpgradeMode(value: unknown): value is UpgradeMode;
+/**
+ * Returns true when `value` is a known stage strategy.
+ */
+export declare function isStageStrategy(value: unknown): value is StageStrategyName;
+/**
+ * Returns true when `value` is a known report format.
+ */
+export declare function isReportFormat(value: unknown): value is ReportFormat;
+/**
+ * Returns true when `value` is a known alignment action.
+ */
+export declare function isAlignmentAction(value: unknown): value is AlignmentAction;
+export interface AlignedGroup {
+    name: string;
+    source: string;
+    packages: string[];
+    onMismatch?: AlignmentAction;
+}
+export interface BeefupConfig {
+    mode: UpgradeMode;
+    bannedRanges: string[];
+    preferExact: boolean;
+    alignedGroups: AlignedGroup[];
+    alignment?: AlignmentAction;
+}
+/** Default Beefup project config when none is supplied in package manifests. */
+export declare const DEFAULT_CONFIG: BeefupConfig;

package/dist/config/types.js

@@ -0,0 +1,68 @@
+/** Closed set of upgrade modes Beefup can apply when rewriting constraints. */
+export const UpgradeModes = {
+    SameMajor: "same-major",
+    Latest: "latest",
+};
+/** Closed set of isolation strategies used while staging an upgrade. */
+export const StageStrategies = {
+    Worktree: "worktree",
+    Inplace: "inplace",
+};
+/** Closed set of report formats written to stdout. */
+export const ReportFormats = {
+    Color: "color",
+    Text: "text",
+    Markdown: "markdown",
+    Json: "json",
+    Html: "html",
+};
+/** Closed set of policy actions for alignment and similar findings. */
+export const AlignmentActions = {
+    Error: "error",
+    Warn: "warn",
+};
+/** Floating tags/ranges that projects may ban in dependency specs. */
+export const BannedRangeTags = {
+    Latest: UpgradeModes.Latest,
+    Any: "*",
+};
+/** Top-level CLI command names Beefup accepts. */
+export const CliCommands = {
+    Stage: "stage",
+    Report: "report",
+    Accept: "accept",
+};
+/**
+ * Returns true when `value` is a known upgrade mode.
+ */
+export function isUpgradeMode(value) {
+    return (value === UpgradeModes.SameMajor || value === UpgradeModes.Latest);
+}
+/**
+ * Returns true when `value` is a known stage strategy.
+ */
+export function isStageStrategy(value) {
+    return (value === StageStrategies.Worktree || value === StageStrategies.Inplace);
+}
+/**
+ * Returns true when `value` is a known report format.
+ */
+export function isReportFormat(value) {
+    return (typeof value === "string" &&
+        Object.values(ReportFormats).includes(value));
+}
+/**
+ * Returns true when `value` is a known alignment action.
+ */
+export function isAlignmentAction(value) {
+    return (value === AlignmentActions.Error || value === AlignmentActions.Warn);
+}
+/** Default Beefup project config when none is supplied in package manifests. */
+export const DEFAULT_CONFIG = {
+    mode: UpgradeModes.SameMajor,
+    bannedRanges: [BannedRangeTags.Latest, BannedRangeTags.Any],
+    preferExact: true,
+    alignedGroups: [],
+    alignment: AlignmentActions.Error,
+};
+//# sourceMappingURL=types.js.map

package/dist/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,SAAS,EAAE,YAAY;IACvB,MAAM,EAAE,QAAQ;CACR,CAAC;AAKX,wEAAwE;AACxE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;CACV,CAAC;AAMX,sDAAsD;AACtD,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;CACJ,CAAC;AAKX,uEAAuE;AACvE,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;CACJ,CAAC;AAMX,sEAAsE;AACtE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,YAAY,CAAC,MAAM;IAC3B,GAAG,EAAE,GAAG;CACA,CAAC;AAEX,kDAAkD;AAClD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACR,CAAC;AAKX;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,CACL,KAAK,KAAK,YAAY,CAAC,SAAS,IAAI,KAAK,KAAK,YAAY,CAAC,MAAM,CAClE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,CACL,KAAK,KAAK,eAAe,CAAC,QAAQ,IAAI,KAAK,KAAK,eAAe,CAAC,OAAO,CACxE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACxB,MAAM,CAAC,MAAM,CAAC,aAAa,CAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,CAC3D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,CACL,KAAK,KAAK,gBAAgB,CAAC,KAAK,IAAI,KAAK,KAAK,gBAAgB,CAAC,IAAI,CACpE,CAAC;AACJ,CAAC;AAiBD,gFAAgF;AAChF,MAAM,CAAC,MAAM,cAAc,GAAiB;IAC1C,IAAI,EAAE,YAAY,CAAC,SAAS;IAC5B,YAAY,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC;IAC3D,WAAW,EAAE,IAAI;IACjB,aAAa,EAAE,EAAE;IACjB,SAAS,EAAE,gBAAgB,CAAC,KAAK;CAClC,CAAC"}

package/dist/diff/diff.d.ts

@@ -0,0 +1,21 @@
+import type { Resolution } from "../lockfile/types.js";
+import { type ResolutionDiff, type ScopedVersion } from "./types.js";
+/**
+ * Compares two lockfile resolutions and returns added, removed, and changed
+ * packages. Versions are compared path-for-path within each package name.
+ * Path-only churn (identical unique versions) is omitted.
+ */
+export declare function diffResolutions(source: Resolution, target: Resolution): ResolutionDiff;
+/**
+ * Annotates diff entries with direct-dependency and optional/platform flags.
+ */
+export declare function annotatePackageChanges(diff: ResolutionDiff, options: {
+    directNames: ReadonlySet<string>;
+    optionalDeclaredNames: ReadonlySet<string>;
+    before: Resolution;
+    after: Resolution;
+}): ResolutionDiff;
+/**
+ * Unique version tags from scoped installs, sorted and comma-separated for display.
+ */
+export declare function formatUniqueVersions(scoped: ScopedVersion[]): string;

package/dist/diff/diff.js

@@ -0,0 +1,132 @@
+import { PackageChangeTypes, } from "./types.js";
+/**
+ * Compares two lockfile resolutions and returns added, removed, and changed
+ * packages. Versions are compared path-for-path within each package name.
+ * Path-only churn (identical unique versions) is omitted.
+ */
+export function diffResolutions(source, target) {
+    return {
+        dependencies: diffPackages(source.dependencies, target.dependencies),
+        devDependencies: diffPackages(source.devDependencies, target.devDependencies),
+    };
+}
+/**
+ * Annotates diff entries with direct-dependency and optional/platform flags.
+ */
+export function annotatePackageChanges(diff, options) {
+    return {
+        dependencies: annotateList(diff.dependencies, options, "dependencies"),
+        devDependencies: annotateList(diff.devDependencies, options, "devDependencies"),
+    };
+}
+/**
+ * Diffs two package lists by name, comparing only matching scopes/paths.
+ */
+function diffPackages(source, target) {
+    const sourceByName = groupByName(source);
+    const targetByName = groupByName(target);
+    const names = new Set([...sourceByName.keys(), ...targetByName.keys()]);
+    const changes = [];
+    for (const name of [...names].sort((a, b) => a.localeCompare(b))) {
+        const from = sourceByName.get(name) ?? [];
+        const to = targetByName.get(name) ?? [];
+        if (from.length === 0) {
+            changes.push({
+                name,
+                type: PackageChangeTypes.Added,
+                from: [],
+                to,
+            });
+            continue;
+        }
+        if (to.length === 0) {
+            changes.push({
+                name,
+                type: PackageChangeTypes.Removed,
+                from,
+                to: [],
+            });
+            continue;
+        }
+        if (scopesDiffer(from, to) && uniqueVersionsDiffer(from, to)) {
+            changes.push({
+                name,
+                type: PackageChangeTypes.Changed,
+                from,
+                to,
+            });
+        }
+    }
+    return changes;
+}
+/**
+ * Applies direct/optional flags onto one package-change list.
+ */
+function annotateList(changes, options, bucket) {
+    const lockPkgs = [
+        ...options.before[bucket],
+        ...options.after[bucket],
+    ];
+    return changes.map((change) => {
+        const optionalFromLock = lockPkgs.some((pkg) => pkg.name === change.name && pkg.optional === true);
+        return {
+            ...change,
+            direct: options.directNames.has(change.name),
+            optional: optionalFromLock || options.optionalDeclaredNames.has(change.name),
+        };
+    });
+}
+/**
+ * Groups lock packages by name into sorted scoped version lists.
+ */
+function groupByName(packages) {
+    const grouped = new Map();
+    for (const pkg of packages) {
+        const list = grouped.get(pkg.name) ?? [];
+        list.push({ path: pkg.path, version: pkg.version });
+        grouped.set(pkg.name, list);
+    }
+    for (const [name, list] of grouped) {
+        list.sort((a, b) => a.path.localeCompare(b.path));
+        grouped.set(name, list);
+    }
+    return grouped;
+}
+/**
+ * Returns true when any scope path is missing on one side or has a different version.
+ */
+function scopesDiffer(from, to) {
+    const fromMap = new Map(from.map((item) => [item.path, item.version]));
+    const toMap = new Map(to.map((item) => [item.path, item.version]));
+    const paths = new Set([...fromMap.keys(), ...toMap.keys()]);
+    for (const path of paths) {
+        if (fromMap.get(path) !== toMap.get(path)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Returns true when the set of unique version tags differs between from and to.
+ */
+function uniqueVersionsDiffer(from, to) {
+    const fromKey = [...new Set(from.map((item) => item.version))]
+        .sort((a, b) => a.localeCompare(b))
+        .join("\0");
+    const toKey = [...new Set(to.map((item) => item.version))]
+        .sort((a, b) => a.localeCompare(b))
+        .join("\0");
+    return fromKey !== toKey;
+}
+/**
+ * Unique version tags from scoped installs, sorted and comma-separated for display.
+ */
+export function formatUniqueVersions(scoped) {
+    if (scoped.length === 0) {
+        return "—";
+    }
+    return [...new Set(scoped.map((item) => item.version))]
+        .sort((a, b) => a.localeCompare(b))
+        .join(", ");
+}
+//# sourceMappingURL=diff.js.map

package/dist/diff/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/diff/diff.ts"],"names":[],"mappings":"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"}

package/dist/diff/group.d.ts

@@ -0,0 +1,5 @@
+import { type GroupedChanges, type PackageChange } from "./types.js";
+/**
+ * Buckets package changes into added, removed, and changed groups for reporting.
+ */
+export declare function groupByChangeType(changes: PackageChange[]): GroupedChanges;

package/dist/diff/group.js

@@ -0,0 +1,24 @@
+import { PackageChangeTypes, } from "./types.js";
+/**
+ * Buckets package changes into added, removed, and changed groups for reporting.
+ */
+export function groupByChangeType(changes) {
+    const result = {
+        added: [],
+        removed: [],
+        changed: [],
+    };
+    for (const change of changes) {
+        if (change.type === PackageChangeTypes.Added) {
+            result.added.push(change);
+        }
+        else if (change.type === PackageChangeTypes.Removed) {
+            result.removed.push(change);
+        }
+        else if (change.type === PackageChangeTypes.Changed) {
+            result.changed.push(change);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=group.js.map

package/dist/diff/group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group.js","sourceRoot":"","sources":["../../src/diff/group.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,GAGnB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAwB;IACxD,MAAM,MAAM,GAAmB;QAC7B,KAAK,EAAE,EAAE;QACT,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,EAAE;KACZ,CAAC;IAEF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,IAAI,KAAK,kBAAkB,CAAC,KAAK,EAAE,CAAC;YAC7C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;aAAM,IAAI,MAAM,CAAC,IAAI,KAAK,kBAAkB,CAAC,OAAO,EAAE,CAAC;YACtD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;aAAM,IAAI,MAAM,CAAC,IAAI,KAAK,kBAAkB,CAAC,OAAO,EAAE,CAAC;YACtD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/diff/types.d.ts

@@ -0,0 +1,37 @@
+/** How a package name changed between two lockfile resolutions. */
+export declare const PackageChangeTypes: {
+    readonly Added: "added";
+    readonly Removed: "removed";
+    readonly Changed: "changed";
+};
+/** Package change kind (added, removed, or changed at one or more scopes). */
+export type PackageChangeType = (typeof PackageChangeTypes)[keyof typeof PackageChangeTypes];
+/** One concrete install of a package at a specific lockfile scope/path. */
+export interface ScopedVersion {
+    path: string;
+    version: string;
+}
+/**
+ * Diff entry for one package name across all of its scoped installs.
+ * `from` / `to` are scope-aware; renderers may show unique version tags only.
+ */
+export interface PackageChange {
+    name: string;
+    type: PackageChangeType;
+    from: ScopedVersion[];
+    to: ScopedVersion[];
+    /** True when the package is declared in a workspace package.json. */
+    direct?: boolean;
+    /** True when the package is optional/platform in the lockfile or manifests. */
+    optional?: boolean;
+}
+export interface ResolutionDiff {
+    dependencies: PackageChange[];
+    devDependencies: PackageChange[];
+}
+/** Buckets package changes by added / removed / changed for reporting. */
+export interface GroupedChanges {
+    added: PackageChange[];
+    removed: PackageChange[];
+    changed: PackageChange[];
+}

package/dist/diff/types.js

@@ -0,0 +1,7 @@
+/** How a package name changed between two lockfile resolutions. */
+export const PackageChangeTypes = {
+    Added: "added",
+    Removed: "removed",
+    Changed: "changed",
+};
+//# sourceMappingURL=types.js.map

package/dist/diff/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/diff/types.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;CACV,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Application error that carries a process exit code for the CLI.
+ */
+export declare class BeefupError extends Error {
+    readonly exitCode: number;
+    /**
+     * Creates a BeefupError with a user-facing message and optional exit code.
+     */
+    constructor(message: string, exitCode?: number);
+}

package/dist/errors.js

@@ -0,0 +1,15 @@
+/**
+ * Application error that carries a process exit code for the CLI.
+ */
+export class BeefupError extends Error {
+    exitCode;
+    /**
+     * Creates a BeefupError with a user-facing message and optional exit code.
+     */
+    constructor(message, exitCode = 1) {
+        super(message);
+        this.name = "BeefupError";
+        this.exitCode = exitCode;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,QAAQ,CAAS;IAE1B;;OAEG;IACH,YAAY,OAAe,EAAE,QAAQ,GAAG,CAAC;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF"}

package/dist/fsutil.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Returns whether a filesystem path exists and is accessible.
+ */
+export declare function pathExists(target: string): Promise<boolean>;
+/**
+ * Reads a UTF-8 JSON file and parses it as type T.
+ */
+export declare function readJsonFile<T>(filePath: string): Promise<T>;
+/**
+ * Writes a value as pretty-printed JSON, creating parent directories as needed.
+ */
+export declare function writeJsonFile(filePath: string, value: unknown): Promise<void>;
+/**
+ * Copies a file to a destination path, creating parent directories as needed.
+ */
+export declare function copyFileTo(src: string, dest: string): Promise<void>;
+/**
+ * Removes a file or directory tree if it exists.
+ */
+export declare function removePath(target: string): Promise<void>;