@pleri/olam-cli 0.1.201 → 0.1.205

package/dist/commands/update.js

@@ -1,331 +0,0 @@
-/**
- * olam update — Friendly wrapper around `npm install -g @pleri/olam-cli@<channel>`.
- *
- * F1: core install flow with snapshot-prev → install → restore-on-failure (D24)
- *     + scan-and-reconcile skill symlinks (T22/OQ29).
- * F2: --to=<ver>, --rollback, --check, --channel=<ch>.
- * F3: --freeze, --force, upgrade_blocked field check.
- *
- * T23 note: self-replace while running is harmless on POSIX — the OS keeps the
- * old inode open until exit; the new binary is a separate inode. No special
- * handling needed.
- */
-import * as fs from 'node:fs';
-import * as os from 'node:os';
-import * as path from 'node:path';
-import { execSync } from 'node:child_process';
-import pc from 'picocolors';
-import { reconcileSkillSymlinks } from '../lib/symlink-reconcile.js';
-const PACKAGE_NAME = '@pleri/olam-cli';
-const CACHE_DIR = path.join(os.homedir(), '.olam', 'cache');
-const LOG_DIR = path.join(os.homedir(), '.olam', 'log');
-const LAST_STABLE_FILE = path.join(CACHE_DIR, 'last-stable.txt');
-/** Base host for the dynamically-compiled changelog page (see packages/cloudflare-worker/src/changelog.ts). */
-const CHANGELOG_BASE = 'https://olam.bar.dev';
-/** Full GitHub releases list — fallback when there is no from-version to anchor a range. */
-const RELEASES_PAGE = 'https://github.com/pleri/olam/releases';
-/**
- * Normalize a version string to the `vX.Y.Z` tag shape the changelog page
- * (and GitHub release tags) use. npm reports versions without the leading
- * `v` (e.g. `0.1.196`); the changelog route keys on the tag form.
- */
-export function normalizeVersionTag(version) {
-    const trimmed = version.trim();
-    return trimmed.startsWith('v') ? trimmed : `v${trimmed}`;
-}
-/**
- * Build the version-range changelog URL of the shape
- * `https://olam.bar.dev/changelog/<from>/to/<to>`. Both ends are normalized
- * to the `vX.Y.Z` tag form. The range is immutable once both versions are
- * released, so the page is safely cacheable.
- */
-export function buildChangelogUrl(fromVersion, toVersion) {
-    const from = encodeURIComponent(normalizeVersionTag(fromVersion));
-    const to = encodeURIComponent(normalizeVersionTag(toVersion));
-    return `${CHANGELOG_BASE}/changelog/${from}/to/${to}`;
-}
-/**
- * Compute the operator-facing "what changed" lines to print after an update,
- * given the from-version (previously installed) and to-version (just installed).
- *
- * Edge cases (matches the feature spec):
- *   - same version (no-op): no changelog line at all
- *   - first install (no from-version): link to the full releases page
- *   - downgrade (from > to): still emit the range URL (the page renders it)
- *   - normal upgrade: emit the range URL
- */
-export function changelogMessages(prevVersion, newVersion) {
-    if (!newVersion)
-        return [];
-    // First install — no prior version to anchor a range.
-    if (!prevVersion) {
-        return [`What's new: ${RELEASES_PAGE}`];
-    }
-    // Same version — `npm install` was a no-op; nothing changed.
-    if (normalizeVersionTag(prevVersion) === normalizeVersionTag(newVersion)) {
-        return [];
-    }
-    // Normal upgrade OR downgrade — the page renders the range either way.
-    return [`What changed: ${buildChangelogUrl(prevVersion, newVersion)}`];
-}
-function defaultExec(cmd) {
-    try {
-        const stdout = execSync(cmd, { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'] });
-        return { exitCode: 0, stdout, stderr: '' };
-    }
-    catch (err) {
-        const e = err;
-        return { exitCode: e.status ?? 1, stdout: e.stdout ?? '', stderr: e.stderr ?? '' };
-    }
-}
-export function getCurrentVersion(_exec = defaultExec) {
-    const result = _exec(`npm ls -g ${PACKAGE_NAME} --json --depth=0`);
-    if (result.exitCode !== 0)
-        return null;
-    try {
-        const parsed = JSON.parse(result.stdout);
-        return parsed.dependencies?.[PACKAGE_NAME]?.version ?? null;
-    }
-    catch {
-        return null;
-    }
-}
-export function readLastStable(file = LAST_STABLE_FILE) {
-    try {
-        const v = fs.readFileSync(file, 'utf-8').trim();
-        return v || null;
-    }
-    catch {
-        return null;
-    }
-}
-export function writeLastStable(version, file = LAST_STABLE_FILE) {
-    fs.mkdirSync(path.dirname(file), { recursive: true });
-    fs.writeFileSync(file, version, { mode: 0o644 });
-}
-function logUpdateFailure(stderr) {
-    const ts = new Date().toISOString().slice(0, 10);
-    const logFile = path.join(LOG_DIR, `update-${ts}.log`);
-    try {
-        fs.mkdirSync(LOG_DIR, { recursive: true });
-        fs.appendFileSync(logFile, `[update-failure ${new Date().toISOString()}]\n${stderr}\n`, 'utf-8');
-    }
-    catch { /* best-effort */ }
-}
-/** Allowlist for channel/version values before shell interpolation (HIGH fix). */
-const SAFE_VERSION_RE = /^[a-zA-Z0-9._-]{1,64}$/;
-/**
- * Check whether the published package has upgrade_blocked: true in its package.json.
- * Returns true when the field is present and truthy; false otherwise (including on error).
- */
-export function isUpgradeBlocked(channelOrVersion, _exec = defaultExec) {
-    if (!SAFE_VERSION_RE.test(channelOrVersion))
-        return false;
-    const result = _exec(`npm view ${PACKAGE_NAME}@${channelOrVersion} olam.upgrade_blocked --json`);
-    if (result.exitCode !== 0)
-        return false;
-    try {
-        const val = JSON.parse(result.stdout.trim());
-        return val === true;
-    }
-    catch {
-        return false;
-    }
-}
-export async function doUpdate(opts, _exec = defaultExec, _reconcile = reconcileSkillSymlinks, _readConfig, _getNpmRoot = defaultExec) {
-    const readConfig = _readConfig ?? (async () => {
-        const { readMachineConfig } = await import('@olam/core/src/config/machine-schema.js');
-        return readMachineConfig();
-    });
-    const config = await readConfig();
-    const channel = opts.channel ?? config?.channel ?? 'stable';
-    const quiet = opts.quiet ?? false;
-    const force = opts.force ?? false;
-    // Allowlist channel/version before any shell interpolation (HIGH security fix)
-    if (!SAFE_VERSION_RE.test(channel)) {
-        if (!quiet)
-            console.error(`Invalid channel/version: ${channel}`);
-        return { action: 'failed', exitCode: 11 };
-    }
-    // F3: respect auto_update: false (frozen) unless --force
-    if (!force && config && config.auto_update === false) {
-        if (!quiet) {
-            console.log('Updates frozen. Run `olam update --force` to override or `olam update --freeze` to manage.');
-        }
-        return { action: 'failed', exitCode: 11 };
-    }
-    // F3: check upgrade_blocked on target version (best-effort; don't block on error)
-    if (!force) {
-        const blocked = isUpgradeBlocked(channel, _exec);
-        if (blocked) {
-            if (!quiet) {
-                console.error(`Version @${channel} has upgrade_blocked: true. Run with --force to override.`);
-            }
-            return { action: 'failed', exitCode: 11 };
-        }
-    }
-    // Snapshot current version before any mutation (D24)
-    const prevVersion = getCurrentVersion(_exec);
-    if (prevVersion) {
-        writeLastStable(prevVersion);
-    }
-    if (!quiet) {
-        console.log(pc.cyan(`Installing ${PACKAGE_NAME}@${channel}…`));
-    }
-    const installResult = _exec(`npm install -g ${PACKAGE_NAME}@${channel}`);
-    if (installResult.exitCode !== 0) {
-        logUpdateFailure(installResult.stderr);
-        if (!quiet) {
-            console.error(pc.red('Update failed.'));
-        }
-        // Auto-restore (D24)
-        const prev = readLastStable();
-        if (prev) {
-            if (!quiet) {
-                console.log(pc.yellow(`Restoring to ${prev}…`));
-            }
-            const restoreResult = _exec(`npm install -g ${PACKAGE_NAME}@${prev}`);
-            if (restoreResult.exitCode !== 0) {
-                if (!quiet) {
-                    console.error(pc.red(`Restore also failed. Run: npm install -g ${PACKAGE_NAME}@${prev} manually.`));
-                }
-            }
-            else if (!quiet) {
-                console.log(pc.yellow(`Restored to ${prev}.`));
-            }
-        }
-        else if (!quiet) {
-            console.error(pc.red('No previous version cached; cannot auto-restore.'));
-        }
-        return { action: 'restored', prevVersion: prev ?? undefined, exitCode: 11 };
-    }
-    // Success path: get new version + reconcile symlinks
-    const newVersion = getCurrentVersion(_exec) ?? undefined;
-    if (!quiet && newVersion) {
-        console.log(pc.green(`Updated to ${newVersion}.`));
-        // Surface the version-range changelog so the operator can see what
-        // changed between their old and new version (feature: olam update changelog).
-        for (const line of changelogMessages(prevVersion, newVersion)) {
-            console.log(pc.cyan(line));
-        }
-    }
-    // Scan-and-reconcile skill symlinks (T22/OQ29)
-    const npmRootResult = _getNpmRoot('npm root -g');
-    let symlinkResult = { added: [], removed: [] };
-    if (npmRootResult.exitCode === 0) {
-        const npmRoot = npmRootResult.stdout.trim();
-        const npmSkillsDir = path.join(npmRoot, '@pleri', 'olam-cli', 'plugin', 'skills');
-        const claudeSkillsDir = path.join(os.homedir(), '.claude', 'skills');
-        const rec = _reconcile(npmSkillsDir, claudeSkillsDir);
-        symlinkResult = { added: rec.added, removed: rec.removed };
-        if (!quiet && (rec.added.length > 0 || rec.removed.length > 0)) {
-            if (rec.added.length > 0) {
-                console.log(pc.dim(`Skills added: ${rec.added.join(', ')}`));
-            }
-            if (rec.removed.length > 0) {
-                console.log(pc.dim(`Skills removed (dangling): ${rec.removed.join(', ')}`));
-            }
-        }
-    }
-    return {
-        action: 'installed',
-        version: newVersion,
-        prevVersion: prevVersion ?? undefined,
-        exitCode: 0,
-        symlinks: symlinkResult,
-    };
-}
-export async function doCheck(_exec = defaultExec) {
-    const current = getCurrentVersion(_exec);
-    const viewResult = _exec(`npm view ${PACKAGE_NAME} dist-tags.stable`);
-    const latest = viewResult.exitCode === 0 ? viewResult.stdout.trim() || null : null;
-    if (current && latest && current === latest) {
-        return { action: 'already-current', current, latest, exitCode: 10 };
-    }
-    return { action: 'update-available', current, latest, exitCode: 0 };
-}
-export async function doRollback(_exec = defaultExec, _reconcile = reconcileSkillSymlinks, _getNpmRoot = defaultExec) {
-    const prev = readLastStable();
-    if (!prev) {
-        return { action: 'nothing-to-rollback', exitCode: 14 };
-    }
-    // OQ26: if last-stable.txt already equals the current version → already rolled back
-    const current = getCurrentVersion(_exec);
-    if (current && current === prev) {
-        return { action: 'already-at-cached', restoredVersion: prev, exitCode: 0 };
-    }
-    const result = _exec(`npm install -g ${PACKAGE_NAME}@${prev}`);
-    if (result.exitCode !== 0) {
-        return { action: 'failed', restoredVersion: prev, exitCode: 11 };
-    }
-    // Reconcile symlinks after restore
-    const npmRootResult = _getNpmRoot('npm root -g');
-    if (npmRootResult.exitCode === 0) {
-        const npmRoot = npmRootResult.stdout.trim();
-        _reconcile(path.join(npmRoot, '@pleri', 'olam-cli', 'plugin', 'skills'), path.join(os.homedir(), '.claude', 'skills'));
-    }
-    return { action: 'rolled-back', restoredVersion: prev, exitCode: 0 };
-}
-export function registerUpdate(program) {
-    program
-        .command('update')
-        .description('Update @pleri/olam-cli to the latest version on the configured channel')
-        .option('--to <version>', 'Install a specific version')
-        .option('--rollback', 'Restore the previously installed version')
-        .option('--check', 'Check if a newer version is available (read-only)')
-        .option('--channel <channel>', 'Switch to channel and install (stable|beta|edge)')
-        .option('--freeze', 'Disable automatic updates (sets auto_update: false)')
-        .option('--force', 'Override freeze and upgrade_blocked checks')
-        .option('--quiet', 'Suppress output')
-        .action(async (opts) => {
-        if (opts.freeze) {
-            const { readMachineConfig, writeMachineConfig, MachineConfigSchema } = await import('@olam/core/src/config/machine-schema.js');
-            const cfg = readMachineConfig() ?? MachineConfigSchema.parse({});
-            writeMachineConfig({ ...cfg, auto_update: false });
-            if (!opts.quiet)
-                console.log('Updates frozen. Run `olam update --force` to override.');
-            return;
-        }
-        if (opts.check) {
-            const r = await doCheck();
-            if (!opts.quiet) {
-                if (r.action === 'already-current') {
-                    console.log(`Already on latest: ${r.current}`);
-                }
-                else {
-                    console.log(`Current: ${r.current ?? 'unknown'}, Latest: ${r.latest ?? 'unknown'}`);
-                }
-            }
-            process.exitCode = r.exitCode;
-            return;
-        }
-        if (opts.rollback) {
-            const r = await doRollback();
-            if (!opts.quiet) {
-                if (r.action === 'nothing-to-rollback') {
-                    console.error('Nothing to roll back. Use --to=<version> for a specific target.');
-                }
-                else if (r.action === 'already-at-cached') {
-                    console.log(`Already at cached version ${r.restoredVersion}. Use --to=<v> for older targets.`);
-                }
-                else if (r.action === 'rolled-back') {
-                    console.log(`Rolled back to ${r.restoredVersion}.`);
-                }
-                else {
-                    console.error(`Rollback failed.`);
-                }
-            }
-            process.exitCode = r.exitCode;
-            return;
-        }
-        if (opts.channel) {
-            // Write config then install
-            const { readMachineConfig, writeMachineConfig, MachineConfigSchema } = await import('@olam/core/src/config/machine-schema.js');
-            const cfg = readMachineConfig() ?? MachineConfigSchema.parse({});
-            writeMachineConfig({ ...cfg, channel: opts.channel });
-        }
-        const result = await doUpdate({ channel: opts.to ?? opts.channel, quiet: opts.quiet, force: opts.force });
-        process.exitCode = result.exitCode;
-    });
-}
-//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

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

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

@@ -1,15 +0,0 @@
-/**
- * `olam upgrade --history` — read + format the JSONL audit log.
- *
- * Phase 2c — C2.
- */
-export interface HistoryOpts {
-    readonly limit: number;
-    readonly json: boolean;
-}
-export declare function parseHistoryOpts(raw: {
-    n?: string | number;
-    json?: boolean;
-}): HistoryOpts;
-export declare function handleHistory(opts: HistoryOpts): void;
-//# sourceMappingURL=upgrade-history.d.ts.map

package/dist/commands/upgrade-history.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"upgrade-history.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade-history.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,WAAW,CAY1F;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAarD"}

package/dist/commands/upgrade-history.js

@@ -1,34 +0,0 @@
-/**
- * `olam upgrade --history` — read + format the JSONL audit log.
- *
- * Phase 2c — C2.
- */
-import { readUpgradeLog, formatHistoryTable, formatHistoryJson, UPGRADE_LOG_PATH } from './upgrade-log.js';
-import { printInfo } from '../output.js';
-export function parseHistoryOpts(raw) {
-    const rawLimit = raw.n;
-    const limit = typeof rawLimit === 'number'
-        ? rawLimit
-        : typeof rawLimit === 'string'
-            ? Number.parseInt(rawLimit, 10)
-            : 10;
-    return {
-        limit: Number.isFinite(limit) && limit > 0 ? limit : 10,
-        json: raw.json === true,
-    };
-}
-export function handleHistory(opts) {
-    const rows = readUpgradeLog(opts.limit);
-    if (opts.json) {
-        process.stdout.write(formatHistoryJson(rows) + '\n');
-        return;
-    }
-    if (rows.length === 0) {
-        printInfo('Log file', UPGRADE_LOG_PATH);
-        process.stdout.write(formatHistoryTable(rows) + '\n');
-        return;
-    }
-    printInfo('Log file', UPGRADE_LOG_PATH);
-    process.stdout.write(formatHistoryTable(rows) + '\n');
-}
-//# sourceMappingURL=upgrade-history.js.map

package/dist/commands/upgrade-history.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"upgrade-history.js","sourceRoot":"","sources":["../../src/commands/upgrade-history.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC3G,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAOzC,MAAM,UAAU,gBAAgB,CAAC,GAA4C;IAC3E,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC;IACvB,MAAM,KAAK,GACT,OAAO,QAAQ,KAAK,QAAQ;QAC1B,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,OAAO,QAAQ,KAAK,QAAQ;YAC5B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC;YAC/B,CAAC,CAAC,EAAE,CAAC;IACX,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QACvD,IAAI,EAAE,GAAG,CAAC,IAAI,KAAK,IAAI;KACxB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAiB;IAC7C,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACrD,OAAO;IACT,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,SAAS,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;QACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACtD,OAAO;IACT,CAAC;IACD,SAAS,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;AACxD,CAAC"}

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

@@ -1,93 +0,0 @@
-/**
- * `olam upgrade` CLI lock — atomic create-or-fail with stale-lock recovery.
- *
- * Lock file: ~/.olam/.upgrade.lock
- * Contents:  {"pid": <int>, "startTs": <epoch-ms>}
- *
- * Stale-lock semantics:
- *   - File unreadable / parse error / empty  → stale
- *   - PID not alive (process.kill(pid, 0) throws) → stale
- *   - PID alive but command name is not node/olam → stale (avoids macOS PID-recycling false-positives)
- *   - start_ts > 30 min ago → stale
- *   - Otherwise → live; second invocation refuses with exit 1.
- *
- * Atomicity: fs.openSync(path, 'wx') is atomic create-or-fail per POSIX. No TOCTOU window.
- */
-export declare const LOCK_FILE_PATH: string;
-export declare const STALE_LOCK_TIMEOUT_MS: number;
-export interface LockContent {
-    readonly pid: number;
-    readonly startTs: number;
-}
-export type AcquireResult = {
-    acquired: true;
-    lockPath: string;
-} | {
-    acquired: false;
-    reason: 'live' | 'race';
-    existingPid?: number;
-    existingStartTs?: number;
-};
-/**
- * Read lock file contents. Returns null on:
- *   - file missing
- *   - empty file
- *   - JSON parse error
- *   - shape mismatch (missing pid or startTs as numbers)
- *
- * Caller treats null as "stale lock; can recover."
- */
-export declare function readLockFile(lockPath: string): LockContent | null;
-/** Returns true if process exists, false on ESRCH or any other error. */
-export declare function isPidAlive(pid: number): boolean;
-/**
- * Sentinel returned when `ps` itself is unavailable (binary missing, fork
- * pressure, container without procfs). Distinct from "ps ran but the PID
- * doesn't exist" which returns the empty string equivalent (null).
- *
- * Callers MUST treat this sentinel as "command unknown — assume live, refuse
- * to recover" so a missing `ps` binary cannot stealth-break the lock.
- *
- * Per audit A1-003: previously returned null on both branches and isStaleLock
- * treated null as stale, which let `ps`-unavailable invocations silently
- * unlink a live olam upgrade's lock and corrupt the docker layer cache.
- */
-export declare const PS_UNAVAILABLE = "__ps_unavailable__";
-/**
- * Match command names that legitimately hold the upgrade lock.
- *
- * Accepts:
- *   - `node`, `olam`, `olam-cli` (canonical)
- *   - path-prefixed forms (`/usr/local/bin/node` — strip via basename)
- *   - worker-pool suffixed forms (`node (vitest 1)` — strip parenthesized suffix)
- *
- * Rejects unrelated commands (bash, zsh, python3, etc.) so PID recycling to a
- * non-node process correctly classifies the lock as stale.
- */
-export declare function isOlamUpgradeCommand(comm: string | null | typeof PS_UNAVAILABLE): boolean;
-/**
- * Stale-lock test. Returns true if the lock should be recovered (deleted + retried).
- *
- * Inputs:
- *   - content: parsed lock contents (null → empty/parse-error/missing → stale)
- *   - nowMs: current epoch ms (defaults to Date.now(); injected for test determinism)
- */
-export declare function isStaleLock(content: LockContent | null, nowMs?: number): boolean;
-/**
- * Atomically acquire the upgrade lock.
- *
- * Returns { acquired: true } on success, or { acquired: false, reason } when a live lock exists.
- * Stale locks are auto-recovered (delete + retry once).
- *
- * Side effects:
- *   - mkdir -p path.dirname(lockPath) (ensures ~/.olam exists)
- *   - writes JSON {pid, startTs} to lockPath
- */
-export declare function acquireLock(lockPath?: string, nowMs?: number): AcquireResult;
-/** Release the lock. Idempotent — no error if file already removed. */
-export declare function releaseLock(lockPath?: string): void;
-/** Format a human-readable refusal message for the operator. */
-export declare function formatRefusalMessage(result: Extract<AcquireResult, {
-    acquired: false;
-}>, lockPath?: string): string;
-//# sourceMappingURL=upgrade-lock.d.ts.map

package/dist/commands/upgrade-lock.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"upgrade-lock.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,eAAO,MAAM,cAAc,QAAoD,CAAC;AAKhF,eAAO,MAAM,qBAAqB,QAAgB,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpC;IACE,QAAQ,EAAE,KAAK,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEN;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAWjE;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO/C;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,uBAAuB,CAAC;AAuBnD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,cAAc,GAAG,OAAO,CAMzF;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,EAAE,KAAK,GAAE,MAAmB,GAAG,OAAO,CAY5F;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,QAAQ,GAAE,MAAuB,EACjC,KAAK,GAAE,MAAmB,GACzB,aAAa,CAkDf;AAED,uEAAuE;AACvE,wBAAgB,WAAW,CAAC,QAAQ,GAAE,MAAuB,GAAG,IAAI,CAOnE;AAED,gEAAgE;AAChE,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,OAAO,CAAC,aAAa,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAA;CAAE,CAAC,EACnD,QAAQ,GAAE,MAAuB,GAChC,MAAM,CASR"}