@simplysf/simply-gitlab-core 0.1.0 → 0.3.0

package/lib/baseline-plan.js

@@ -0,0 +1,412 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { entryKey, entryLabel, normalizeSection, } from './baseline-config.js';
+import { AuthError, HttpError } from './errors.js';
+/** Whether a plan would change anything if applied. */
+export function hasChanges(plan) {
+    return plan.targets.some((target) => target.error !== undefined || target.sections.some((s) => s.actions.length > 0));
+}
+/** Every drift a plan found, including the parts it would not correct. */
+export function hasDrift(plan) {
+    return plan.targets.some((target) => target.error !== undefined || target.sections.some((s) => s.changes.length > 0));
+}
+/**
+ * `PATCH` on a protected branch cannot change fields the config does not resend, and neither the
+ * approval-rule nor the branch APIs echo their inputs in the same shape they accept them. So
+ * comparison is by JSON value on the fields the config declares, and nothing else is looked at.
+ */
+function sameValue(left, right) {
+    return JSON.stringify(normalize(left)) === JSON.stringify(normalize(right));
+}
+/** Sorts object keys so two equivalent objects compare equal regardless of key order. */
+function normalize(value) {
+    if (Array.isArray(value))
+        return value.map(normalize);
+    if (typeof value === 'object' && value !== null) {
+        return Object.fromEntries(Object.entries(value)
+            .filter(([, v]) => v !== undefined)
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([k, v]) => [k, normalize(v)]));
+    }
+    return value;
+}
+/**
+ * Diffs the attributes a config declares against what the instance reports, ignoring everything
+ * else. This is the whole reason a baseline is safe to run against projects that already exist:
+ * the blast radius is the set of keys someone wrote down.
+ */
+function diffAttributes(desired, actual) {
+    const changes = [];
+    const body = {};
+    for (const [key, want] of Object.entries(desired)) {
+        const have = actual[key];
+        if (!sameValue(want, have)) {
+            changes.push({ op: 'update', key, from: have, to: want });
+            body[key] = want;
+        }
+    }
+    return { changes, body };
+}
+function asRecord(value) {
+    return (typeof value === 'object' && value !== null ? value : {});
+}
+function supported(section, changes, actions) {
+    return { section, supported: true, changes, actions };
+}
+function unsupported(section, reason) {
+    return { section, supported: false, unsupportedReason: reason, changes: [], actions: [] };
+}
+/**
+ * Runs a read that may not be available on this instance.
+ *
+ * Approval rules, approval settings, and push rules are Premium/Ultimate. A 403 or 404 there means
+ * the section does not exist rather than that the run failed, so the other sections still converge
+ * and the plan says which one was skipped and why.
+ */
+async function readOptional(read) {
+    try {
+        return { ok: true, value: await read() };
+    }
+    catch (error) {
+        if (error instanceof AuthError && error.status === 403) {
+            return { ok: false, reason: 'not available to this token, or not on this plan (403)' };
+        }
+        if (error instanceof HttpError && error.status === 404) {
+            return { ok: false, reason: 'not available on this instance (404)' };
+        }
+        throw error;
+    }
+}
+// --- Section planners ---------------------------------------------------------------------------
+async function planSettings(client, ref, desired) {
+    if (desired.settings === undefined)
+        return [];
+    const actual = asRecord(await client.getProject(ref));
+    const { changes, body } = diffAttributes(desired.settings, actual);
+    return [supported('settings', changes, changes.length === 0 ? [] : [{ kind: 'updateProject', body }])];
+}
+/**
+ * Protected branches, which are the one section where the update mechanism materially changes what
+ * a plan means. `PATCH` corrects a protection in place; a rename cannot be patched, so it reads as
+ * a delete and a create — and that pair leaves the branch unprotected in between, which the plan
+ * labels rather than leaving anyone to discover.
+ */
+async function planProtectedBranches(client, ref, desired) {
+    const section = normalizeSection(desired.protectedBranches);
+    if (section === undefined)
+        return [];
+    const actual = (await client.listProtectedBranches(ref)).items.map(asRecord);
+    return [
+        planKeyedSection('protectedBranches', section, actual, {
+            create: (entry) => ({ kind: 'protectBranch', body: { ...entry } }),
+            update: (entry, body) => ({ kind: 'patchProtectedBranch', name: String(entry.name), body }),
+            remove: (entry) => ({ kind: 'unprotectBranch', name: String(entry.name) }),
+        }),
+    ];
+}
+/** Protected tags have no update endpoint, so a change is a delete and a create, and says so. */
+async function planProtectedTags(client, ref, desired) {
+    const section = normalizeSection(desired.protectedTags);
+    if (section === undefined)
+        return [];
+    const actual = (await client.listProtectedTags(ref)).items.map(asRecord);
+    return [
+        planKeyedSection('protectedTags', section, actual, {
+            create: (entry) => ({ kind: 'protectTag', body: { ...entry } }),
+            update: (entry) => ({ kind: 'protectTag', body: { ...entry } }),
+            remove: (entry) => ({ kind: 'unprotectTag', name: String(entry.name) }),
+            recreate: 'protected tags have no update endpoint, so this is a delete and a create',
+            beforeUpdate: (entry) => ({ kind: 'unprotectTag', name: String(entry.name) }),
+        }),
+    ];
+}
+async function planApprovals(client, ref, desired) {
+    if (desired.approvals === undefined)
+        return [];
+    const read = await readOptional(() => client.getApprovalSettings(ref));
+    if (!read.ok)
+        return [unsupported('approvals', read.reason)];
+    const { changes, body } = diffAttributes(desired.approvals, asRecord(read.value));
+    return [supported('approvals', changes, changes.length === 0 ? [] : [{ kind: 'updateApprovalSettings', body }])];
+}
+/**
+ * Approval rules, where the config speaks in names and the API speaks in ids.
+ *
+ * `usernames` the API takes directly. Group paths and protected-branch names it does not, so those
+ * are carried on the action and resolved at apply time — the branch ids in particular cannot be
+ * resolved now, because the branch may be created by the section that runs immediately before this
+ * one.
+ */
+async function planApprovalRules(client, ref, desired) {
+    const section = normalizeSection(desired.approvalRules);
+    if (section === undefined)
+        return [];
+    const read = await readOptional(() => client.listApprovalRules(ref));
+    if (!read.ok)
+        return [unsupported('approvalRules', read.reason)];
+    const actual = read.value.items.map(asRecord);
+    const byName = new Map(actual.map((rule) => [String(rule.name), rule]));
+    const changes = [];
+    const actions = [];
+    for (const entry of section.entries) {
+        const name = String(entry.name);
+        const branches = Array.isArray(entry.protectedBranches) ? entry.protectedBranches : undefined;
+        const body = ruleBody(entry);
+        const existing = byName.get(name);
+        if (existing === undefined) {
+            changes.push({ op: 'create', key: name, to: summarise(entry) });
+            actions.push({ kind: 'createApprovalRule', body, branches });
+            continue;
+        }
+        const attributeChanges = compareRule(entry, existing);
+        if (attributeChanges.length > 0) {
+            changes.push(...attributeChanges.map((change) => ({ ...change, key: `${name}.${change.key}` })));
+            actions.push({ kind: 'updateApprovalRule', ruleId: Number(existing.id), body, branches });
+        }
+    }
+    const declared = new Set(section.entries.map((entry) => String(entry.name)));
+    for (const rule of actual) {
+        const name = String(rule.name);
+        // `any_approver` is GitLab's implicit fallback rule, not something a config declared or should
+        // delete; pruning it would remove the project's default approval behaviour.
+        if (declared.has(name) || rule.rule_type === 'any_approver')
+            continue;
+        changes.push({
+            op: 'delete',
+            key: name,
+            detail: section.prune ? undefined : 'not pruned; set "prune": true on this section to remove it',
+        });
+        if (section.prune)
+            actions.push({ kind: 'deleteApprovalRule', ruleId: Number(rule.id) });
+    }
+    return [supported('approvalRules', changes, actions)];
+}
+/** The rule attributes the API accepts, with the config's name-based references left off. */
+function ruleBody(entry) {
+    const body = {};
+    for (const [key, value] of Object.entries(entry)) {
+        if (key === 'protectedBranches' || key === 'groups')
+            continue;
+        body[key] = value;
+    }
+    return body;
+}
+/** Compares only what the config declared, translating its name-based fields onto the payload. */
+function compareRule(entry, actual) {
+    const changes = [];
+    for (const [key, want] of Object.entries(entry)) {
+        if (key === 'name')
+            continue;
+        if (key === 'usernames') {
+            const have = (Array.isArray(actual.eligible_approvers) ? actual.eligible_approvers : [])
+                .map((user) => asRecord(user).username)
+                .filter((username) => typeof username === 'string');
+            if (!sameValue([...want].sort(), [...have].sort())) {
+                changes.push({ op: 'update', key, from: have, to: want });
+            }
+            continue;
+        }
+        if (key === 'groups') {
+            const have = (Array.isArray(actual.groups) ? actual.groups : [])
+                .map((group) => asRecord(group).full_path)
+                .filter((path) => typeof path === 'string');
+            if (!sameValue([...want].sort(), [...have].sort())) {
+                changes.push({ op: 'update', key, from: have, to: want });
+            }
+            continue;
+        }
+        if (key === 'protectedBranches') {
+            const have = (Array.isArray(actual.protected_branches) ? actual.protected_branches : [])
+                .map((branch) => asRecord(branch).name)
+                .filter((name) => typeof name === 'string');
+            if (!sameValue([...want].sort(), [...have].sort())) {
+                changes.push({ op: 'update', key, from: have, to: want });
+            }
+            continue;
+        }
+        if (!sameValue(want, actual[key]))
+            changes.push({ op: 'update', key, from: actual[key], to: want });
+    }
+    return changes;
+}
+async function planPushRules(client, ref, desired) {
+    if (desired.pushRules === undefined)
+        return [];
+    const read = await readOptional(() => client.getPushRules(ref));
+    if (!read.ok)
+        return [unsupported('pushRules', read.reason)];
+    // A project with no push rules answers 200 with null rather than 404.
+    const existing = read.value !== null && read.value !== undefined;
+    const { changes, body } = diffAttributes(desired.pushRules, asRecord(read.value));
+    return [
+        supported('pushRules', changes, changes.length === 0 ? [] : [{ kind: 'setPushRules', body, exists: existing }]),
+    ];
+}
+/**
+ * Variables are reported, never written.
+ *
+ * Both POST and PUT require a `value`, and a `masked_and_hidden` variable's value is not even
+ * readable, so there is no honest way to reconcile them from a config that by design holds no
+ * values. Naming which projects are missing a key is still the question people actually ask.
+ */
+async function planVariables(client, ref, desired) {
+    const section = normalizeSection(desired.variables);
+    if (section === undefined)
+        return [];
+    const read = await readOptional(() => client.listVariables(ref, 200));
+    if (!read.ok)
+        return [unsupported('variables', read.reason)];
+    const actual = read.value.items.map(asRecord);
+    const byKey = new Map(actual.map((variable) => [entryKey('variables', variable), variable]));
+    const changes = [];
+    for (const entry of section.entries) {
+        const existing = byKey.get(entryKey('variables', entry));
+        const label = entryLabel('variables', entry);
+        if (existing === undefined) {
+            changes.push({ op: 'report', key: label, detail: 'missing; create it with a value by hand' });
+            continue;
+        }
+        for (const [attribute, want] of Object.entries(entry)) {
+            if (attribute === 'key' || attribute === 'environment_scope')
+                continue;
+            if (!sameValue(want, existing[attribute])) {
+                changes.push({
+                    op: 'report',
+                    key: `${label}.${attribute}`,
+                    from: existing[attribute],
+                    to: want,
+                    detail: 'cannot be corrected without resending the value',
+                });
+            }
+        }
+    }
+    // Deliberately no `actions`: this section never writes, whatever `prune` says.
+    return [supported('variables', changes, [])];
+}
+/** A short description of an entry, for a create line in the plan. */
+function summarise(entry) {
+    return Object.entries(entry)
+        .filter(([key]) => key !== 'name')
+        .map(([key, value]) => `${key}: ${Array.isArray(value) ? value.join(', ') : String(value)}`)
+        .join(', ');
+}
+/** The shared shape of every keyed list section: create what is missing, correct what differs. */
+function planKeyedSection(section, desired, actual, handlers) {
+    const byKey = new Map(actual.map((item) => [entryKey(section, item), item]));
+    const changes = [];
+    const actions = [];
+    for (const entry of desired.entries) {
+        const key = entryKey(section, entry);
+        const label = entryLabel(section, entry);
+        const existing = byKey.get(key);
+        if (existing === undefined) {
+            changes.push({ op: 'create', key: label, to: summarise(entry) });
+            actions.push(handlers.create(entry));
+            continue;
+        }
+        const declared = Object.fromEntries(Object.entries(entry).filter(([field]) => field !== 'name'));
+        const { changes: attributeChanges, body } = diffAttributes(declared, existing);
+        if (attributeChanges.length === 0)
+            continue;
+        if (handlers.recreate !== undefined) {
+            changes.push(...attributeChanges.map((change) => ({ ...change, key: `${label}.${change.key}`, detail: handlers.recreate })));
+            if (handlers.beforeUpdate)
+                actions.push(handlers.beforeUpdate(entry));
+            actions.push(handlers.update(entry, body));
+        }
+        else {
+            changes.push(...attributeChanges.map((change) => ({ ...change, key: `${label}.${change.key}` })));
+            actions.push(handlers.update(entry, body));
+        }
+    }
+    const declaredKeys = new Set(desired.entries.map((entry) => entryKey(section, entry)));
+    for (const item of actual) {
+        const key = entryKey(section, item);
+        if (declaredKeys.has(key))
+            continue;
+        changes.push({
+            op: 'delete',
+            key: entryLabel(section, item),
+            detail: desired.prune ? undefined : 'not pruned; set "prune": true on this section to remove it',
+        });
+        if (desired.prune)
+            actions.push(handlers.remove(item));
+    }
+    return supported(section, changes, actions);
+}
+// --- Target planners ----------------------------------------------------------------------------
+/**
+ * The order sections are planned and applied in. Settings first because some of them gate what the
+ * later ones can set; approval rules after protected branches because a rule scoped to a branch
+ * needs that branch to exist before it can reference it.
+ */
+const PROJECT_PLANNERS = [
+    planSettings,
+    planProtectedBranches,
+    planProtectedTags,
+    planApprovals,
+    planApprovalRules,
+    planPushRules,
+    planVariables,
+];
+/** Plans one project. Never throws for an instance failure; the target carries the error instead. */
+export async function planProject(client, target, desired) {
+    const sections = [];
+    try {
+        /* Sections are read in a fixed order rather than concurrently: the order is part of the
+           contract, and a project's own reads are not the bottleneck across fifty of them. */
+        /* eslint-disable no-await-in-loop */
+        for (const planner of PROJECT_PLANNERS) {
+            sections.push(...(await planner(client, target.path, desired)));
+        }
+        /* eslint-enable no-await-in-loop */
+    }
+    catch (error) {
+        return {
+            kind: 'project',
+            path: target.path,
+            id: target.id,
+            sections,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+    return { kind: 'project', path: target.path, id: target.id, sections };
+}
+export async function planGroup(client, target, desired) {
+    if (desired.settings === undefined) {
+        return { kind: 'group', path: target.path, id: target.id, sections: [] };
+    }
+    try {
+        const actual = asRecord(await client.getGroup(target.path));
+        const { changes, body } = diffAttributes(desired.settings, actual);
+        return {
+            kind: 'group',
+            path: target.path,
+            id: target.id,
+            sections: [supported('settings', changes, changes.length === 0 ? [] : [{ kind: 'updateGroup', body }])],
+        };
+    }
+    catch (error) {
+        return {
+            kind: 'group',
+            path: target.path,
+            id: target.id,
+            sections: [],
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+//# sourceMappingURL=baseline-plan.js.map

package/lib/baseline-plan.js.map

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

package/lib/baseline-render.d.ts

@@ -0,0 +1,13 @@
+import type { ApplyResult } from './baseline-apply.js';
+import type { BaselinePlan } from './baseline-plan.js';
+/** The whole plan, target by target, with a closing summary. */
+export declare function renderPlan(plan: BaselinePlan): string;
+/**
+ * The plan as data, for `--json` and for the MCP tool.
+ *
+ * `actions` are deliberately dropped: they are how apply executes, not something a caller should
+ * depend on, and publishing them would make an internal shape part of the contract.
+ */
+export declare function planToJson(plan: BaselinePlan): unknown;
+/** What an apply actually did, after the fact. */
+export declare function renderApply(result: ApplyResult): string;

package/lib/baseline-render.js

@@ -0,0 +1,139 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { summarise } from './baseline-run.js';
+import { stripControlOneLine } from './text.js';
+/**
+ * Renders a plan for a person to read before deciding to apply it.
+ *
+ * Lives in core rather than in the command for the same reason the table column sets do: the MCP
+ * server publishes this plan too, and a renderer only the CLI knew about would drift from what the
+ * tool describes. Nothing here writes to a stream; it returns a string.
+ */
+/** Values in a plan are whatever GitLab returned, so they are rendered defensively. */
+function value(input) {
+    if (input === undefined)
+        return 'unset';
+    if (input === null)
+        return 'null';
+    if (typeof input === 'string')
+        return stripControlOneLine(input) || "''";
+    if (Array.isArray(input))
+        return input.length === 0 ? '[]' : `[${input.map((item) => value(item)).join(', ')}]`;
+    if (typeof input === 'object')
+        return stripControlOneLine(JSON.stringify(input));
+    if (typeof input === 'number' || typeof input === 'boolean')
+        return String(input);
+    // Anything else came from server JSON; serialise rather than coerce it to [object Object].
+    return stripControlOneLine(JSON.stringify(input) ?? '');
+}
+const MARKS = {
+    create: '+',
+    update: '~',
+    delete: '-',
+    recreate: '±',
+    report: '!',
+};
+function renderChange(change) {
+    const mark = MARKS[change.op];
+    const key = stripControlOneLine(change.key);
+    if (change.op === 'update') {
+        const detail = change.detail === undefined ? '' : `   (${change.detail})`;
+        return `    ${mark} ${key}  ${value(change.from)} → ${value(change.to)}${detail}`;
+    }
+    if (change.op === 'report') {
+        const shift = change.to === undefined ? '' : `  ${value(change.from)} → ${value(change.to)}`;
+        return `    ${mark} ${key}${shift}   (${change.detail ?? 'reported only'})`;
+    }
+    const detail = change.detail === undefined ? '' : `   (${change.detail})`;
+    const extra = change.to === undefined ? '' : `  ${value(change.to)}`;
+    return `    ${mark} ${key}${extra}${detail}`;
+}
+function renderSection(section) {
+    if (!section.supported) {
+        return [`  ${section.section}`, `    ! ${section.unsupportedReason ?? 'unsupported on this instance'}`];
+    }
+    if (section.changes.length === 0)
+        return [];
+    return [`  ${section.section}`, ...section.changes.map(renderChange)];
+}
+function renderTarget(target) {
+    const heading = target.kind === 'group' ? `${target.path}  (group)` : target.path;
+    if (target.error !== undefined) {
+        return [heading, `    ✗ ${stripControlOneLine(target.error)}`];
+    }
+    const body = target.sections.flatMap(renderSection);
+    if (body.length === 0)
+        return [heading, '  ✓ matches the baseline'];
+    return [heading, ...body];
+}
+/** The whole plan, target by target, with a closing summary. */
+export function renderPlan(plan) {
+    const blocks = plan.targets.map((target) => renderTarget(target).join('\n'));
+    const counts = summarise(plan);
+    const parts = [
+        `${counts.targets} target(s): ${counts.matching} match, ${counts.differing} differ`,
+        counts.failed > 0 ? `${counts.failed} failed` : undefined,
+        counts.unsupported > 0 ? `${counts.unsupported} with an unsupported section` : undefined,
+    ].filter((part) => part !== undefined);
+    return [blocks.join('\n\n'), `${parts.join(', ')}.`].join('\n\n');
+}
+/**
+ * The plan as data, for `--json` and for the MCP tool.
+ *
+ * `actions` are deliberately dropped: they are how apply executes, not something a caller should
+ * depend on, and publishing them would make an internal shape part of the contract.
+ */
+export function planToJson(plan) {
+    return {
+        targets: plan.targets.map((target) => ({
+            kind: target.kind,
+            path: target.path,
+            id: target.id,
+            ...(target.error === undefined ? {} : { error: target.error }),
+            sections: target.sections.map((section) => ({
+                section: section.section,
+                supported: section.supported,
+                ...(section.unsupportedReason === undefined ? {} : { unsupportedReason: section.unsupportedReason }),
+                changes: section.changes,
+                willChange: section.actions.length > 0,
+            })),
+        })),
+        summary: summarise(plan),
+    };
+}
+/** What an apply actually did, after the fact. */
+export function renderApply(result) {
+    const lines = [];
+    let applied = 0;
+    let failed = 0;
+    for (const target of result.targets) {
+        applied += target.applied;
+        if (target.error !== undefined) {
+            failed += 1;
+            const where = target.failedSection === undefined ? '' : ` in ${target.failedSection}`;
+            lines.push(`${target.path}`);
+            lines.push(`    ✗ stopped${where} after ${target.applied} change(s): ${stripControlOneLine(target.error)}`);
+            continue;
+        }
+        if (target.applied > 0)
+            lines.push(`${target.path}  ✓ ${target.applied} change(s)`);
+    }
+    const summary = failed === 0
+        ? `Applied ${applied} change(s) across ${result.targets.length} target(s).`
+        : `Applied ${applied} change(s); ${failed} target(s) failed. Run plan again to see what is left.`;
+    return lines.length === 0 ? summary : [lines.join('\n'), summary].join('\n\n');
+}
+//# sourceMappingURL=baseline-render.js.map

package/lib/baseline-render.js.map

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

package/lib/baseline-run.d.ts

@@ -0,0 +1,49 @@
+import { type BaselineConfig } from './baseline-config.js';
+import { type BaselinePlan, type TargetPlan } from './baseline-plan.js';
+import { type ResolvedTargets } from './baseline-targets.js';
+import type { GitLabClient } from './gitlab-client.js';
+/** How a run is paced and how it reacts to a target failing. */
+export interface RunOptions {
+    /**
+     * How many targets are in flight at once. Small on purpose: the transport already retries 429
+     * with a capped Retry-After, so setting this high trades a shared instance's responsiveness for
+     * very little wall-clock.
+     */
+    readonly concurrency?: number;
+    /** Stop at the first target that fails, for when a systematic problem makes the rest pointless. */
+    readonly failFast?: boolean;
+    /** Narrow the run to these project paths without editing the config. */
+    readonly only?: readonly string[];
+}
+export declare const DEFAULT_CONCURRENCY = 4;
+export interface PlannedRun {
+    readonly targets: ResolvedTargets;
+    readonly plan: BaselinePlan;
+}
+/**
+ * Runs `worker` over `items` with at most `limit` in flight, preserving input order in the result.
+ *
+ * A pool rather than `Promise.all` in chunks: with fifty targets of uneven size, chunking waits for
+ * the slowest project in each batch before starting the next, which is most of the run.
+ */
+export declare function mapPool<T, R>(items: readonly T[], limit: number, worker: (item: T, index: number) => Promise<R>, 
+/** Return true to stop scheduling further items. Those already in flight still finish. */
+stopAfter?: (result: R) => boolean): Promise<R[]>;
+/**
+ * Resolves the targets and plans every one of them.
+ *
+ * Groups are planned before projects, matching the order `apply` writes them in: a group setting
+ * that projects inherit should be in place before the projects are looked at.
+ */
+export declare function planRun(client: GitLabClient, config: BaselineConfig, options?: RunOptions): Promise<PlannedRun>;
+/** What a plan or an apply amounted to, for the closing summary and the exit code. */
+export interface RunSummary {
+    readonly targets: number;
+    readonly matching: number;
+    readonly differing: number;
+    readonly failed: number;
+    readonly unsupported: number;
+}
+export declare function summarise(plan: BaselinePlan): RunSummary;
+/** Targets that could not be planned or applied, for reporting before the exit code. */
+export declare function failures(plan: BaselinePlan): readonly TargetPlan[];