autoremediator 0.21.2 → 0.22.0

package/dist/api/freshness/report.d.ts

@@ -0,0 +1,55 @@
+/**
+ * The freshness report: how far behind each direct dependency is, a project score, and the climb
+ * for each one past the policy. Read-only: it queries the package manager and the registry and
+ * changes nothing.
+ */
+import type { PackageTimeline } from "../../intelligence/sources/registry.js";
+import { type MemoryConstraints } from "../../platform/memory/consume.js";
+import { detectPackageManager } from "../../platform/package-manager/index.js";
+import { type AutoremediatorPolicy } from "../../platform/policy.js";
+import { type FreshnessDeps } from "./deps.js";
+import type { FreshnessClimb, FreshnessOptions, FreshnessPackage, FreshnessReport, StepAssessment } from "./types.js";
+/**
+ * Order climbs by how likely their first step is to break the project, lowest first, so a scheduled
+ * run takes the safest step first. Held climbs go last. Without an assessment the step's level
+ * (patch, minor, major) stands in; ties go to the climb that is nearer done, then to the name.
+ */
+export declare function orderClimbs(climbs: readonly FreshnessClimb[]): FreshnessClimb[];
+/** Why the first step of a climb cannot be taken as things stand, if it cannot. */
+export declare function holdFor(climb: FreshnessClimb, policy: AutoremediatorPolicy, allowHigh: boolean): FreshnessClimb["held"];
+export interface Gathered {
+    cwd: string;
+    packageManager: ReturnType<typeof detectPackageManager>;
+    policy: AutoremediatorPolicy;
+    packages: FreshnessPackage[];
+    timelines: Map<string, PackageTimeline | undefined>;
+    failures: Map<string, string>;
+    notes: string[];
+    /** What remediation memory says: pinned packages and rejected upgrades. Absent with `ignoreMemory`. */
+    memory?: MemoryConstraints;
+    now: number;
+}
+/** Read the project's direct dependencies and, for the ones that are behind, the registry's timeline. */
+export declare function gatherFreshness(options: FreshnessOptions, deps: FreshnessDeps): Promise<Gathered>;
+/** One climb per package past the policy, plus the ones for which none could be made. */
+export declare function buildClimbs(gathered: Gathered): {
+    climbs: FreshnessClimb[];
+    unplanned: FreshnessReport["unplanned"];
+};
+/** Rate the first step of each climb (at most `deps.concurrency` at a time), then hold and order them. */
+export declare function assessClimbs(climbs: readonly FreshnessClimb[], context: {
+    cwd: string;
+    policy: AutoremediatorPolicy;
+    allowHigh: boolean;
+    assess: boolean;
+}, deps: FreshnessDeps, cache?: Map<string, Promise<StepAssessment>>): Promise<FreshnessClimb[]>;
+export declare function sortPackages(packages: readonly FreshnessPackage[]): FreshnessPackage[];
+export declare function reportFrom(gathered: Gathered, climbs: FreshnessClimb[], unplanned: FreshnessReport["unplanned"]): FreshnessReport;
+/**
+ * How fresh the project's direct dependencies are, and, for those past the policy's `freshness`
+ * limits, the small steps that would bring them back. With `assess`, the first step of each climb is
+ * rated by `assessUpgrade` and the climbs are ordered safest first; without it they are ordered by
+ * step size. Changes nothing.
+ */
+export declare function freshnessReport(options?: FreshnessOptions, deps?: FreshnessDeps): Promise<FreshnessReport>;
+//# sourceMappingURL=report.d.ts.map

package/dist/api/freshness/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../src/api/freshness/report.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,OAAO,KAAK,EAEV,eAAe,EAChB,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAAgC,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACnG,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,WAAW,CAAC;AAGnB,OAAO,KAAK,EACV,cAAc,EAGd,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACf,MAAM,YAAY,CAAC;AAgBpB;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,GAAG,cAAc,EAAE,CAU/E;AAED,mFAAmF;AACnF,wBAAgB,OAAO,CACrB,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,oBAAoB,EAC5B,SAAS,EAAE,OAAO,GACjB,cAAc,CAAC,MAAM,CAAC,CA6BxB;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IACxD,MAAM,EAAE,oBAAoB,CAAC;IAC7B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC,CAAC;IACpD,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,uGAAuG;IACvG,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;CACb;AAoED,yGAAyG;AACzG,wBAAsB,eAAe,CACnC,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,QAAQ,CAAC,CA8DnB;AAED,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG;IAC/C,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,SAAS,EAAE,eAAe,CAAC,WAAW,CAAC,CAAC;CACzC,CA4EA;AAWD,0GAA0G;AAC1G,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,cAAc,EAAE,EACjC,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,EAC3F,IAAI,EAAE,aAAa,EACnB,KAAK,GAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,CAAa,GACtD,OAAO,CAAC,cAAc,EAAE,CAAC,CAe3B;AAsBD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,GAAG,gBAAgB,EAAE,CAOtF;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,cAAc,EAAE,EACxB,SAAS,EAAE,eAAe,CAAC,WAAW,CAAC,GACtC,eAAe,CA4BjB;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,OAAO,GAAE,gBAAqB,EAC9B,IAAI,GAAE,aAAoC,GACzC,OAAO,CAAC,eAAe,CAAC,CAc1B"}

package/dist/api/freshness/report.js

@@ -0,0 +1,334 @@
+import semver from "semver";
+import { isIgnoredPackage } from "../../platform/freshness-policy.js";
+import { loadMemoryConstraints, pinnedMessage, rejectedMessage, } from "../../platform/memory/consume.js";
+import { detectPackageManager } from "../../platform/package-manager/index.js";
+import { isPackageAllowed, loadPolicy } from "../../platform/policy.js";
+import { defaultFreshnessDeps, mapLimit, } from "./deps.js";
+import { distanceBetween, exceedsPolicy, isBehind, penaltyOf, projectScore } from "./distance.js";
+import { climbSteps } from "./path.js";
+const BREAKABILITY_RANK = { Low: 0, Medium: 1, Unknown: 2, High: 3 };
+const LEVEL_RANK = { patch: 0, minor: 1, major: 2 };
+const rankOf = (climb) => {
+    const first = climb.steps[0];
+    return [
+        climb.held ? 1 : 0,
+        climb.assessment ? BREAKABILITY_RANK[climb.assessment.breakability] : 0,
+        // A step across a breaking boundary (a major, or a 0.x minor) ranks as a major.
+        first ? (first.kind === "major" ? LEVEL_RANK.major : LEVEL_RANK[first.level]) : 0,
+        climb.steps.length,
+    ];
+};
+/**
+ * Order climbs by how likely their first step is to break the project, lowest first, so a scheduled
+ * run takes the safest step first. Held climbs go last. Without an assessment the step's level
+ * (patch, minor, major) stands in; ties go to the climb that is nearer done, then to the name.
+ */
+export function orderClimbs(climbs) {
+    return climbs.toSorted((a, b) => {
+        const left = rankOf(a);
+        const right = rankOf(b);
+        for (const [index, value] of left.entries()) {
+            const difference = value - right[index];
+            if (difference !== 0)
+                return difference;
+        }
+        return a.packageName.localeCompare(b.packageName);
+    });
+}
+/** Why the first step of a climb cannot be taken as things stand, if it cannot. */
+export function holdFor(climb, policy, allowHigh) {
+    const first = climb.steps[0];
+    if (!first)
+        return undefined;
+    if (!isPackageAllowed(policy, climb.packageName)) {
+        return {
+            reason: "package-not-allowed",
+            message: `${climb.packageName} is excluded by allowPackages/denyPackages in the policy.`,
+        };
+    }
+    if (first.deprecated) {
+        return {
+            reason: "only-newer-release-deprecated",
+            message: `The only newer release is deprecated (${first.toVersion}), so ${climb.packageName} is left where it is.`,
+        };
+    }
+    if ((first.kind === "major" || first.level === "major") && !policy.allowMajorBumps) {
+        const zeroX = first.level !== "major";
+        return {
+            reason: "major-bump-not-allowed",
+            message: `${first.fromVersion} -> ${first.toVersion} crosses ${zeroX ? "a 0.x minor, which counts as a major," : "a major,"} and allowMajorBumps is off in the policy.`,
+        };
+    }
+    if (climb.assessment?.breakability === "High" && !allowHigh) {
+        return {
+            reason: "high-breakability",
+            message: `${climb.assessment.summary} Held: pass allowHigh (--allow-high) to take it.`,
+        };
+    }
+    return undefined;
+}
+/** Why the installed version's age is not known, when it is not and `maxAgeDays` needs it. */
+function unknownAgeReason(name, version, distance, context) {
+    if (context.policy?.maxAgeDays === undefined || distance.ageDays !== undefined)
+        return undefined;
+    const failure = context.failures.get(name);
+    if (failure) {
+        return `the registry could not be read for ${name} (${failure.split("\n")[0]}), so the publish time of ${name} ${version} is unknown`;
+    }
+    return context.timelines.get(name)
+        ? `the registry lists no publish time for ${name} ${version}`
+        : `${name} is not on the registry, so the publish time of ${name} ${version} is unknown`;
+}
+function describePackage(dependency, context) {
+    const base = { name: dependency.name, field: dependency.field, range: dependency.range };
+    const { policy } = context;
+    if (policy && isIgnoredPackage(policy.ignore, dependency.name)) {
+        return { ...base, status: "ignored", exceeds: [] };
+    }
+    const info = context.outdated.get(dependency.name);
+    if (!info) {
+        if (!context.deps.isInstalled(context.cwd, dependency.name)) {
+            return { ...base, status: "not-installed", exceeds: [] };
+        }
+        return { ...base, status: "current", penalty: 0, exceeds: [] };
+    }
+    const timeline = context.timelines.get(dependency.name);
+    const distance = distanceBetween({
+        installed: info.currentVersion,
+        latest: info.latestVersion,
+        published: timeline?.versions,
+        installedPublishedAt: timeline?.published.get(info.currentVersion),
+        now: context.now,
+    });
+    const where = { installed: info.currentVersion, latest: info.latestVersion };
+    if (!distance)
+        return { ...base, ...where, status: "unreadable", exceeds: [] };
+    const behind = isBehind(info.currentVersion, info.latestVersion);
+    const unknownAge = behind
+        ? unknownAgeReason(dependency.name, info.currentVersion, distance, context)
+        : undefined;
+    return {
+        ...base,
+        ...where,
+        status: behind ? "behind" : "current",
+        ...distance,
+        penalty: penaltyOf(distance),
+        exceeds: exceedsPolicy(distance, behind, policy),
+        ...(unknownAge ? { unknownAge } : {}),
+    };
+}
+/** Read the project's direct dependencies and, for the ones that are behind, the registry's timeline. */
+export async function gatherFreshness(options, deps) {
+    const cwd = options.cwd ?? process.cwd();
+    const policy = loadPolicy(cwd, options.policy);
+    const packageManager = options.packageManager ?? detectPackageManager(cwd);
+    const now = deps.now();
+    const notes = [];
+    const only = options.packages?.length ? new Set(options.packages) : undefined;
+    const direct = deps.readDirect(cwd).filter((dependency) => !only || only.has(dependency.name));
+    if (only) {
+        for (const name of only) {
+            if (!direct.some((dependency) => dependency.name === name)) {
+                notes.push(`${name} is not a registry dependency in package.json, so it is not covered.`);
+            }
+        }
+    }
+    // Pins and rejected upgrades a person or an earlier run recorded; a file that cannot be read safely stops the run.
+    const memory = options.ignoreMemory ? undefined : loadMemoryConstraints(cwd, new Date(now));
+    const outdated = await deps.queryOutdated(cwd, { packageManager });
+    const behindNames = direct
+        .filter((dependency) => {
+        const info = outdated.get(dependency.name);
+        return info !== undefined && isBehind(info.currentVersion, info.latestVersion);
+    })
+        .map((dependency) => dependency.name);
+    const timelines = new Map();
+    const failures = new Map();
+    await mapLimit(behindNames, deps.concurrency, async (name) => {
+        try {
+            timelines.set(name, await deps.fetchTimeline(name, cwd));
+        }
+        catch (error) {
+            failures.set(name, error instanceof Error ? error.message : String(error));
+        }
+    });
+    const packages = direct.map((dependency) => describePackage(dependency, {
+        cwd,
+        deps,
+        outdated,
+        timelines,
+        failures,
+        policy: policy.freshness,
+        now,
+    }));
+    return {
+        cwd,
+        packageManager,
+        policy,
+        packages,
+        timelines,
+        failures,
+        notes,
+        ...(memory ? { memory } : {}),
+        now,
+    };
+}
+/** One climb per package past the policy, plus the ones for which none could be made. */
+export function buildClimbs(gathered) {
+    const climbs = [];
+    const unplanned = [];
+    const policy = gathered.policy.freshness;
+    for (const entry of gathered.packages) {
+        // An age limit that cannot be checked is not "within policy": list it, with why, and climb nothing.
+        if (entry.unknownAge && entry.exceeds.length === 0) {
+            unplanned.push({
+                packageName: entry.name,
+                reason: `the age of ${entry.name} ${entry.installed} is unknown, so maxAgeDays cannot be checked: ${entry.unknownAge}`,
+            });
+            continue;
+        }
+        if (entry.status !== "behind" ||
+            entry.exceeds.length === 0 ||
+            !entry.installed ||
+            !entry.latest) {
+            continue;
+        }
+        // A person's pin comes first: the package is left alone, whatever else says.
+        const pinned = gathered.memory?.pinned.get(entry.name);
+        if (pinned) {
+            unplanned.push({ packageName: entry.name, reason: pinnedMessage(pinned) });
+            continue;
+        }
+        const failure = gathered.failures.get(entry.name);
+        const timeline = gathered.timelines.get(entry.name);
+        if (failure || !timeline) {
+            unplanned.push({
+                packageName: entry.name,
+                reason: failure
+                    ? `the registry could not be read for ${entry.name}: ${failure.split("\n")[0]}`
+                    : `${entry.name} is not on the registry`,
+            });
+            continue;
+        }
+        const rejected = gathered.memory?.rejected.get(entry.name) ?? new Map();
+        const steps = climbSteps({
+            packageName: entry.name,
+            field: entry.field,
+            installed: entry.installed,
+            latest: entry.latest,
+            versions: timeline.versions,
+            deprecated: timeline.deprecated,
+            published: timeline.published,
+            policy,
+            rejected: new Set(rejected.keys()),
+            now: gathered.now,
+        });
+        if (steps.length === 0) {
+            // Every release in between was rejected earlier: say so, with the entries, rather than "none exists".
+            const inRange = [...rejected].filter(([version]) => semver.valid(version) !== null &&
+                semver.gt(version, entry.installed) &&
+                semver.lte(version, entry.latest));
+            unplanned.push({
+                packageName: entry.name,
+                reason: inRange.length > 0
+                    ? `every newer release of ${entry.name} was rejected earlier: ${inRange.map(([, rejection]) => rejectedMessage(rejection)).join("; ")}`
+                    : `no published version lies between ${entry.installed} and ${entry.latest}`,
+            });
+            continue;
+        }
+        climbs.push({
+            packageName: entry.name,
+            installed: entry.installed,
+            latest: entry.latest,
+            steps,
+        });
+    }
+    return { climbs, unplanned };
+}
+function withHold(climb, policy, allowHigh) {
+    const reason = holdFor(climb, policy, allowHigh);
+    return reason ? { ...climb, held: reason } : climb;
+}
+/** Rate the first step of each climb (at most `deps.concurrency` at a time), then hold and order them. */
+export async function assessClimbs(climbs, context, deps, cache = new Map()) {
+    const rated = context.assess
+        ? await mapLimit(climbs, deps.concurrency, async (climb) => {
+            const first = climb.steps[0];
+            const key = `${first.packageName}@${first.fromVersion}->${first.toVersion}`;
+            let pending = cache.get(key);
+            if (!pending) {
+                pending = deps.assess(first.packageName, first.fromVersion, first.toVersion, context.cwd);
+                cache.set(key, pending);
+            }
+            return { ...climb, assessment: await pending };
+        })
+        : [...climbs];
+    const held = rated.map((climb) => withHold(climb, context.policy, context.allowHigh));
+    return orderClimbs(held);
+}
+function countsOf(packages) {
+    const count = (status) => packages.filter((entry) => entry.status === status).length;
+    return {
+        direct: packages.length,
+        current: count("current"),
+        behind: count("behind"),
+        ignored: count("ignored"),
+        notInstalled: count("not-installed"),
+        unreadable: count("unreadable"),
+        exceeding: packages.filter((entry) => entry.exceeds.length > 0).length,
+        unknownAge: packages.filter((entry) => entry.unknownAge !== undefined).length,
+    };
+}
+const groupOf = (entry) => {
+    if (entry.status === "behind")
+        return 0;
+    return entry.status === "current" ? 1 : 2;
+};
+export function sortPackages(packages) {
+    return packages.toSorted((a, b) => groupOf(a) - groupOf(b) ||
+        (b.penalty ?? 0) - (a.penalty ?? 0) ||
+        a.name.localeCompare(b.name));
+}
+export function reportFrom(gathered, climbs, unplanned) {
+    const policy = gathered.policy.freshness ?? null;
+    const notes = [...gathered.notes];
+    if (!policy) {
+        notes.push("The policy has no `freshness` key, so no limit is set and no climb is planned. Add one, for example `freshness: { maxMajorsBehind: 1 }`.");
+    }
+    const notInstalled = gathered.packages.filter((entry) => entry.status === "not-installed");
+    if (notInstalled.length > 0) {
+        notes.push(`${notInstalled.length} direct dependenc${notInstalled.length === 1 ? "y is" : "ies are"} not installed, so the package manager could not say how far behind ${notInstalled.length === 1 ? "it is" : "they are"}; install first. Not counted in the score.`);
+    }
+    const counted = gathered.packages.filter((entry) => entry.penalty !== undefined);
+    return {
+        schemaVersion: "1.0",
+        generatedAt: new Date(gathered.now).toISOString(),
+        cwd: gathered.cwd,
+        packageManager: gathered.packageManager,
+        policy,
+        score: projectScore(counted.map((entry) => entry.penalty)),
+        counts: countsOf(gathered.packages),
+        packages: sortPackages(gathered.packages),
+        climbs,
+        unplanned,
+        notes,
+    };
+}
+/**
+ * How fresh the project's direct dependencies are, and, for those past the policy's `freshness`
+ * limits, the small steps that would bring them back. With `assess`, the first step of each climb is
+ * rated by `assessUpgrade` and the climbs are ordered safest first; without it they are ordered by
+ * step size. Changes nothing.
+ */
+export async function freshnessReport(options = {}, deps = defaultFreshnessDeps) {
+    const gathered = await gatherFreshness(options, deps);
+    const { climbs, unplanned } = buildClimbs(gathered);
+    const ordered = await assessClimbs(climbs, {
+        cwd: gathered.cwd,
+        policy: gathered.policy,
+        allowHigh: options.allowHigh ?? false,
+        assess: options.assess ?? false,
+    }, deps);
+    return reportFrom(gathered, ordered, unplanned);
+}
+//# sourceMappingURL=report.js.map

package/dist/api/freshness/report.js.map

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

package/dist/api/freshness/step.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Planning and applying freshness steps. A step is recorded as an ordinary run with a one-item
+ * plan, so `applyPlan`, `verifyRun` and `rollbackRun` work on it exactly as on a security fix: the
+ * recorded plan is the approval step, and the verifier, not this module, decides whether it holds.
+ */
+import type { RemediationReport } from "../../platform/types.js";
+import { type RunDeps } from "../runs/index.js";
+import { type FreshnessDeps } from "./deps.js";
+import type { ApplyFreshnessOptions, ApplyFreshnessResult, FreshnessClimb, FreshnessPlanResult, FreshnessReport, FreshnessStep, PlanFreshnessStepOptions, StepAssessment } from "./types.js";
+/**
+ * Failed attempts after which one `applyFreshness` call stops trying other packages. A step that
+ * fails is rolled back and costs an install and a test run, so a project where everything fails
+ * must not spend the whole night finding that out.
+ */
+export declare const MAX_FAILED_ATTEMPTS = 3;
+/** The pseudo advisory id a step's run is recorded under; it also names the change request branch. */
+export declare const stepRunId: (step: FreshnessStep) => string;
+/** The preview report `persistPlan` turns into a one-item plan. */
+export declare function stepReport(step: FreshnessStep, assessment: StepAssessment | undefined, applied?: boolean): RemediationReport;
+export interface Analysis {
+    report: FreshnessReport;
+    /** Every climb, ordered, held ones last. */
+    climbs: FreshnessClimb[];
+    eligible?: FreshnessClimb;
+    held: Array<{
+        packageName: string;
+        reason: string;
+    }>;
+}
+/** Gather, build, rate and order the climbs, leaving out packages in `skip`. */
+export declare function analyse(options: PlanFreshnessStepOptions, deps: FreshnessDeps, cache: Map<string, Promise<StepAssessment>>, skip?: ReadonlySet<string>): Promise<Analysis>;
+/**
+ * Record the next freshness step as a plan, for `applyPlan` to carry out after review. The step is
+ * the first of the safest climb that is not held; only one plan is recorded because applying it
+ * changes the manifests every other plan was made against. Changes nothing in the project.
+ */
+export declare function planFreshnessStep(options?: PlanFreshnessStepOptions, deps?: FreshnessDeps): Promise<FreshnessPlanResult>;
+/**
+ * Take freshness steps, one verified upgrade at a time, at most `maxSteps` of them (default 1).
+ * Each step is its own recorded run: planned, applied through `applyPlan` (so the verifier, the
+ * project's own checks, agent repair and earned autonomy apply as they do everywhere), and, if it
+ * does not hold, taken back out with `rollbackRun` and the package left alone for this call. With
+ * `changeRequest`, each applied step becomes its own change request and the working tree returns
+ * to where it started.
+ */
+export declare function applyFreshness(options?: ApplyFreshnessOptions, deps?: FreshnessDeps, runDeps?: RunDeps): Promise<ApplyFreshnessResult>;
+//# sourceMappingURL=step.d.ts.map

package/dist/api/freshness/step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../../src/api/freshness/step.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAQjE,OAAO,EAAuC,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACrF,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAErE,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,aAAa,EAEb,wBAAwB,EAExB,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,sGAAsG;AACtG,eAAO,MAAM,SAAS,SAAU,aAAa,KAAG,MAAuC,CAAC;AAKxF,mEAAmE;AACnE,wBAAgB,UAAU,CACxB,IAAI,EAAE,aAAa,EACnB,UAAU,EAAE,cAAc,GAAG,SAAS,EACtC,OAAO,UAAQ,GACd,iBAAiB,CAqBnB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,4CAA4C;IAC5C,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,IAAI,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtD;AAED,gFAAgF;AAChF,wBAAsB,OAAO,CAC3B,OAAO,EAAE,wBAAwB,EACjC,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,EAC3C,IAAI,GAAE,WAAW,CAAC,MAAM,CAAa,GACpC,OAAO,CAAC,QAAQ,CAAC,CAuBnB;AAwBD;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,wBAA6B,EACtC,IAAI,GAAE,aAAoC,GACzC,OAAO,CAAC,mBAAmB,CAAC,CAqB9B;AAgBD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,OAAO,GAAE,qBAA0B,EACnC,IAAI,GAAE,aAAoC,EAC1C,OAAO,GAAE,OAAwB,GAChC,OAAO,CAAC,oBAAoB,CAAC,CA4I/B"}