pray-cli 1.6.0

package/dist/cli/commands/update-latest.d.ts

@@ -0,0 +1,2 @@
+export declare function updateLatestCommand(packageName: string | undefined, json: boolean): Promise<void>;
+//# sourceMappingURL=update-latest.d.ts.map

package/dist/cli/commands/update-latest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-latest.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/update-latest.ts"],"names":[],"mappings":"AAmBA,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,IAAI,CAAC,CA6Ef"}

package/dist/cli/commands/update-latest.js

@@ -0,0 +1,68 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { latestConstraintForPackage, versionSatisfies, } from "../../constraint.js";
+import { PrayError } from "../../errors.js";
+import { readLockfile } from "../../lockfile/index.js";
+import { replacePackageDeclaration } from "../../manifest/package-declaration.js";
+import { defaultResolveOptions } from "../../resolve/context.js";
+import { lockfilePath, manifestPath, resolveCurrentProject, } from "../invocation.js";
+import { printUpdateJsonReport, updateWithManifestConstraints, } from "./update-core.js";
+export async function updateLatestCommand(packageName, json) {
+    const path = manifestPath();
+    let manifestText = readFileSync(path, "utf8");
+    const project = await resolveCurrentProject({
+        ...defaultResolveOptions(),
+        refreshSourceRevisions: true,
+        ignoreLockedVersions: true,
+    });
+    if (packageName &&
+        !project.manifest.packages.some((entry) => entry.name === packageName)) {
+        throw PrayError.manifest(`package ${packageName} not found`);
+    }
+    const manifestUpdates = [];
+    for (const resolved of project.packages) {
+        if (packageName && resolved.declaration.name !== packageName) {
+            continue;
+        }
+        const registryLatest = resolved.registryLatestVersion;
+        if (!registryLatest) {
+            continue;
+        }
+        if (versionSatisfies(registryLatest, resolved.declaration.constraint)) {
+            continue;
+        }
+        const newConstraint = latestConstraintForPackage(resolved.declaration.constraint, registryLatest);
+        if (!versionSatisfies(registryLatest, newConstraint)) {
+            throw PrayError.resolution(`derived constraint ${newConstraint} does not admit registry latest ${registryLatest} for ${resolved.declaration.name}`);
+        }
+        manifestUpdates.push({
+            name: resolved.declaration.name,
+            from_constraint: resolved.declaration.constraint,
+            to_constraint: newConstraint,
+            registry_latest_version: registryLatest,
+        });
+        manifestText = replacePackageDeclaration(manifestText, {
+            ...resolved.declaration,
+            constraint: newConstraint,
+        });
+    }
+    if (manifestUpdates.length === 0) {
+        if (json) {
+            const current = existsSync(lockfilePath())
+                ? readLockfile(lockfilePath())
+                : undefined;
+            printUpdateJsonReport([], current, current, packageName, project);
+            return;
+        }
+        process.stdout.write("All package constraints already allow registry latest versions\n");
+    }
+    else {
+        if (!json) {
+            for (const update of manifestUpdates) {
+                process.stdout.write(`Prayfile: ${update.name} constraint ${update.from_constraint} -> ${update.to_constraint} (registry latest ${update.registry_latest_version})\n`);
+            }
+        }
+        writeFileSync(path, manifestText, "utf8");
+    }
+    await updateWithManifestConstraints(packageName, json, manifestUpdates);
+}
+//# sourceMappingURL=update-latest.js.map

package/dist/cli/commands/update-latest.js.map

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

package/dist/cli/commands/update-report.d.ts

@@ -0,0 +1,23 @@
+import type { Lockfile } from "../../lockfile/types.js";
+import type { ResolvedProject } from "../../resolve/types.js";
+export interface UpdatePackageEntry {
+    name: string;
+    from_version?: string;
+    to_version: string;
+}
+export interface UpdateSummaryReport {
+    lines: string[];
+    updatedPackages: UpdatePackageEntry[];
+}
+export declare function buildUpdateSummary(previous: Lockfile | undefined, updated: Lockfile, selectedPackage: string | undefined, _project: ResolvedProject): UpdateSummaryReport;
+export declare function constraintBlockedPackageLines(project: ResolvedProject): string[];
+export declare function constraintBlockedPackagesJson(project: ResolvedProject): {
+    name: string;
+    resolved_version: string;
+    registry_latest_version: string;
+    constraint: string;
+}[];
+export declare function printUpdateSummary(previous: Lockfile | undefined, updated: Lockfile, selectedPackage: string | undefined, project: ResolvedProject, title: string): boolean;
+export declare function printConstraintBlockedPackages(project: ResolvedProject, title: string, printTitle: boolean): boolean;
+export declare function mergeSelectedPackageUpdate(previous: Lockfile, updated: Lockfile, selectedPackage: string): Lockfile;
+//# sourceMappingURL=update-report.d.ts.map

package/dist/cli/commands/update-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-report.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/update-report.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,eAAe,EAAE,kBAAkB,EAAE,CAAC;CACvC;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAC9B,OAAO,EAAE,QAAQ,EACjB,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,QAAQ,EAAE,eAAe,GACxB,mBAAmB,CAiDrB;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,eAAe,GACvB,MAAM,EAAE,CAeV;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,eAAe;;;;;IAoBrE;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAC9B,OAAO,EAAE,QAAQ,EACjB,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,MAAM,GACZ,OAAO,CAeT;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,OAAO,GAClB,OAAO,CAYT;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,QAAQ,EACjB,eAAe,EAAE,MAAM,GACtB,QAAQ,CAgBV"}

package/dist/cli/commands/update-report.js

@@ -0,0 +1,113 @@
+import { versionIsGreaterThan } from "../../constraint.js";
+export function buildUpdateSummary(previous, updated, selectedPackage, _project) {
+    const previousByName = new Map((previous?.package ?? []).map((entry) => [entry.name, entry]));
+    const lines = [];
+    const updatedPackages = [];
+    if (previous) {
+        for (const source of updated.source) {
+            const previousRevision = previous.source.find((entry) => entry.name === source.name)?.revision;
+            if (previousRevision !== source.revision) {
+                lines.push(`Updated source ${source.name} revision ${previousRevision ?? "none"} -> ${source.revision ?? "none"}`);
+            }
+        }
+    }
+    for (const packageEntry of updated.package) {
+        if (selectedPackage && packageEntry.name !== selectedPackage) {
+            continue;
+        }
+        const previousPackage = previousByName.get(packageEntry.name);
+        if (!previousPackage) {
+            lines.push(`Updated package ${packageEntry.name} (new) -> ${packageEntry.version}`);
+            updatedPackages.push({
+                name: packageEntry.name,
+                to_version: packageEntry.version,
+            });
+            continue;
+        }
+        if (previousPackage.version === packageEntry.version) {
+            continue;
+        }
+        lines.push(`Updated package ${packageEntry.name} ${previousPackage.version} -> ${packageEntry.version}`);
+        updatedPackages.push({
+            name: packageEntry.name,
+            from_version: previousPackage.version,
+            to_version: packageEntry.version,
+        });
+    }
+    return { lines, updatedPackages };
+}
+export function constraintBlockedPackageLines(project) {
+    const lines = [];
+    for (const packageEntry of project.packages) {
+        const latest = packageEntry.registryLatestVersion;
+        if (!latest || latest === packageEntry.spec.version) {
+            continue;
+        }
+        if (!versionIsGreaterThan(latest, packageEntry.spec.version)) {
+            continue;
+        }
+        lines.push(`Available package ${packageEntry.declaration.name} ${packageEntry.spec.version} -> ${latest} (blocked by ${packageEntry.declaration.constraint})`);
+    }
+    return lines.sort();
+}
+export function constraintBlockedPackagesJson(project) {
+    return project.packages
+        .flatMap((packageEntry) => {
+        const latest = packageEntry.registryLatestVersion;
+        if (!latest || latest === packageEntry.spec.version) {
+            return [];
+        }
+        if (!versionIsGreaterThan(latest, packageEntry.spec.version)) {
+            return [];
+        }
+        return [
+            {
+                name: packageEntry.declaration.name,
+                resolved_version: packageEntry.spec.version,
+                registry_latest_version: latest,
+                constraint: packageEntry.declaration.constraint,
+            },
+        ];
+    })
+        .sort((left, right) => left.name.localeCompare(right.name));
+}
+export function printUpdateSummary(previous, updated, selectedPackage, project, title) {
+    const report = buildUpdateSummary(previous, updated, selectedPackage, project);
+    if (report.lines.length === 0) {
+        return false;
+    }
+    process.stdout.write(`${title}\n`);
+    for (const line of report.lines) {
+        process.stdout.write(`${line}\n`);
+    }
+    return true;
+}
+export function printConstraintBlockedPackages(project, title, printTitle) {
+    const lines = constraintBlockedPackageLines(project);
+    if (lines.length === 0) {
+        return false;
+    }
+    if (printTitle) {
+        process.stdout.write(`${title}\n`);
+    }
+    for (const line of lines) {
+        process.stdout.write(`${line}\n`);
+    }
+    return true;
+}
+export function mergeSelectedPackageUpdate(previous, updated, selectedPackage) {
+    return {
+        ...updated,
+        package: updated.package.map((packageEntry) => {
+            if (packageEntry.name === selectedPackage) {
+                return packageEntry;
+            }
+            const previousPackage = previous.package.find((entry) => entry.name === packageEntry.name);
+            if (!previousPackage) {
+                return packageEntry;
+            }
+            return { ...packageEntry, version: previousPackage.version };
+        }),
+    };
+}
+//# sourceMappingURL=update-report.js.map

package/dist/cli/commands/update-report.js.map

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

package/dist/cli/commands/update.d.ts

@@ -0,0 +1,11 @@
+export interface UpdateFlags {
+    packageName?: string;
+    major: boolean;
+    latest: boolean;
+    dryRun: boolean;
+    json: boolean;
+}
+export declare function parseUpdateArguments(argumentsList: string[]): UpdateFlags;
+export declare function runUpdateCommand(argumentsList: string[]): Promise<void>;
+export { previewRemoteUpdates } from "./update-core.js";
+//# sourceMappingURL=update.d.ts.map

package/dist/cli/commands/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/update.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,WAAW,CAiCzE;AAED,wBAAsB,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B7E;AAED,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/cli/commands/update.js

@@ -0,0 +1,65 @@
+import { PrayError } from "../../errors.js";
+import { previewRemoteUpdates, updateWithManifestConstraints, } from "./update-core.js";
+import { updateLatestCommand } from "./update-latest.js";
+export function parseUpdateArguments(argumentsList) {
+    let packageName;
+    let major = false;
+    let latest = false;
+    let dryRun = false;
+    let json = false;
+    for (const argument of argumentsList) {
+        switch (argument) {
+            case "--major":
+                major = true;
+                break;
+            case "--latest":
+                latest = true;
+                break;
+            case "--dry-run":
+                dryRun = true;
+                break;
+            case "--json":
+                json = true;
+                break;
+            default:
+                if (argument.startsWith("--")) {
+                    throw PrayError.unsupported(`unknown update flag: ${argument}`);
+                }
+                if (packageName) {
+                    throw PrayError.unsupported(`unexpected update argument: ${argument}`);
+                }
+                packageName = argument;
+        }
+    }
+    return { packageName, major, latest, dryRun, json };
+}
+export async function runUpdateCommand(argumentsList) {
+    const flags = parseUpdateArguments(argumentsList);
+    if (flags.major && flags.latest) {
+        throw PrayError.unsupported("use either --major or --latest, not both");
+    }
+    if (flags.major) {
+        if (!flags.packageName) {
+            throw PrayError.unsupported("major updates require a package name");
+        }
+        if (flags.dryRun) {
+            throw PrayError.unsupported("major updates are not supported with --dry-run");
+        }
+        await updateLatestCommand(flags.packageName, flags.json);
+        return;
+    }
+    if (flags.latest) {
+        if (flags.dryRun) {
+            throw PrayError.unsupported("--latest is not supported with --dry-run");
+        }
+        await updateLatestCommand(flags.packageName, flags.json);
+        return;
+    }
+    if (flags.dryRun) {
+        await previewRemoteUpdates(flags.packageName, flags.json);
+        return;
+    }
+    await updateWithManifestConstraints(flags.packageName, flags.json, []);
+}
+export { previewRemoteUpdates } from "./update-core.js";
+//# sourceMappingURL=update.js.map

package/dist/cli/commands/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/cli/commands/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EACL,oBAAoB,EACpB,6BAA6B,GAC9B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAUzD,MAAM,UAAU,oBAAoB,CAAC,aAAuB;IAC1D,IAAI,WAA+B,CAAC;IACpC,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;QACrC,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,SAAS;gBACZ,KAAK,GAAG,IAAI,CAAC;gBACb,MAAM;YACR,KAAK,UAAU;gBACb,MAAM,GAAG,IAAI,CAAC;gBACd,MAAM;YACR,KAAK,WAAW;gBACd,MAAM,GAAG,IAAI,CAAC;gBACd,MAAM;YACR,KAAK,QAAQ;gBACX,IAAI,GAAG,IAAI,CAAC;gBACZ,MAAM;YACR;gBACE,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC9B,MAAM,SAAS,CAAC,WAAW,CAAC,wBAAwB,QAAQ,EAAE,CAAC,CAAC;gBAClE,CAAC;gBACD,IAAI,WAAW,EAAE,CAAC;oBAChB,MAAM,SAAS,CAAC,WAAW,CACzB,+BAA+B,QAAQ,EAAE,CAC1C,CAAC;gBACJ,CAAC;gBACD,WAAW,GAAG,QAAQ,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,aAAuB;IAC5D,MAAM,KAAK,GAAG,oBAAoB,CAAC,aAAa,CAAC,CAAC;IAClD,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAChC,MAAM,SAAS,CAAC,WAAW,CAAC,0CAA0C,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YACvB,MAAM,SAAS,CAAC,WAAW,CAAC,sCAAsC,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,SAAS,CAAC,WAAW,CACzB,gDAAgD,CACjD,CAAC;QACJ,CAAC;QACD,MAAM,mBAAmB,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACzD,OAAO;IACT,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,SAAS,CAAC,WAAW,CAAC,0CAA0C,CAAC,CAAC;QAC1E,CAAC;QACD,MAAM,mBAAmB,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACzD,OAAO;IACT,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,MAAM,oBAAoB,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1D,OAAO;IACT,CAAC;IACD,MAAM,6BAA6B,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AACzE,CAAC;AAED,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/cli/commands/workspace.d.ts

@@ -0,0 +1,3 @@
+export declare function runFormat(): Promise<void>;
+export declare function runPackage(): Promise<void>;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/cli/commands/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/workspace.ts"],"names":[],"mappings":"AAqBA,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CA6C/C;AAMD,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAUhD"}

package/dist/cli/commands/workspace.js

@@ -0,0 +1,63 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { packageArchivePath, writePackageArchive, } from "../../archive/praypkg.js";
+import { normalizeLineEndings } from "../../hashing.js";
+import { readLockfile } from "../../lockfile/index.js";
+import { defaultLockfilePath, defaultManifestPath, } from "../../lockfile/paths.js";
+import { classifyFormatHints, formatRecommended, parseManifest, readManifestText, } from "../../manifest/index.js";
+import { defaultResolveOptions } from "../../resolve/context.js";
+import { resolveProject } from "../../resolve/project.js";
+export async function runFormat() {
+    const manifestPath = defaultManifestPath();
+    const original = readManifestText(manifestPath);
+    const manifest = parseManifest(original);
+    let project;
+    try {
+        project = await resolveProject(manifestPath, {
+            ...defaultResolveOptions(),
+            offline: true,
+        });
+    }
+    catch {
+        try {
+            project = await resolveProject(manifestPath);
+        }
+        catch {
+            project = undefined;
+        }
+    }
+    if (project) {
+        const hints = classifyFormatHints(project);
+        const formatted = formatRecommended(manifest, hints);
+        if (formatted !== original) {
+            writeFileSync(manifestPath, formatted, "utf8");
+        }
+    }
+    if (!existsSync(defaultLockfilePath(process.cwd()))) {
+        return;
+    }
+    const lockfile = readLockfile(defaultLockfilePath(process.cwd()));
+    for (const target of lockfile.target) {
+        for (const output of target.outputs) {
+            if (!existsSync(output)) {
+                continue;
+            }
+            const originalOutput = readFileSync(output, "utf8");
+            const formattedOutput = formatMarkerComments(normalizeLineEndings(originalOutput));
+            if (formattedOutput !== originalOutput) {
+                writeFileSync(output, formattedOutput, "utf8");
+            }
+        }
+    }
+}
+function formatMarkerComments(text) {
+    return text.replace(/<!--\s*pray:/g, "<!-- pray:");
+}
+export async function runPackage() {
+    const project = await resolveProject(defaultManifestPath());
+    for (const packageEntry of project.packages) {
+        const outputPath = packageArchivePath(packageEntry.declaration.name, packageEntry.spec.version);
+        writePackageArchive(packageEntry, outputPath);
+        process.stdout.write(`wrote ${outputPath}\n`);
+    }
+}
+//# sourceMappingURL=workspace.js.map

package/dist/cli/commands/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../../src/cli/commands/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EACL,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,MAAM,YAAY,GAAG,mBAAmB,EAAE,CAAC;IAC3C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAEzC,IAAI,OAAoC,CAAC;IACzC,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,cAAc,CAAC,YAAY,EAAE;YAC3C,GAAG,qBAAqB,EAAE;YAC1B,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,cAAc,CAAC,YAAY,CAAC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,SAAS,CAAC;QACtB,CAAC;IACH,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACrD,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC3B,aAAa,CAAC,YAAY,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;QACpD,OAAO;IACT,CAAC;IACD,MAAM,QAAQ,GAAG,YAAY,CAAC,mBAAmB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAClE,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACpC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxB,SAAS;YACX,CAAC;YACD,MAAM,cAAc,GAAG,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACpD,MAAM,eAAe,GAAG,oBAAoB,CAC1C,oBAAoB,CAAC,cAAc,CAAC,CACrC,CAAC;YACF,IAAI,eAAe,KAAK,cAAc,EAAE,CAAC;gBACvC,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC5D,KAAK,MAAM,YAAY,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC5C,MAAM,UAAU,GAAG,kBAAkB,CACnC,YAAY,CAAC,WAAW,CAAC,IAAI,EAC7B,YAAY,CAAC,IAAI,CAAC,OAAO,CAC1B,CAAC;QACF,mBAAmB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAC9C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,UAAU,IAAI,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/cli/help.d.ts

@@ -0,0 +1,6 @@
+export declare function conciseHelpText(): string;
+export declare const HELP_TEXT: string;
+export declare function commandHelpText(command: string): string | undefined;
+export type HelpDispatchResult = "printed" | "not_help";
+export declare function maybePrintHelp(argumentsList: string[]): HelpDispatchResult;
+//# sourceMappingURL=help.d.ts.map

package/dist/cli/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAkHA,wBAAgB,eAAe,IAAI,MAAM,CAmBxC;AAED,eAAO,MAAM,SAAS,QAAoB,CAAC;AAE3C,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMnE;AAED,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,UAAU,CAAC;AAExD,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,kBAAkB,CA+C1E"}

package/dist/cli/help.js

@@ -0,0 +1,164 @@
+const DOCS_URL = "https://github.com/kiskolabs/pray";
+const WORKFLOW_COMMANDS = [
+    "install [--locked|--frozen|--offline]  resolve, render, and write Prayfile.lock",
+    "plan [--remote]                        preview materialization changes",
+    "apply                                  apply the current plan",
+    "verify [--strict]                      check rendered output against the lockfile",
+    "drift [--semantic]                     compare lockfile to current resolution",
+    "render [--check]                       render targets without updating the lockfile",
+    "format|fmt                             rewrite Prayfile to recommended destination DSL",
+];
+const PACKAGE_COMMANDS = [
+    "add <name> [constraint] [--path PATH]",
+    "remove <name>",
+    "update [package] [--major] [--latest] [--dry-run] [--json]",
+    "unlock <package>",
+    "vendor                                 copy resolved packages locally",
+    "clean                                  remove local cache and vendor trees",
+];
+const DISTRIBUTION_COMMANDS = [
+    "publish --root PATH [--server URL ...]",
+    "login --server URL --email EMAIL",
+    "serve [--root PATH] [--host HOST] [--port PORT] [--stdio]",
+    "sync [--root PATH] [--peer URL ...]",
+    "confess <package> | --from-lock SPAN_ID [--accepted|--rejected]",
+];
+const TRUST_COMMANDS = [
+    "trust list|show|add-key|remove-key|set-signed|set-allow|import-repo|import-registry|check",
+];
+const INSPECT_COMMANDS = [
+    "list                                   list declared packages",
+    "outdated [--remote]                      show constraint vs resolved versions",
+    "explain <package>                        show why a package was selected",
+    "tree                                     print the dependency tree",
+];
+const META_COMMANDS = [
+    "init [--targets tool_a,tool_b]",
+    "prayer init                            scaffold a prayer package",
+    "repo init                              scaffold a distribution root",
+    "manifest                               print canonical Prayfile JSON",
+    "package                                build a distributable prayer archive",
+    "upgrade                                install the latest pray CLI release",
+    "version | -V | --version",
+];
+const COMMAND_HELP = {
+    install: "install — resolve packages, render targets, and update Prayfile.lock\n\n" +
+        "Usage: pray install [--locked|--frozen|--offline]\n\n" +
+        "--locked   require an existing lockfile\n" +
+        "--frozen   require lockfile to match Prayfile exactly\n" +
+        "--offline  use cache only",
+    verify: "verify — check rendered files against Prayfile.lock\n\n" +
+        "Usage: pray verify [--strict]\n\n" +
+        "Without --strict, orphan-marker warnings print to stderr but exit 0.\n" +
+        "With --strict, any finding fails with exit code 6.",
+    drift: "drift — report differences between lockfile and current resolution\n\n" +
+        "Usage: pray drift [--semantic]\n\n" +
+        "Exits with code 6 when drift is found.",
+    update: "update — refresh package versions within constraints\n\n" +
+        "Usage: pray update [package] [--major] [--latest] [--dry-run] [--json]",
+    plan: "plan — preview install/apply changes\n\nUsage: pray plan [--remote]",
+    outdated: "outdated — show constraint vs resolved versions\n\n" +
+        "Usage: pray outdated [--remote]",
+    apply: "apply — materialize the current resolution plan\n\nUsage: pray apply",
+    login: "login — authenticate to a registry server\n\n" +
+        "Usage: pray login --server URL --email EMAIL (--passkey-key PATH --credential-id ID | --ssh-agent --public-key PATH)",
+    upgrade: "upgrade — install the latest pray CLI release\n\n" +
+        "Usage: pray upgrade\n\n" +
+        "Runs `npm install -g pray-cli@latest`.",
+    trust: "trust — manage client trust policy for remote sources\n\n" +
+        "Usage: pray trust <subcommand>\n\n" +
+        "Subcommands: list, show, add-key, remove-key, set-signed, set-allow, import-repo, import-registry, check",
+    init: "init — create a starter Prayfile\n\nUsage: pray init [--targets tool_a,tool_b]",
+    add: "add — declare a package in Prayfile\n\nUsage: pray add <name> [constraint] [--path PATH]",
+    publish: "publish — upload packages to a registry or local root\n\n" +
+        "Usage: pray publish --root PATH [--server URL ...]",
+    serve: "serve — run a local registry server\n\n" +
+        "Usage: pray serve [--root PATH] [--host HOST] [--port PORT] [--stdio]",
+};
+function printCommandGroups() {
+    const lines = [
+        "Workflow:",
+        ...WORKFLOW_COMMANDS.map((line) => `  ${line}`),
+        "Packages:",
+        ...PACKAGE_COMMANDS.map((line) => `  ${line}`),
+        "Distribution:",
+        ...DISTRIBUTION_COMMANDS.map((line) => `  ${line}`),
+        "Trust:",
+        ...TRUST_COMMANDS.map((line) => `  ${line}`),
+        "Inspect:",
+        ...INSPECT_COMMANDS.map((line) => `  ${line}`),
+        "Meta:",
+        ...META_COMMANDS.map((line) => `  ${line}`),
+        "Global flags: --no-input (disable prompts), --rm (ephemeral home), --trust [--global]",
+    ];
+    return `${lines.join("\n")}\n`;
+}
+export function conciseHelpText() {
+    return [
+        "pray — reproducible inference input for projects",
+        "",
+        "Declare shared instructions in Prayfile, lock versions, and render tool-specific output.",
+        "",
+        "Getting started:",
+        "  pray init",
+        "  pray install",
+        "  pray plan",
+        "  pray apply",
+        "  pray verify",
+        "",
+        printCommandGroups(),
+        "Run `pray help <command>` or `pray <command> --help` for one command.",
+        `Documentation: ${DOCS_URL}`,
+        "Exit codes: 0 success; 2 usage/parse; 3 resolution; 4 integrity; 5 render; 6 verify; 8 unsupported.",
+        "",
+    ].join("\n");
+}
+export const HELP_TEXT = conciseHelpText();
+export function commandHelpText(command) {
+    const text = COMMAND_HELP[command];
+    if (!text) {
+        return undefined;
+    }
+    return `${text}\n\nDocumentation: ${DOCS_URL}\n`;
+}
+export function maybePrintHelp(argumentsList) {
+    if (argumentsList.length === 0) {
+        process.stdout.write(conciseHelpText());
+        return "printed";
+    }
+    if (argumentsList.length === 1 &&
+        (argumentsList[0] === "help" ||
+            argumentsList[0] === "-h" ||
+            argumentsList[0] === "--help")) {
+        process.stdout.write(conciseHelpText());
+        return "printed";
+    }
+    if (argumentsList[0] === "help") {
+        const target = argumentsList[1] ?? "";
+        if (target === "" || target === "-h" || target === "--help") {
+            process.stdout.write(conciseHelpText());
+            return "printed";
+        }
+        const text = commandHelpText(target);
+        if (text) {
+            process.stdout.write(text);
+            return "printed";
+        }
+        return "not_help";
+    }
+    const helpPosition = argumentsList.findIndex((argument) => argument === "--help" || argument === "-h");
+    if (helpPosition >= 0) {
+        if (helpPosition === 0) {
+            process.stdout.write(conciseHelpText());
+            return "printed";
+        }
+        const text = commandHelpText(argumentsList[0] ?? "");
+        if (text) {
+            process.stdout.write(text);
+            return "printed";
+        }
+        return "not_help";
+    }
+    return "not_help";
+}
+//# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

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

package/dist/cli/invocation.d.ts

@@ -0,0 +1,10 @@
+import { type ResolveOptions } from "../resolve/context.js";
+import type { ResolvedProject } from "../resolve/types.js";
+export declare function initializeInvocation(argumentsList: string[]): string[];
+export declare function manifestPath(): string;
+export declare function projectRoot(): string;
+export declare function lockfilePath(): string;
+export declare function selectedEnvironment(): string | undefined;
+export declare function resolveCurrentProject(options?: ResolveOptions): Promise<ResolvedProject>;
+export declare function resolveCurrentProjectWithGitRefreshFallback(options?: ResolveOptions, allowGitRefreshFallback?: boolean): Promise<ResolvedProject>;
+//# sourceMappingURL=invocation.d.ts.map

package/dist/cli/invocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocation.d.ts","sourceRoot":"","sources":["../../src/cli/invocation.ts"],"names":[],"mappings":"AAUA,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAK/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAKtE;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAExD;AAED,wBAAsB,qBAAqB,CACzC,OAAO,GAAE,cAAwC,GAChD,OAAO,CAAC,eAAe,CAAC,CAO1B;AAED,wBAAsB,2CAA2C,CAC/D,OAAO,GAAE,cAAwC,EACjD,uBAAuB,UAAQ,GAC9B,OAAO,CAAC,eAAe,CAAC,CAW1B"}