@on-par/factory-cli 0.9.5-next.9 → 0.9.5

package/dist/cli/land-pr.d.ts

@@ -0,0 +1,102 @@
+import type { Octokit } from '@octokit/rest';
+import type { EventKind, ParkReason } from '@on-par/factory-core';
+import type { CiOutcome, WatchChecksOptions } from '@on-par/factory-core/internal';
+export type CommandRunner = (command: string, options?: {
+    cwd?: string;
+    timeout?: number;
+}) => Promise<unknown>;
+export declare function squashMergeAndDelete(octokit: Octokit, owner: string, repoName: string, branch: string, prNumber: number, 
+/** `sha`: the CI-verified head commit. GitHub refuses the merge if the PR head has moved. */
+opts?: {
+    admin?: boolean;
+    run?: CommandRunner;
+    sha?: string;
+}): Promise<void>;
+export declare class MergeGatedError extends Error {
+    readonly issue: number;
+    readonly prNumber: number;
+    readonly label: string;
+    constructor(message: string, issue: number, prNumber: number, label: string);
+}
+export declare class LandConflictError extends Error {
+    readonly parkReason: ParkReason;
+}
+export declare class AwaitingReviewError extends Error {
+    readonly prNumber: number;
+    constructor(message: string, prNumber: number);
+}
+export declare class LandFailureError extends Error {
+    readonly code: number;
+    constructor(message: string, code: number);
+}
+/** Thrown when watchChecks reports a confirmed CI failure — a completed check run with a
+ *  non-passing conclusion. A confirmed failing check must never be merged, admin override
+ *  or not. See CiUnverifiedError for the no-verdict case. */
+export declare class CiFailedError extends Error {
+    readonly prNumber: number;
+    readonly parkReason: ParkReason;
+    constructor(message: string, prNumber: number);
+}
+/** Thrown when the CI watch never reached a green verdict — a deadline timeout, no check runs ever
+ *  registering, or repeated API failures. A subclass of CiFailedError so every existing guard
+ *  (parkReasonFor → 'ci-failed', worktree cleanup, cmdLand's exit-0 path) treats "we don't know"
+ *  exactly like "we know it's red": never merge. */
+export declare class CiUnverifiedError extends CiFailedError {
+}
+/** Thrown when the one infra rerun (#2365) also failed for infrastructure reasons on the same head SHA (#2366).
+ *  A CiFailedError subclass so every guard still leaves the PR open and unmerged, but it parks as
+ *  'ci-infra', which the ADR-0155 steward skips. */
+export declare class CiInfraError extends CiFailedError {
+    readonly parkReason: ParkReason;
+}
+/** True when GitHub refused a SHA-pinned merge because the PR head moved past the verified
+ *  commit (REST 409, or gh's "Head branch was modified"). Retrying as-is can never succeed. */
+export declare function isHeadModifiedMergeError(err: unknown): boolean;
+export declare function isReviewRequiredMergeError(err: unknown, state: {
+    mergeStateStatus?: string;
+    reviewDecision?: string;
+}): boolean;
+export declare function getPullRequestLandState(octokit: Octokit, owner: string, repoName: string, prNumber: number): Promise<{
+    id?: string;
+    isDraft?: boolean;
+    mergeStateStatus?: string;
+    reviewDecision?: string;
+}>;
+export declare function markPullRequestReady(octokit: Octokit, pullRequestId: string): Promise<void>;
+export declare function rebaseDirtyPullRequest(opts: {
+    issue: number;
+    branch: string;
+    worktree: string;
+    prNumber: number;
+    log: (type: EventKind, msg: string) => void;
+    run?: CommandRunner;
+    pathExists?: (path: string) => boolean;
+}): Promise<void>;
+/** A critical section runner: the land path takes this instead of owning lock composition,
+ *  so the locks can be scoped to git mutations and stubbed in tests (#645). */
+export type LandLock = <T>(fn: () => Promise<T>) => Promise<T>;
+export declare function landOpenPullRequest(opts: {
+    octokit: Octokit;
+    owner: string;
+    repoName: string;
+    ghRepo: string;
+    repoRoot: string;
+    issue: number;
+    branch: string;
+    worktree: string;
+    prNumber: number;
+    log: (type: EventKind, msg: string) => void;
+    run?: CommandRunner;
+    pathExists?: (path: string) => boolean;
+    sleep?: (ms: number) => Promise<void>;
+    skipCI?: boolean;
+    adminMerge?: boolean;
+    watch?: (opts: WatchChecksOptions) => Promise<CiOutcome>;
+    rerun?: (argv: readonly string[]) => Promise<{
+        ok: boolean;
+    }>;
+    withLock?: LandLock;
+    /** Materializes an adopted branch only after its locked state re-read confirms it needs rebasing. */
+    ensureWorktree?: () => Promise<void>;
+}): Promise<void>;
+//# sourceMappingURL=land-pr.d.ts.map

package/dist/cli/land-pr.d.ts.map

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

package/dist/cli/land-pr.js

@@ -0,0 +1,233 @@
+// packages/cli/src/cli/land-pr.ts — PR-level land: CI watch, rebase, SHA-pinned squash merge (#2784)
+import { existsSync } from 'node:fs';
+import { shellEscape, watchChecksWithInfraRerun } from '@on-par/factory-core/internal';
+import { landRuntime } from './land-runtime.js';
+export async function squashMergeAndDelete(octokit, owner, repoName, branch, prNumber, 
+/** `sha`: the CI-verified head commit. GitHub refuses the merge if the PR head has moved. */
+opts = {}) {
+    const { sha } = opts;
+    if (opts.admin) {
+        const run = opts.run ?? landRuntime().shellOps.exec;
+        const pin = sha ? ` --match-head-commit ${shellEscape(sha)}` : '';
+        await run(`gh pr merge ${prNumber} --repo ${shellEscape(`${owner}/${repoName}`)} --admin --squash --delete-branch${pin}`);
+        return;
+    }
+    await octokit.rest.pulls.merge({
+        owner,
+        repo: repoName,
+        pull_number: prNumber,
+        merge_method: 'squash',
+        ...(sha ? { sha } : {}),
+    });
+    // Best-effort branch delete: the merge is the source of truth.
+    await octokit.rest.git.deleteRef({ owner, repo: repoName, ref: `heads/${branch}` }).catch(() => { });
+}
+export class MergeGatedError extends Error {
+    issue;
+    prNumber;
+    label;
+    constructor(message, issue, prNumber, label) {
+        super(message);
+        this.issue = issue;
+        this.prNumber = prNumber;
+        this.label = label;
+        this.name = 'MergeGatedError';
+    }
+}
+export class LandConflictError extends Error {
+    parkReason = 'conflict';
+}
+export class AwaitingReviewError extends Error {
+    prNumber;
+    constructor(message, prNumber) {
+        super(message);
+        this.prNumber = prNumber;
+    }
+}
+export class LandFailureError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+    }
+}
+/** Thrown when watchChecks reports a confirmed CI failure — a completed check run with a
+ *  non-passing conclusion. A confirmed failing check must never be merged, admin override
+ *  or not. See CiUnverifiedError for the no-verdict case. */
+export class CiFailedError extends Error {
+    prNumber;
+    parkReason = 'ci-failed';
+    constructor(message, prNumber) {
+        super(message);
+        this.prNumber = prNumber;
+    }
+}
+/** Thrown when the CI watch never reached a green verdict — a deadline timeout, no check runs ever
+ *  registering, or repeated API failures. A subclass of CiFailedError so every existing guard
+ *  (parkReasonFor → 'ci-failed', worktree cleanup, cmdLand's exit-0 path) treats "we don't know"
+ *  exactly like "we know it's red": never merge. */
+export class CiUnverifiedError extends CiFailedError {
+}
+/** Thrown when the one infra rerun (#2365) also failed for infrastructure reasons on the same head SHA (#2366).
+ *  A CiFailedError subclass so every guard still leaves the PR open and unmerged, but it parks as
+ *  'ci-infra', which the ADR-0155 steward skips. */
+export class CiInfraError extends CiFailedError {
+    parkReason = 'ci-infra';
+}
+const MAX_MERGE_ATTEMPTS = 5;
+const MERGE_RETRY_BASE_MS = 5_000;
+/** True when GitHub refused a SHA-pinned merge because the PR head moved past the verified
+ *  commit (REST 409, or gh's "Head branch was modified"). Retrying as-is can never succeed. */
+export function isHeadModifiedMergeError(err) {
+    if (err?.status === 409)
+        return true;
+    const msg = `${err instanceof Error ? err.message : ''}\n${landRuntime().errorDetail(err)}`;
+    return /head branch was modified/i.test(msg);
+}
+export function isReviewRequiredMergeError(err, state) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (/approving review/i.test(msg) || /review is required/i.test(msg))
+        return true;
+    return state.mergeStateStatus === 'BLOCKED' && state.reviewDecision === 'REVIEW_REQUIRED';
+}
+export async function getPullRequestLandState(octokit, owner, repoName, prNumber) {
+    const result = await octokit.graphql(`query PullRequestLandState($owner: String!, $repo: String!, $number: Int!) {
+      repository(owner: $owner, name: $repo) {
+        pullRequest(number: $number) {
+          id
+          isDraft
+          mergeStateStatus
+          reviewDecision
+        }
+      }
+    }`, { owner, repo: repoName, number: prNumber });
+    return result.repository?.pullRequest ?? {};
+}
+export async function markPullRequestReady(octokit, pullRequestId) {
+    await octokit.graphql(`mutation MarkPullRequestReady($id: ID!) {
+      markPullRequestReadyForReview(input: { pullRequestId: $id }) {
+        pullRequest { isDraft }
+      }
+    }`, { id: pullRequestId });
+}
+export async function rebaseDirtyPullRequest(opts) {
+    const { issue, branch, worktree, prNumber, log, run = landRuntime().shellOps.exec, pathExists = existsSync } = opts;
+    if (!pathExists(worktree)) {
+        const msg = `PR #${prNumber} DIRTY on ${branch} and worktree gone`;
+        log('conflict', msg);
+        throw new LandConflictError(msg);
+    }
+    try {
+        await run('git rebase origin/main', { cwd: worktree });
+        await run(`git push --force-with-lease origin ${shellEscape(branch)}`, { cwd: worktree });
+    }
+    catch {
+        // Best-effort cleanup: the conflict logged below is the error we surface.
+        await run('git rebase --abort', { cwd: worktree }).catch(() => { });
+        const msg = `rebase conflict on ${branch} — parked`;
+        log('conflict', msg);
+        throw new LandConflictError(`issue #${issue}: ${msg}`);
+    }
+}
+export async function landOpenPullRequest(opts) {
+    const { octokit, owner, repoName, issue, branch, worktree, prNumber, log, run, pathExists, sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms)), skipCI = false, adminMerge = process.env.FACTORY_MERGE_ADMIN === '1', watch = landRuntime().internalOps.watchChecks, rerun, withLock = (fn) => fn(), ensureWorktree, } = opts;
+    const { errorDetail } = landRuntime();
+    /** Watches CI on the PR's current head commit and returns that SHA once it is green, so the
+     *  merge can be pinned to exactly the commit CI verified. */
+    const watchCi = async () => {
+        let headSha;
+        let outcome;
+        try {
+            const { data: pr } = await octokit.rest.pulls.get({ owner, repo: repoName, pull_number: prNumber });
+            headSha = pr.head.sha;
+            outcome = await watchChecksWithInfraRerun({
+                octokit,
+                owner,
+                repo: repoName,
+                ref: headSha,
+                watch,
+                rerun,
+                onRescued: ({ runIds }) => log('ci-rescued', `CI rescued for PR #${prNumber} on ${branch}: reran infra-failed run(s) ${runIds.join(', ')} once and the re-watch is green`),
+                onRescueFailed: ({ runIds, outcome: failedOutcome }) => log('ci-rescue-failed', `CI rescue failed for PR #${prNumber} on ${branch}: reran infra-failed run(s) ${runIds.join(', ')} once and the re-watch ended ${failedOutcome}`),
+            });
+        }
+        catch (err) {
+            const msg = `CI watch for ${branch} failed: ${errorDetail(err)} — refusing to merge without a green verdict`;
+            log('ci-failed', msg);
+            throw new CiUnverifiedError(msg, prNumber);
+        }
+        if (outcome === 'success')
+            return headSha;
+        if (outcome === 'infra-failure') {
+            const msg = `CI failed again for infrastructure reasons for PR #${prNumber} on ${branch} after one rerun — parked as ci-infra, not merged`;
+            log('ci-infra', msg);
+            throw new CiInfraError(msg, prNumber);
+        }
+        if (outcome === 'failure') {
+            const msg = `CI failed for PR #${prNumber} on ${branch} — refusing to merge with a failing check`;
+            log('ci-failed', msg);
+            throw new CiFailedError(msg, prNumber);
+        }
+        const msg = `CI watch for ${branch} ended ${outcome} — refusing to merge without a green verdict`;
+        log('ci-failed', msg);
+        throw new CiUnverifiedError(msg, prNumber);
+    };
+    // The CI watch is a 10-20 minute wait, not a mutation: it must never run under the land
+    // locks, or every other lane's setupWorktree serializes behind it (#645).
+    let verifiedSha = skipCI ? undefined : await watchCi();
+    let state = await getPullRequestLandState(octokit, owner, repoName, prNumber);
+    if (state.mergeStateStatus === 'DIRTY') {
+        const rebased = await withLock(async () => {
+            // Re-check under the lock: a sibling lane may have landed (or rebased this branch)
+            // while we waited for it, so the DIRTY verdict read above can be stale.
+            state = await getPullRequestLandState(octokit, owner, repoName, prNumber);
+            if (state.mergeStateStatus !== 'DIRTY')
+                return false;
+            await ensureWorktree?.();
+            await rebaseDirtyPullRequest({ issue, branch, worktree, prNumber, log, run, pathExists });
+            return true;
+        });
+        if (rebased) {
+            if (!skipCI) {
+                verifiedSha = await watchCi();
+            }
+            state = await getPullRequestLandState(octokit, owner, repoName, prNumber);
+        }
+    }
+    for (let attempt = 1;; attempt++) {
+        try {
+            await withLock(async () => {
+                // Same rule as the rebase section: whatever we read before taking the lock (or before
+                // the backoff sleep) may be stale, so the attempt decides from a fresh read.
+                state = await getPullRequestLandState(octokit, owner, repoName, prNumber);
+                if (state.isDraft && state.id) {
+                    log('land', `PR #${prNumber} still a draft — re-issuing ready-for-review (attempt ${attempt})`);
+                    await markPullRequestReady(octokit, state.id).catch((err) => log('warn', `ready-for-review flip failed for PR #${prNumber}: ${errorDetail(err)}`));
+                }
+                await squashMergeAndDelete(octokit, owner, repoName, branch, prNumber, {
+                    admin: adminMerge,
+                    run,
+                    sha: verifiedSha,
+                });
+            });
+            return;
+        }
+        catch (err) {
+            if (verifiedSha && isHeadModifiedMergeError(err)) {
+                const msg = `PR #${prNumber} head moved past CI-verified commit ${verifiedSha} — refusing to merge an unverified head`;
+                log('ci-failed', msg);
+                throw new CiUnverifiedError(msg, prNumber);
+            }
+            if (isReviewRequiredMergeError(err, state)) {
+                log('awaiting-review', `PR #${prNumber} blocked on human review — leaving open for approval`);
+                throw new AwaitingReviewError(`PR #${prNumber} awaiting review: ${err.message}`, prNumber);
+            }
+            if (attempt >= MAX_MERGE_ATTEMPTS)
+                throw err;
+            log('land', `merge attempt ${attempt}/${MAX_MERGE_ATTEMPTS} failed (${err.message}); mergeStateStatus=${state.mergeStateStatus ?? 'unknown'} — retrying with backoff`);
+            // Backoff outside the lock: waiting is not a mutation (#645).
+            await sleep(MERGE_RETRY_BASE_MS * 2 ** (attempt - 1));
+        }
+    }
+}
+//# sourceMappingURL=land-pr.js.map

package/dist/cli/land-pr.js.map

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

package/dist/cli/land-runtime.d.ts

@@ -0,0 +1,16 @@
+import type { Octokit } from '@octokit/rest';
+import type { CliDeps, ConfigLoaderKey, GitOpKey, InternalOpKey, LaneParkError, ShellOpKey } from './index.js';
+/** index.ts's per-invocation ops, read at call time so cmdLand/main() deps injection reaches the land flow. */
+export interface LandRuntime {
+    configLoaders: Required<Pick<CliDeps, ConfigLoaderKey>>;
+    gitOps: Required<Pick<CliDeps, GitOpKey>>;
+    internalOps: Required<Pick<CliDeps, InternalOpKey>>;
+    shellOps: Required<Pick<CliDeps, ShellOpKey>>;
+    getOctokit: () => Octokit;
+    errorDetail: (err: unknown) => string;
+    worktreePathFor: (repoRoot: string, ghRepo: string, issueNum: number, prefix?: string) => string;
+    LaneParkError: typeof LaneParkError;
+}
+export declare function setLandRuntime(fn: () => LandRuntime): void;
+export declare function landRuntime(): LandRuntime;
+//# sourceMappingURL=land-runtime.d.ts.map

package/dist/cli/land-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"land-runtime.d.ts","sourceRoot":"","sources":["../../src/cli/land-runtime.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE/G,+GAA+G;AAC/G,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC;IACxD,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC1C,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;IACpD,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;IAC9C,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,WAAW,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAAC;IACtC,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACjG,aAAa,EAAE,OAAO,aAAa,CAAC;CACrC;AAID,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,WAAW,GAAG,IAAI,CAE1D;AAED,wBAAgB,WAAW,IAAI,WAAW,CAGzC"}

package/dist/cli/land-runtime.js

@@ -0,0 +1,11 @@
+// packages/cli/src/cli/land-runtime.ts — accessor for index.ts's per-invocation ops, so the land flow reads them live without a runtime import cycle (#2784)
+let get;
+export function setLandRuntime(fn) {
+    get = fn;
+}
+export function landRuntime() {
+    if (!get)
+        throw new Error('land runtime not registered: import ./index.js first');
+    return get();
+}
+//# sourceMappingURL=land-runtime.js.map

package/dist/cli/land-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"land-runtime.js","sourceRoot":"","sources":["../../src/cli/land-runtime.ts"],"names":[],"mappings":"AAAA,6JAA6J;AAiB7J,IAAI,GAAoC,CAAC;AAEzC,MAAM,UAAU,cAAc,CAAC,EAAqB;IAClD,GAAG,GAAG,EAAE,CAAC;AACX,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAClF,OAAO,GAAG,EAAE,CAAC;AACf,CAAC"}

package/dist/cli/land.d.ts

@@ -0,0 +1,54 @@
+import type { Octokit } from '@octokit/rest';
+import type { FactoryConfig, MergePolicyOverrides } from '@on-par/factory-core';
+import type { getFactoryPaths } from '@on-par/factory-core';
+import { logEvent } from '@on-par/factory-core/internal';
+import type { OpenPullRequestEvidence } from './index.js';
+import { LandFailureError } from './land-pr.js';
+export declare function landIssue(issueNum: number, repoRoot: string, ghRepo: string, paths: ReturnType<typeof getFactoryPaths>, octokit: Octokit, skipCI?: boolean, branchPrefix?: string, opts?: {
+    allowGated?: boolean;
+    branch?: string;
+}): Promise<{
+    branch: string;
+    prNumber: number;
+}>;
+export declare function prLookupFailure(issueNum: number, branch: string, err: unknown): LandFailureError;
+export declare function isPrMerged(octokit: Octokit, owner: string, repoName: string, branch: string): Promise<boolean>;
+export declare function findOpenPRNumber(octokit: Octokit, owner: string, repoName: string, branch: string): Promise<number | undefined>;
+export declare function findOpenPRForIssue(octokit: Octokit, owner: string, repoName: string, issueNum: number): Promise<OpenPullRequestEvidence | undefined>;
+/** Consecutive merged-state check failures tolerated before waitForMerge parks the lane.
+ *  At the shipped 120s poll that is ~20 minutes of 100% failure (ADR: sustained-failure park). */
+export declare const MERGE_CHECK_MAX_CONSECUTIVE_FAILURES = 10;
+/** Wall-clock backstop: continuous merged-state check failure for this long parks the lane even
+ *  if fewer than MERGE_CHECK_MAX_CONSECUTIVE_FAILURES attempts were made (slower poll cadence). */
+export declare const MERGE_CHECK_FAILURE_BUDGET_MS: number;
+/** True when a merged-state check failure cannot recover by retrying: an expired/revoked token
+ *  (401) or a token missing `pulls:read` (403 with no rate-limit evidence). */
+export declare function isPermanentMergeCheckError(err: unknown): boolean;
+export type WaitForMergeDeps = {
+    createOctokit?: () => Octokit;
+    pathExists?: (path: string) => boolean;
+    checkMerged?: typeof isPrMerged;
+    loadConfig?: (configPath: string) => FactoryConfig;
+    land?: (issueNum: number, repoRoot: string, ghRepo: string, paths: ReturnType<typeof getFactoryPaths>, octokit: Octokit, skipCI?: boolean, branchPrefix?: string, opts?: {
+        allowGated?: boolean;
+        branch?: string;
+    }) => Promise<{
+        branch: string;
+        prNumber: number;
+    }>;
+    /** ADR-0161 stack layer: land exactly this head branch. */
+    landBranch?: string;
+    listIssueLabels?: (octokit: Octokit, owner: string, repo: string, issue: number) => Promise<string[]>;
+    sleep?: (ms: number) => Promise<void>;
+    emitEvent?: typeof logEvent;
+    mergeEnabled?: () => boolean;
+    writeLine?: (line: string) => void;
+    /** Injectable clock so the wall-clock failure budget is testable. Default `() => Date.now()`. */
+    now?: () => number;
+    /** Per-invocation CLI flag overrides (`--auto-merge`/`--no-auto-merge`). Threaded in by
+     *  cmdRun rather than read from disk so a live run's merge gate cannot change underneath
+     *  it (#1400). */
+    mergeOverrides?: MergePolicyOverrides;
+};
+export declare function waitForMerge(issue: number, branch: string, repoRoot: string, ghRepo: string, paths: ReturnType<typeof getFactoryPaths>, deps?: WaitForMergeDeps): Promise<void>;
+//# sourceMappingURL=land.d.ts.map

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

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