@intentius/chant 0.124.27 → 0.124.29

package/dist/workspace/ls.d.ts

@@ -116,6 +116,10 @@ export interface LsCiGreen {
         skipped: "pass" | "fail";
     }[];
     require: string[];
+    /** The first commit whose ci tags need a signed statement (#4031). Present only when the declaration sets it. */
+    signedSince?: string;
+    /** Where the tick reads phase results (#4044). Present only when it is `runs`; absent means the forge's check runs. */
+    source?: "runs";
 }
 export interface LsGroup {
     name: string;

package/dist/workspace/ls.d.ts.map

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

package/dist/workspace/ls.js

@@ -167,6 +167,8 @@ function readListing(query) {
                             window: declaration.ci.green.window,
                             phases: declaration.ci.green.phases.map((p) => ({ name: p.name, runs: p.runs, skipped: p.skipped })),
                             require: declaration.ci.green.require,
+                            ...(declaration.ci.green.signedSince !== null ? { signedSince: declaration.ci.green.signedSince } : {}),
+                            ...(declaration.ci.green.source === "runs" ? { source: "runs" } : {}),
                         }
                         : null,
                 }

package/dist/workspace/ls.schema.json

@@ -25,7 +25,9 @@
             }
           }
         },
-        "require": { "type": "array", "items": { "type": "string" } }
+        "require": { "type": "array", "items": { "type": "string" } },
+        "signedSince": { "type": "string", "description": "Added in contract 1 by #4031, written by chant 0.124.28 and newer, and only when the declaration sets it: the full sha of the first commit whose ci tags count only with a statement signed by a runner key. Tags on its strict first-parent ancestors count unsigned." },
+        "source": { "const": "runs", "description": "Added in contract 1 by #4044, written by chant 0.124.28 and newer, and only when the declaration sets ci.green.source to runs: ci tick reads each phase's results from chant's own Op runs on chant/lifecycle, each signed by a runner key, in place of the forge's check runs. Absent means check runs." }
       }
     },
     "result": {

package/dist/workspace/member-pipeline.d.ts

@@ -106,6 +106,8 @@ export interface ComponentPlanInput {
     /** `--env`, or undefined for the generator's default. */
     env?: string;
     promoteTo?: string;
+    /** `--allow-skip` (#4030): the generated promote job may skip a step of the promotion order. */
+    allowSkip?: boolean;
     /** `--output`, relative to the current directory. */
     output?: string;
     params?: string[];
@@ -121,6 +123,10 @@ export interface ComponentPlanInput {
         canary?: string[];
         base?: string;
     };
+    /** `--image` (#4002). */
+    image?: string;
+    /** `--before-script`, in order (#4002). */
+    beforeScript?: string[];
 }
 /**
  * Plan a member's component pipeline: which member, which file and which

package/dist/workspace/member-pipeline.d.ts.map

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

package/dist/workspace/member-pipeline.js

@@ -173,6 +173,8 @@ export function planMemberComponentPipeline(input) {
     const parts = ["chant", "build", "--components", "--generate", input.lexicon, "--env", env];
     if (input.promoteTo)
         parts.push("--promote-to", input.promoteTo);
+    if (input.promoteTo && input.allowSkip)
+        parts.push("--allow-skip");
     if (input.waveGate) {
         parts.push("--wave-gate", input.waveGate.gate);
         if (input.waveGate.canary?.length)
@@ -187,6 +189,10 @@ export function planMemberComponentPipeline(input) {
         if (input.prLoop.branch)
             parts.push("--branch", input.prLoop.branch);
     }
+    if (input.image)
+        parts.push("--image", input.image);
+    for (const line of input.beforeScript ?? [])
+        parts.push("--before-script", line);
     for (const p of input.params ?? [])
         parts.push("--param", p);
     if (input.paramsFile)

package/dist/workspace/overlap.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Overlap between in-flight work items (#4025, policy from #4016).
+ *
+ * A work lease locks one item, and nothing compares two items with each
+ * other. This report does, after the fact: it says which in-flight work items
+ * changed the same files, and which entries of a planned change set more than
+ * one of them reaches. It never blocks anything. Two people or agents read it
+ * and sort the overlap out between them.
+ *
+ * ## In flight
+ *
+ * A work item is a current record of a declared work kind. It is in flight
+ * unless it implements at least one decision and every decision it implements
+ * is confirmed, as #4024 defines confirmed ({@link decisionConfirmed}: in one
+ * of the decision kind's closed states and superseded by nothing). The item's
+ * own state does not matter: work marked done whose decision is not settled
+ * can still collide.
+ *
+ * ## Linked commits
+ *
+ * The commits of a work item are the commits linked to it as #4029 defines
+ * linked ({@link judgeCommits}): a `Chant-Record: <work kind>:<id>` trailer,
+ * or a `Chant-Lease` trailer that resolves to the item. A window match does
+ * not link. The walk covers every local branch, every remote-tracking branch
+ * and HEAD, so work pushed to a branch and fetched shows before it is merged.
+ * The ledger branches under `chant/` hold no work and are left out. Merge
+ * commits carry no work of their own and are skipped. Nothing is fetched.
+ *
+ * ## Files
+ *
+ * An item's files are the paths its linked commits add, change or delete,
+ * from the repository root, with renames read as a delete and an add. Two
+ * items overlap by file when both touch one path.
+ *
+ * ## Change-set entries
+ *
+ * A change set is planned from many commits, and a release bundles many work
+ * items, so an entry belongs to no single item on its face. An entry is
+ * attributed to a work item when:
+ *
+ * 1. the entry has a `source`: the file that declares its graph node, from
+ *    the repository root, recorded when the change set was stored
+ *    (`../change-set-graph.ts`);
+ * 2. a commit linked to the item changed that file; and
+ * 3. that commit is in the history the change set was planned from: an
+ *    ancestor of (or equal to) the commit its graph was read at, else the
+ *    commit the gate was reached at. When neither is known, or the commit is
+ *    not in this repository, the third test is skipped.
+ *
+ * An entry can be attributed to several items, and two items overlap by
+ * address when one entry is attributed to both. An entry with no `source`
+ * (stored by an older chant, mapped onto no node, or a node with no source
+ * location) is attributed to none and counted in `unattributed`.
+ *
+ * The change sets read are the ones `workspace status` lists on a gate that
+ * is pending or approved: the plans still waiting to apply.
+ */
+import type { ChangeSetDocument } from "../change-set.js";
+import { type Declaration } from "./declaration.js";
+/** One in-flight work item with at least one linked commit. */
+export interface OverlapItem {
+    /** `<work kind>:<id>`, as a `Chant-Record` trailer names it. */
+    item: string;
+    /** The work record file, from the repository root. */
+    path: string;
+    state: string | null;
+    /** The commits linked to the item, newest first. */
+    commits: string[];
+}
+/** One change-set entry two items both reach. */
+export interface OverlapAddress {
+    /** The change set's digest, as `chant change-set show` takes it. */
+    changeSet: string;
+    /** The workspace member whose ledger stores the change set, or null for the flat ledger. */
+    ledgerMember: string | null;
+    /** The entry's change-set member and planner address. */
+    member: string;
+    address: string;
+    /** The entry's graph node, or null. */
+    node: string | null;
+    /** The source file the attribution went through, from the repository root. */
+    source: string;
+}
+/** Two in-flight work items that changed the same thing. */
+export interface OverlapPair {
+    /** The two items, `<work kind>:<id>`, in sorted order. */
+    items: [string, string];
+    /** The files both items' linked commits touch, sorted. */
+    files: string[];
+    /** The change-set entries attributed to both items, by change set then address. */
+    addresses: OverlapAddress[];
+}
+/** What `workspace status` reports as `overlap`. */
+export interface OverlapReport {
+    /** The in-flight work items with a linked commit, by item. */
+    items: OverlapItem[];
+    /** Each pair of items that share a file or an entry, by the first item then the second. */
+    pairs: OverlapPair[];
+    /** The digests of the change sets read, sorted. */
+    changeSets: string[];
+    /** Entries of those change sets with no `source`, so attributed to no item. */
+    unattributed: number;
+}
+/** A change set to attribute: one a pending or approved gate binds. */
+export interface OverlapChangeSetRef {
+    digest: string;
+    /** A directory whose ledger stores it: the member's directory. */
+    cwd: string;
+    ledgerMember: string | null;
+    /** The commit the gate was reached at, when the pending fact records one. */
+    gitSha: string | null;
+}
+/** Reads a stored change set; the lifecycle store unless a test swaps it. */
+export type StoredChangeSetReader = (digest: string, cwd: string) => Promise<ChangeSetDocument | null>;
+/**
+ * The non-merge commits on every local and remote-tracking branch and HEAD
+ * that carry a `Chant-Record` or `Chant-Lease` trailer, newest first. The
+ * ledger branches under `chant/` are left out.
+ */
+export declare function trailerCommits(top: string): string[];
+/** The paths each commit adds, changes or deletes, from the repository root, renames read as a delete and an add. */
+export declare function commitFiles(top: string, shas: string[]): Map<string, string[]>;
+/**
+ * The work items a change-set entry is attributed to, sorted: each item with
+ * a linked commit that changed the entry's `source` and is in `within`, the
+ * history the change set was planned from (null when that is unknown, so
+ * every linked commit counts). An entry with no source has none.
+ *
+ * `commitsOf` maps each in-flight item to its linked commits, and `files`
+ * each commit to the paths it touches.
+ */
+export declare function attributeEntry(source: string | undefined, commitsOf: ReadonlyMap<string, readonly string[]>, files: ReadonlyMap<string, readonly string[]>, within: ReadonlySet<string> | null): string[];
+/**
+ * The overlap report for the workspace declared at `root` in the repository
+ * at `top`. Null when the declaration names no work kind. Throws when a work
+ * kind or its records can't be read, or git fails; `workspace status` writes
+ * null then.
+ */
+export declare function readOverlap(input: {
+    declaration: Declaration;
+    root: string;
+    top: string;
+    changeSets: OverlapChangeSetRef[];
+    readChangeSet?: StoredChangeSetReader;
+}): Promise<OverlapReport | null>;
+//# sourceMappingURL=overlap.d.ts.map

package/dist/workspace/overlap.d.ts.map

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

package/dist/workspace/overlap.js

@@ -0,0 +1,276 @@
+/**
+ * Overlap between in-flight work items (#4025, policy from #4016).
+ *
+ * A work lease locks one item, and nothing compares two items with each
+ * other. This report does, after the fact: it says which in-flight work items
+ * changed the same files, and which entries of a planned change set more than
+ * one of them reaches. It never blocks anything. Two people or agents read it
+ * and sort the overlap out between them.
+ *
+ * ## In flight
+ *
+ * A work item is a current record of a declared work kind. It is in flight
+ * unless it implements at least one decision and every decision it implements
+ * is confirmed, as #4024 defines confirmed ({@link decisionConfirmed}: in one
+ * of the decision kind's closed states and superseded by nothing). The item's
+ * own state does not matter: work marked done whose decision is not settled
+ * can still collide.
+ *
+ * ## Linked commits
+ *
+ * The commits of a work item are the commits linked to it as #4029 defines
+ * linked ({@link judgeCommits}): a `Chant-Record: <work kind>:<id>` trailer,
+ * or a `Chant-Lease` trailer that resolves to the item. A window match does
+ * not link. The walk covers every local branch, every remote-tracking branch
+ * and HEAD, so work pushed to a branch and fetched shows before it is merged.
+ * The ledger branches under `chant/` hold no work and are left out. Merge
+ * commits carry no work of their own and are skipped. Nothing is fetched.
+ *
+ * ## Files
+ *
+ * An item's files are the paths its linked commits add, change or delete,
+ * from the repository root, with renames read as a delete and an add. Two
+ * items overlap by file when both touch one path.
+ *
+ * ## Change-set entries
+ *
+ * A change set is planned from many commits, and a release bundles many work
+ * items, so an entry belongs to no single item on its face. An entry is
+ * attributed to a work item when:
+ *
+ * 1. the entry has a `source`: the file that declares its graph node, from
+ *    the repository root, recorded when the change set was stored
+ *    (`../change-set-graph.ts`);
+ * 2. a commit linked to the item changed that file; and
+ * 3. that commit is in the history the change set was planned from: an
+ *    ancestor of (or equal to) the commit its graph was read at, else the
+ *    commit the gate was reached at. When neither is known, or the commit is
+ *    not in this repository, the third test is skipped.
+ *
+ * An entry can be attributed to several items, and two items overlap by
+ * address when one entry is attributed to both. An entry with no `source`
+ * (stored by an older chant, mapped onto no node, or a node with no source
+ * location) is attributed to none and counted in `unattributed`.
+ *
+ * The change sets read are the ones `workspace status` lists on a gate that
+ * is pending or approved: the plans still waiting to apply.
+ */
+import { execFileSync } from "node:child_process";
+import { dirname } from "node:path";
+import { judgeCommits, hasLeaseLedger } from "./commit-links.js";
+import { declaredRecordKinds } from "./declaration.js";
+import { declaredKindFile } from "./declared-kinds.js";
+import { decisionConfirmed } from "./flags.js";
+import { loadRecordKind } from "./records.js";
+import { readRecordsFor } from "./records-cli.js";
+import { LEASE_TRAILER, RECORD_TRAILER } from "./trailers.js";
+const defaultReadChangeSet = async (digest, cwd) => {
+    const { readStoredChangeSet } = await import("../lifecycle/change-set-store.js");
+    const read = await readStoredChangeSet(digest, { cwd });
+    return read.status === "found" ? read.document : null;
+};
+function git(top, args, input) {
+    return execFileSync("git", ["-c", "core.quotepath=off", ...args], {
+        cwd: top,
+        encoding: "utf-8",
+        stdio: [input === undefined ? "ignore" : "pipe", "pipe", "ignore"],
+        maxBuffer: 512 * 1024 * 1024,
+        ...(input !== undefined ? { input } : {}),
+    });
+}
+/** The work items of every declared work kind, with the index commits are judged against and the ones in flight. */
+async function readWorkItems(declaration, root, top) {
+    const kinds = new Map();
+    const inFlight = new Map();
+    for (const d of declaredRecordKinds(declaration)) {
+        const file = declaredKindFile(d, root);
+        const loaded = await loadRecordKind(file, root);
+        if (!loaded.kind.work)
+            continue;
+        const decisionKind = await loadRecordKind(loaded.kind.work.decisions, dirname(loaded.file));
+        const closed = new Set(decisionKind.kind.closedStates ?? []);
+        const read = await readRecordsFor({ kind: file, cwd: root });
+        const decisions = new Map((read.result.decisions ?? []).map((x) => [x.id, x]));
+        const ids = kinds.get(loaded.kind.name) ?? new Set();
+        for (const r of read.result.records) {
+            if (r.id === null)
+                continue;
+            ids.add(r.id);
+            if (r.supersededBy !== null)
+                continue;
+            const implemented = r.implements ?? [];
+            const settled = implemented.length > 0 && implemented.every((x) => decisionConfirmed(decisions.get(x.id), closed));
+            const key = `${loaded.kind.name}:${r.id}`;
+            if (!settled && !inFlight.has(key))
+                inFlight.set(key, { path: r.path, state: r.state });
+        }
+        kinds.set(loaded.kind.name, ids);
+    }
+    if (kinds.size === 0)
+        return null;
+    return { index: { kinds, ledger: hasLeaseLedger(top) }, inFlight };
+}
+/**
+ * The non-merge commits on every local and remote-tracking branch and HEAD
+ * that carry a `Chant-Record` or `Chant-Lease` trailer, newest first. The
+ * ledger branches under `chant/` are left out.
+ */
+export function trailerCommits(top) {
+    let text;
+    try {
+        text = git(top, [
+            "log",
+            "--no-merges",
+            `--format=%H%x1f%(trailers:key=${RECORD_TRAILER},key=${LEASE_TRAILER},valueonly,separator=%x1e)%x1d`,
+            "--exclude=chant/*",
+            "--branches",
+            "--exclude=*/chant/*",
+            "--remotes",
+            "HEAD",
+            "--",
+        ]);
+    }
+    catch {
+        // An unborn HEAD has no history to read.
+        return [];
+    }
+    const out = [];
+    for (const chunk of text.split("\x1d")) {
+        const [sha, trailers] = chunk.trim().split("\x1f");
+        if (sha && trailers && trailers.trim() !== "")
+            out.push(sha);
+    }
+    return out;
+}
+/** The paths each commit adds, changes or deletes, from the repository root, renames read as a delete and an add. */
+export function commitFiles(top, shas) {
+    const out = new Map();
+    if (shas.length === 0)
+        return out;
+    const text = git(top, ["log", "--no-walk=unsorted", "--stdin", "--no-renames", "--name-only", "--format=%x1e%H"], `${shas.join("\n")}\n`);
+    for (const block of text.split("\x1e")) {
+        const lines = block.split("\n").map((l) => l.trim()).filter(Boolean);
+        if (lines.length === 0)
+            continue;
+        out.set(lines[0], lines.slice(1));
+    }
+    return out;
+}
+/** Every commit reachable from `rev`, or null when `rev` is not in the repository. */
+function reachable(top, rev) {
+    try {
+        return new Set(git(top, ["rev-list", rev, "--"]).split("\n").filter(Boolean));
+    }
+    catch {
+        return null;
+    }
+}
+const byString = (a, b) => (a < b ? -1 : a > b ? 1 : 0);
+/**
+ * The work items a change-set entry is attributed to, sorted: each item with
+ * a linked commit that changed the entry's `source` and is in `within`, the
+ * history the change set was planned from (null when that is unknown, so
+ * every linked commit counts). An entry with no source has none.
+ *
+ * `commitsOf` maps each in-flight item to its linked commits, and `files`
+ * each commit to the paths it touches.
+ */
+export function attributeEntry(source, commitsOf, files, within) {
+    if (source === undefined)
+        return [];
+    const out = [];
+    for (const [item, commits] of commitsOf) {
+        if (commits.some((sha) => (files.get(sha) ?? []).includes(source) && (within === null || within.has(sha))))
+            out.push(item);
+    }
+    return out.sort(byString);
+}
+/**
+ * The overlap report for the workspace declared at `root` in the repository
+ * at `top`. Null when the declaration names no work kind. Throws when a work
+ * kind or its records can't be read, or git fails; `workspace status` writes
+ * null then.
+ */
+export async function readOverlap(input) {
+    const { top } = input;
+    const work = await readWorkItems(input.declaration, input.root, top);
+    if (work === null)
+        return null;
+    // The commits of each in-flight item, newest first.
+    const commitsOf = new Map();
+    if (work.inFlight.size > 0) {
+        const candidates = trailerCommits(top);
+        const links = judgeCommits(top, candidates, work.index);
+        for (const sha of candidates) {
+            for (const id of links.get(sha)?.ids ?? []) {
+                if (!work.inFlight.has(id))
+                    continue;
+                const list = commitsOf.get(id) ?? [];
+                if (!list.includes(sha))
+                    list.push(sha);
+                commitsOf.set(id, list);
+            }
+        }
+    }
+    const items = [...commitsOf.keys()].sort(byString);
+    const files = commitFiles(top, [...new Set([...commitsOf.values()].flat())]);
+    const filesOf = new Map(items.map((id) => [id, new Set(commitsOf.get(id).flatMap((sha) => files.get(sha) ?? []))]));
+    // Each change-set entry with a source, attributed to the items whose linked commits changed it within the change set's history.
+    const read = input.readChangeSet ?? defaultReadChangeSet;
+    const seen = new Set();
+    const changeSets = [];
+    let unattributed = 0;
+    const addressesOf = new Map();
+    const history = new Map();
+    for (const ref of input.changeSets) {
+        const key = `${ref.ledgerMember ?? ""}\0${ref.digest}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        const doc = await read(ref.digest, ref.cwd);
+        if (doc === null)
+            continue;
+        if (!changeSets.includes(doc.digest))
+            changeSets.push(doc.digest);
+        const at = doc.graph?.at ?? ref.gitSha;
+        for (const e of doc.entries) {
+            if (e.source === undefined) {
+                unattributed++;
+                continue;
+            }
+            // Only an entry two items could share needs the change set's history.
+            if (attributeEntry(e.source, commitsOf, files, null).length < 2)
+                continue;
+            if (at && !history.has(at))
+                history.set(at, reachable(top, at));
+            const owners = attributeEntry(e.source, commitsOf, files, at ? history.get(at) : null);
+            if (owners.length < 2)
+                continue;
+            const address = { changeSet: doc.digest, ledgerMember: ref.ledgerMember, member: e.member, address: e.address, node: e.node ?? null, source: e.source };
+            for (const id of owners)
+                addressesOf.set(id, [...(addressesOf.get(id) ?? []), address]);
+        }
+    }
+    changeSets.sort(byString);
+    const pairs = [];
+    for (let i = 0; i < items.length; i++) {
+        for (let j = i + 1; j < items.length; j++) {
+            const a = items[i];
+            const b = items[j];
+            const fb = filesOf.get(b);
+            const shared = [...filesOf.get(a)].filter((f) => fb.has(f)).sort(byString);
+            const ab = addressesOf.get(b) ?? [];
+            const addresses = (addressesOf.get(a) ?? [])
+                .filter((x) => ab.includes(x))
+                .sort((x, y) => byString(x.changeSet, y.changeSet) || byString(x.member, y.member) || byString(x.address, y.address));
+            if (shared.length > 0 || addresses.length > 0)
+                pairs.push({ items: [a, b], files: shared, addresses });
+        }
+    }
+    return {
+        items: items.map((id) => ({ item: id, path: work.inFlight.get(id).path, state: work.inFlight.get(id).state, commits: commitsOf.get(id) })),
+        pairs,
+        changeSets,
+        unattributed,
+    };
+}

package/dist/workspace/promotion-order.d.ts

@@ -0,0 +1,41 @@
+/**
+ * A member's promotion order (#4030): the literal entries of the `environments`
+ * array in its `chant.config.ts`, in the order written. A release moves from
+ * each environment to the next, so `chant components promote --to <env>` can
+ * default `--from` to the step before, and `chant workspace status --json`
+ * lists the order for a reader such as behold's lane.
+ *
+ * A pattern entry such as `pr-*` names no environment, so it is not a step.
+ * A component's own `environments` (`component.schema.json`) say where its
+ * release is hosted in each environment and never set the order.
+ *
+ * `canary` marks a step as the canary step. It is declared and surfaced only:
+ * no chant command acts on it yet.
+ */
+import { type EnvironmentDeclaration } from "../config.js";
+/** One step of a member's promotion order. */
+export interface PromotionStep {
+    name: string;
+    /** True when the entry sets `canary: true`. */
+    canary: boolean;
+}
+/** The member's promotion order from its config's `environments`; `[]` when it declares none. A repeated name keeps its first place. */
+export declare function promotionOrder(declared: readonly EnvironmentDeclaration[] | null | undefined): PromotionStep[];
+/**
+ * The promotion order a `chant.config.ts` writes as literals, read from its
+ * text without running it, or `undefined` when the text is not that simple.
+ * Evaluating a TypeScript config loads tsx, and `workspace status` reads every
+ * member without that cost (#3976), so the plain cases are read here and the
+ * rest fall back to loading the config. The plain cases are a config with no
+ * `environments` and no spread, and one whose only `environments` is an array
+ * of string entries and `{ name, endpoint, canary }` entries with literal values.
+ */
+export declare function staticPromotionOrder(source: string): PromotionStep[] | undefined;
+/**
+ * One member's promotion order from its directory's config: `[]` when it has
+ * none or declares no environments, and null when the config can't be read.
+ * A TypeScript config is read as text when it is plain ({@link staticPromotionOrder}),
+ * and loaded otherwise.
+ */
+export declare function readMemberPromotionOrder(dir: string): Promise<PromotionStep[] | null>;
+//# sourceMappingURL=promotion-order.d.ts.map

package/dist/workspace/promotion-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion-order.d.ts","sourceRoot":"","sources":["../../src/workspace/promotion-order.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAAyC,KAAK,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAE/F,8CAA8C;AAC9C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wIAAwI;AACxI,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,sBAAsB,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,aAAa,EAAE,CAQ9G;AAOD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,GAAG,SAAS,CAwBhF;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,GAAG,IAAI,CAAC,CAa3F"}