light-plan 0.0.0-stage → 0.1.0

package/dist/remote/preflight.js

@@ -0,0 +1,342 @@
+/**
+ * The push preflight (LP-273): every value on the board that a remote's
+ * mapping cannot carry, collected into `Problem`s **before anything is
+ * written**.
+ *
+ * Two passes of checking exist and are deliberately different:
+ *
+ *   - `checkRemoteConfiguration` (`check.ts`) validates the *mapping* offline:
+ *     a status mapping that is not total, an account `via` naming no string
+ *     attribute, a mapping key for an undeclared attribute. It reads the config
+ *     alone, whatever documents exist.
+ *   - this module validates the *values*: walk the in-scope documents and ask
+ *     each one "can the mapping carry you?" — its type, its status, its
+ *     attributes, its assignee and its period. The answer is a `Problem[]` that
+ *     a sync command prints before pushing, and `hasErrorProblems` decides
+ *     whether any request is made at all.
+ *
+ * The split that matters here is **dropped vs degraded**:
+ *
+ *   - a value the mapping cannot carry *and* cannot encode is **dropped** — the
+ *     remote issue is written without it, and it is lost. That is an error, and
+ *     it blocks the push: an unmapped type, an unmapped status, an attribute
+ *     value that will not coerce (an enum value with no remote option), a stale
+ *     assignee id, a stale period id.
+ *   - a value the mapping cannot carry natively but the degradation ladder
+ *     encodes elsewhere is **degraded** — a warning, and the push proceeds with
+ *     it named in the summary: an attribute with no mapping (the managed block
+ *     or a custom field), a person with no account (pushed unassigned).
+ *
+ * Pure: no disk, no network. The board and the opened remote are passed in, so
+ * a dry-run is this exact code path with the writes gated off.
+ *
+ * The push is the only direction here. Pull-side gaps (an unknown account, a
+ * remote value that will not coerce back) are found *during* the pull, not
+ * before it, and belong to `planPull`'s reporting — this module is the gate in
+ * front of a write.
+ */
+import { isGenericType } from '../core/config/lookup.js';
+import { displayPath } from '../core/storage/paths.js';
+import { uniqueResourceGaps } from './accounts.js';
+import { isProbe } from './capabilities.js';
+import { mapStatusToRemote, mapTypeToRemote, normalizeStatusMappings, } from './mapping.js';
+import { mappingClaims, reconcileMapping } from './reconcile.js';
+import { normalizePeriodMapping } from './periods.js';
+import { isInScope, resolveScope } from './scope.js';
+/** The mapping's `types` / `attributes` blocks, whatever shape they take. */
+function asRecord(value) {
+    if (value && typeof value === 'object' && !Array.isArray(value)) {
+        return value;
+    }
+    return {};
+}
+/** A value that carries nothing to map. */
+function isBlank(value) {
+    if (value === undefined || value === null || value === '')
+        return true;
+    return Array.isArray(value) && value.length === 0;
+}
+/** An issue as the translator sees it — `BoardFields` without the ids. */
+export function boardFieldsOf(issue) {
+    return {
+        title: issue.title,
+        body: issue.body,
+        type: issue.type,
+        status: issue.status,
+        assignee: issue.assignee,
+        period: issue.period,
+        attributes: issue.attributes,
+    };
+}
+/** The roster slice the account mapping reads: resources keyed by id. */
+export function rosterOf(board) {
+    const roster = new Map();
+    for (const resource of board.resources) {
+        roster.set(resource.id, {
+            id: resource.id,
+            title: resource.title,
+            generic: isGenericType(board.config, resource.type),
+            attributes: resource.attributes,
+        });
+    }
+    return roster;
+}
+/** The timeline slice the period mapping reads: periods keyed by id. */
+export function periodIndexOf(board) {
+    const index = new Map();
+    for (const period of board.periods) {
+        index.set(period.id, {
+            id: period.id,
+            title: period.title,
+            type: period.type,
+            parentId: period.parentId,
+            starts: period.starts,
+            ends: period.ends,
+        });
+    }
+    return index;
+}
+/** Every attribute declared on some issue type, keyed by name. */
+export function attributeDefsOf(board) {
+    const defs = {};
+    for (const type of Object.values(board.config.issue_types)) {
+        for (const [name, def] of Object.entries(type.attributes)) {
+            defs[name] = def;
+        }
+    }
+    return defs;
+}
+/** Dedupe coercion failures by (direction, attribute, reason), sorted. */
+function uniqueAttributeProblems(problems) {
+    const seen = new Set();
+    const out = [];
+    for (const problem of problems) {
+        const key = `${problem.direction}\u0000${problem.attribute}\u0000${problem.reason}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(problem);
+    }
+    return out.sort((a, b) => a.attribute.localeCompare(b.attribute) || a.reason.localeCompare(b.reason));
+}
+/** Dedupe period gaps by period id, sorted. */
+function uniquePeriodGaps(gaps) {
+    const seen = new Set();
+    const out = [];
+    for (const gap of gaps) {
+        if (seen.has(gap.periodId))
+            continue;
+        seen.add(gap.periodId);
+        out.push(gap);
+    }
+    return out.sort((a, b) => a.periodId.localeCompare(b.periodId));
+}
+export function pushGaps(board, remote, issues) {
+    const roster = rosterOf(board);
+    const periods = periodIndexOf(board);
+    const attributeDefs = attributeDefsOf(board);
+    const attributeProblems = [];
+    const resourceGaps = [];
+    const periodGaps = [];
+    for (const issue of issues) {
+        const op = { kind: 'create', localId: issue.id, fields: boardFieldsOf(issue) };
+        const result = remote.provider.translator.describeRequest(op, remote.mapping, attributeDefs, roster, periods);
+        attributeProblems.push(...result.problems);
+        resourceGaps.push(...result.resourceGaps);
+        periodGaps.push(...result.periodGaps);
+    }
+    return { attributeProblems, resourceGaps, periodGaps };
+}
+/**
+ * `accounts` and `periods` say whether those two families are rendered here.
+ * The readiness check turns them off because it reports the same gaps in a
+ * richer form — with the remote's own answer beside them, and a fix to choose
+ * — and one thing reported twice in one dialog reads as two things.
+ */
+export function preflightPush(board, remote, include = {}) {
+    const problems = [];
+    const configPath = displayPath(board.paths, board.paths.configPath);
+    const scope = resolveScope(board.issues, remote.scope);
+    const inScope = board.issues.filter((issue) => isInScope(scope, issue.id));
+    const periods = periodIndexOf(board);
+    // A connection key that only part of the mapping needs — Jira's Agile board
+    // id, which a sprint cannot be found or created without. The provider states
+    // the demand (`conditionalConnection`); this is where the mapping and the
+    // connection are both in hand, and it runs before anything is written. Until
+    // this check existed the push got as far as creating sprints and *then*
+    // stopped, having already asked for confirmation to write.
+    for (const need of remote.provider.conditionalConnection ?? []) {
+        if (remote.mapping[need.needs] === undefined)
+            continue;
+        const value = remote.connection[need.key];
+        if (value !== undefined && value !== '')
+            continue;
+        problems.push({
+            level: 'error',
+            path: configPath,
+            message: `remotes.${remote.name}.connection.${need.key}: the mapping carries ` +
+                `"${need.needs}" and this remote has no ${need.key} — ${need.why}`,
+        });
+    }
+    const typeMappings = asRecord(remote.mapping['types']);
+    const statusMappings = normalizeStatusMappings(asRecord(remote.mapping['statuses']));
+    // An unmapped type is dropped — the issue is filed without it. Error.
+    const usedTypes = [...new Set(inScope.map((issue) => issue.type))].sort();
+    for (const type of usedTypes) {
+        if (mapTypeToRemote(typeMappings, type) === undefined) {
+            problems.push({
+                level: 'error',
+                path: configPath,
+                message: `remotes.${remote.name}.mapping.types.${type}: type "${type}" has no mapping`,
+            });
+        }
+    }
+    // An unmapped status is dropped. Normally `openRemote` already refuses a
+    // non-total status mapping; this is the same rule against the values the
+    // board actually uses, kept for a remote opened through another path.
+    const usedStatuses = [...new Set(inScope.map((issue) => issue.status))].sort();
+    for (const status of usedStatuses) {
+        if (mapStatusToRemote(statusMappings, status) === undefined) {
+            problems.push({
+                level: 'error',
+                path: configPath,
+                message: `remotes.${remote.name}.mapping.statuses.${status}: status "${status}" has no mapping`,
+            });
+        }
+    }
+    // Run the translator over every in-scope document — attributes, assignees and
+    // periods — exactly as the push will, collecting what it reports.
+    const { attributeProblems, resourceGaps, periodGaps } = pushGaps(board, remote, inScope);
+    // An attribute that is used but not mapped degrades — a warning, never an
+    // error: the value is encoded elsewhere, not lost.
+    const mappedAttributes = new Set(Object.keys(asRecord(remote.mapping['attributes'])));
+    const usedAttributes = new Set();
+    for (const issue of inScope) {
+        for (const [name, value] of Object.entries(issue.attributes)) {
+            if (!isBlank(value))
+                usedAttributes.add(name);
+        }
+    }
+    // Custom fields may be a probe (account-dependent) — offline, the preflight
+    // reads the declared cell conservatively: a probed or absent cell means the
+    // managed block, a literal non-null cell means a custom field. The resolved
+    // answer is the sync command's to supply (LP-275 names the rung for real).
+    const customFields = remote.provider.capabilities.customFields;
+    const provisionable = !isProbe(customFields) && customFields !== null;
+    const rung = provisionable ? 'a custom field' : 'the managed block';
+    for (const attribute of [...usedAttributes].sort()) {
+        if (mappedAttributes.has(attribute))
+            continue;
+        problems.push({
+            level: 'warn',
+            path: configPath,
+            message: `remotes.${remote.name}.mapping.attributes.${attribute}: attribute "${attribute}" is not mapped; it will be encoded in ${rung}`,
+        });
+    }
+    // A coercion failure is dropped — an enum value with no remote option, free
+    // text in a number field. Error.
+    for (const problem of uniqueAttributeProblems(attributeProblems)) {
+        problems.push({
+            level: 'error',
+            path: configPath,
+            message: `remotes.${remote.name}.mapping.attributes.${problem.attribute}: ${problem.reason}`,
+        });
+    }
+    // A stale assignee id is dropped; a person with no account is degraded to
+    // unassigned. The gap carries no level, so the split is made here: an id not
+    // on the roster is an error, everything else a warning.
+    for (const gap of include.accounts === false ? [] : uniqueResourceGaps(resourceGaps)) {
+        const stale = !board.resourcesById.has(gap.resourceId);
+        problems.push(stale
+            ? {
+                level: 'error',
+                path: configPath,
+                message: `remotes.${remote.name}.mapping.accounts: assignee "${gap.resourceId}" is not on the roster`,
+            }
+            : {
+                level: 'warn',
+                path: configPath,
+                message: `remotes.${remote.name}.mapping.accounts.via: ${gap.resourceTitle} is pushed unassigned (${gap.reason})`,
+            });
+    }
+    // A period id the timeline does not know is dropped. Error.
+    for (const gap of include.periods === false ? [] : uniquePeriodGaps(periodGaps)) {
+        problems.push({
+            level: 'error',
+            path: configPath,
+            message: `remotes.${remote.name}.mapping.periods: period "${gap.periodId}" is not on the timeline`,
+        });
+    }
+    // Iteration fields have a fixed duration set on the field, not per item
+    // (LP-313 note): a board whose mapped periods vary in length cannot fit one
+    // iteration field, so the mismatch is reported at preflight rather than a
+    // push quietly rounding.
+    const periodMapping = normalizePeriodMapping(remote.mapping['periods']);
+    if (periodMapping?.carrier === 'iteration') {
+        const durations = new Set();
+        for (const period of board.periods) {
+            if (period.type !== periodMapping.container)
+                continue;
+            if (period.starts === undefined || period.ends === undefined)
+                continue;
+            const start = Date.parse(period.starts);
+            const end = Date.parse(period.ends);
+            if (Number.isNaN(start) || Number.isNaN(end))
+                continue;
+            durations.add(Math.round((end - start) / 86400000));
+        }
+        if (durations.size > 1) {
+            problems.push({
+                level: 'warn',
+                path: configPath,
+                message: `remotes.${remote.name}.mapping.periods: the ${periodMapping.container} periods vary in length (${[...durations].sort((a, b) => a - b).join(', ')} days), but a GitHub iteration field has one fixed duration — the carrier will not fit irregular sprints`,
+            });
+        }
+    }
+    return problems;
+}
+/**
+ * The gate the story names: an error-level problem means no request that
+ * writes may be made. Warnings (degraded fields) do not block — the sync
+ * proceeds and the caller shows them in its summary.
+ */
+export function hasErrorProblems(problems) {
+    return problems.some((problem) => problem.level === 'error');
+}
+/**
+ * The mapped names this project does not have — the check that turns a
+ * mid-push `400 Specify a valid issue type` into a refusal before anything is
+ * written.
+ *
+ * Pure: the caller does the asking (`connector.vocabulary()`) and hands the
+ * answer here. It is the same reconciliation `lpm remote setup` prints, read
+ * for a different purpose: setup *reports* so somebody can fix the mapping,
+ * and a push *refuses*, because filing an issue under a type the project has
+ * never heard of cannot do anything but fail.
+ *
+ * A vocabulary the remote does not report at all (an absent list) is not
+ * evidence of anything and produces no problems — the same rule as every other
+ * "absence is not evidence" case in this layer.
+ */
+export function vocabularyProblems(remote, vocabulary, configPath) {
+    const report = reconcileMapping(mappingClaims(remote.mapping), vocabulary);
+    const problems = [];
+    for (const [block, entries] of [
+        ['types', report.types],
+        ['statuses', report.statuses],
+    ]) {
+        for (const entry of entries?.entries ?? []) {
+            if (entry.verdict !== 'unresolved')
+                continue;
+            const has = (entries?.candidates ?? []).join(', ');
+            problems.push({
+                level: 'error',
+                path: configPath,
+                message: `remotes.${remote.name}.mapping.${block}.${entry.boardKey}: the remote has no ` +
+                    `"${entry.claimed}"${has === '' ? '' : ` — it has: ${has}`}`,
+            });
+        }
+    }
+    return problems;
+}
+//# sourceMappingURL=preflight.js.map

package/dist/remote/preflight.js.map

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

package/dist/remote/prerequisites.d.ts

@@ -0,0 +1,113 @@
+/**
+ * What a remote must already have before a push can land — created by the push
+ * itself.
+ *
+ * Some of what a board carries is not an issue field on the other side but a
+ * *thing the tracker has to own first*: a GitHub repository only applies labels
+ * it already defines, a Projects v2 board only sets a field that has been
+ * created with the right options. Push a plan onto a fresh project and every
+ * one of those is missing.
+ *
+ * **Sprints are deliberately not in that list, though they look like they
+ * belong.** A label is vocabulary — it exists only because the mapping needs
+ * somewhere to put a type — but a sprint is a *document on the board*, with a
+ * name and dates somebody wrote down. Creating one is filing part of the plan,
+ * not preparing to file it, and bundling it in here meant a board's whole
+ * timeline had to land before a single story could: one refused sprint name
+ * and nothing could be pushed at all. Periods are pushed like any other
+ * document (`lpm remote push TL-3`), and an issue whose sprint is not there
+ * yet is filed unscheduled and repaired by the push that files the sprint.
+ *
+ * This used to be a command of its own — `lpm remote provision` — which meant
+ * the first push failed, printed the name of a second command, and worked on
+ * the retry. That is a tool asking somebody to learn a word ("provision") for a
+ * step it could simply take: nothing here is a decision, it is all *implied* by
+ * the mapping the board already wrote down. A sprint is a period on the board,
+ * a label is how this provider carries a type; creating them is part of filing
+ * the plan, not a separate act.
+ *
+ * So the push does it, and reports what it made. Two entry points, the same
+ * split the rest of this layer uses: `planPrerequisites` asks the remote what
+ * it has and returns what is missing (read-only, safe on a dry run), and
+ * `createPrerequisites` makes them. The *desired* sets stay pure in
+ * `provision.ts` — this module is only the I/O and the ordering.
+ *
+ * Nothing here is destructive: every operation creates something the mapping
+ * already names, each is idempotent, and a provider whose connector cannot do
+ * one of them simply reports nothing for it.
+ */
+import type { LoadedBoard } from '../core/board/load.js';
+import type { BoardPaths } from '../core/storage/paths.js';
+import type { Connector } from './provider.js';
+import type { OpenedRemote } from './remotes.js';
+import { type ProjectProvisionPlan } from './providers/github/project-provision.js';
+/** One sprint the timeline names and the remote has not got. */
+export interface MissingSprint {
+    name: string;
+    starts?: string;
+    ends?: string;
+}
+/** What the remote is missing, before a push writes anything. */
+export interface Prerequisites {
+    /** Mapped labels the remote does not define. */
+    labels: string[];
+    /**
+     * Sprints named by the periods this run was *asked* to file, and only those.
+     * Empty unless the run names period documents — pushing work never files the
+     * timeline behind it.
+     */
+    sprints: MissingSprint[];
+    /** The Projects v2 fields and options to create, when the mapping names a Project. */
+    project?: {
+        id: string;
+        plan: ProjectProvisionPlan;
+    };
+}
+/** One thing the remote would not create, and what it said about it. */
+export interface PrerequisiteFailure {
+    /** What was being created — `sprint "Sprint 5 — Test Coverage"`. */
+    what: string;
+    /** The remote's own complaint, as the connector rendered it. */
+    message: string;
+    /** The connector's hints, when it had any. */
+    details: readonly string[];
+}
+/** What a push actually created, for its report. */
+export interface PrerequisiteReport {
+    labels: string[];
+    sprints: string[];
+    /** Projects v2 fields created, and single-select options added. */
+    projectFields: number;
+    projectOptions: number;
+    /**
+     * What the remote refused. **Collected, never thrown**, for two reasons. A
+     * push is partial rather than atomic everywhere else, and a sprint the
+     * tracker will not create is no reason to refuse to file forty issues that
+     * have nothing to do with it — whatever actually needed the missing thing
+     * fails as its own operation, with its own message. And stopping at the
+     * first refusal means learning about the others one run at a time: a board
+     * with sixteen sprints, three of them named too long for Jira, took three
+     * pushes to reveal three problems that could have been one list.
+     */
+    failures: PrerequisiteFailure[];
+}
+/** True when nothing at all is missing — the ordinary case after the first push. */
+export declare function isSatisfied(pre: Prerequisites): boolean;
+/** An empty report, for a run that had nothing to create. */
+export declare function emptyReport(): PrerequisiteReport;
+/**
+ * Ask the remote what it is missing. Read-only on both sides, so a dry run can
+ * say what a real push would create without creating it.
+ *
+ * A connector that cannot list a kind of thing contributes nothing of that kind
+ * — the capability is the connector's to have, never this module's to assume.
+ */
+export declare function planPrerequisites(board: LoadedBoard, remote: OpenedRemote, connector: Connector, paths: BoardPaths, options?: {
+    periods?: 'all' | ReadonlySet<string>;
+}): Promise<Prerequisites>;
+/**
+ * Create what `planPrerequisites` found, in the order a push needs it: labels
+ * and sprints before any issue is written, Project fields before a status is
+ * set on one.
+ */
+export declare function createPrerequisites(remote: OpenedRemote, connector: Connector, paths: BoardPaths, pre: Prerequisites): Promise<PrerequisiteReport>;

package/dist/remote/prerequisites.js

@@ -0,0 +1,161 @@
+/**
+ * What a remote must already have before a push can land — created by the push
+ * itself.
+ *
+ * Some of what a board carries is not an issue field on the other side but a
+ * *thing the tracker has to own first*: a GitHub repository only applies labels
+ * it already defines, a Projects v2 board only sets a field that has been
+ * created with the right options. Push a plan onto a fresh project and every
+ * one of those is missing.
+ *
+ * **Sprints are deliberately not in that list, though they look like they
+ * belong.** A label is vocabulary — it exists only because the mapping needs
+ * somewhere to put a type — but a sprint is a *document on the board*, with a
+ * name and dates somebody wrote down. Creating one is filing part of the plan,
+ * not preparing to file it, and bundling it in here meant a board's whole
+ * timeline had to land before a single story could: one refused sprint name
+ * and nothing could be pushed at all. Periods are pushed like any other
+ * document (`lpm remote push TL-3`), and an issue whose sprint is not there
+ * yet is filed unscheduled and repaired by the push that files the sprint.
+ *
+ * This used to be a command of its own — `lpm remote provision` — which meant
+ * the first push failed, printed the name of a second command, and worked on
+ * the retry. That is a tool asking somebody to learn a word ("provision") for a
+ * step it could simply take: nothing here is a decision, it is all *implied* by
+ * the mapping the board already wrote down. A sprint is a period on the board,
+ * a label is how this provider carries a type; creating them is part of filing
+ * the plan, not a separate act.
+ *
+ * So the push does it, and reports what it made. Two entry points, the same
+ * split the rest of this layer uses: `planPrerequisites` asks the remote what
+ * it has and returns what is missing (read-only, safe on a dry run), and
+ * `createPrerequisites` makes them. The *desired* sets stay pure in
+ * `provision.ts` — this module is only the I/O and the ordering.
+ *
+ * Nothing here is destructive: every operation creates something the mapping
+ * already names, each is idempotent, and a provider whose connector cannot do
+ * one of them simply reports nothing for it.
+ */
+import { BoardError } from '../core/errors.js';
+import { labelColor, missingLabels } from './labels.js';
+import { missingSprints } from './providers/jira/sprints.js';
+import { desiredLabelsOf, desiredSprintsOf } from './provision.js';
+import { resolveProjectIds } from './providers/github/projects.js';
+import { desiredProjectFields, planProjectProvision, provisionProjectGraphql, } from './providers/github/project-provision.js';
+/** True when nothing at all is missing — the ordinary case after the first push. */
+export function isSatisfied(pre) {
+    return (pre.labels.length === 0 &&
+        pre.sprints.length === 0 &&
+        (pre.project === undefined || pre.project.plan.empty));
+}
+/** An empty report, for a run that had nothing to create. */
+export function emptyReport() {
+    return { labels: [], sprints: [], projectFields: 0, projectOptions: 0, failures: [] };
+}
+/**
+ * Ask the remote what it is missing. Read-only on both sides, so a dry run can
+ * say what a real push would create without creating it.
+ *
+ * A connector that cannot list a kind of thing contributes nothing of that kind
+ * — the capability is the connector's to have, never this module's to assume.
+ */
+export async function planPrerequisites(board, remote, connector, paths, options) {
+    const labels = typeof connector.listLabels === 'function' && typeof connector.createLabel === 'function'
+        ? missingLabels(desiredLabelsOf(board, remote), await connector.listLabels())
+        : [];
+    // Only the periods this run names. `desiredSprintsOf` still answers "every
+    // period at the mapped level", and `lpm remote push --all` asks for exactly
+    // that; a run that named some documents asks for those.
+    const wanted = options?.periods;
+    const sprints = wanted !== undefined &&
+        typeof connector.listSprints === 'function' &&
+        typeof connector.createSprint === 'function'
+        ? missingSprints(desiredSprintsOf(board, remote).filter((sprint) => wanted === 'all' || wanted.has(sprint.name)), await connector.listSprints())
+        : [];
+    const input = projectInputOf(remote);
+    let project;
+    if (input !== undefined) {
+        // Always against the live Project: the plan must compare what is desired to
+        // what exists *now*, not to a cache that may predate a field created by
+        // hand.
+        const resolved = await resolveProjectIds(connector, input, paths, remote.name, {
+            refresh: true,
+        });
+        project = {
+            id: resolved.ids.project.id,
+            plan: planProjectProvision(resolved.ids, desiredProjectFields(board, remote)),
+        };
+    }
+    return { labels, sprints, ...(project !== undefined ? { project } : {}) };
+}
+/**
+ * Create what `planPrerequisites` found, in the order a push needs it: labels
+ * and sprints before any issue is written, Project fields before a status is
+ * set on one.
+ */
+export async function createPrerequisites(remote, connector, paths, pre) {
+    const report = emptyReport();
+    /** Run one creation, recording a refusal rather than abandoning the rest. */
+    const attempt = async (what, run) => {
+        try {
+            await run();
+            return true;
+        }
+        catch (error) {
+            report.failures.push({
+                what,
+                message: error instanceof Error ? error.message : String(error),
+                details: error instanceof BoardError ? error.details : [],
+            });
+            return false;
+        }
+    };
+    for (const label of pre.labels) {
+        const made = await attempt(`label ${label}`, async () => {
+            await connector.createLabel(label, labelColor(label));
+        });
+        if (made)
+            report.labels.push(label);
+    }
+    for (const sprint of pre.sprints) {
+        const made = await attempt(`sprint "${sprint.name}"`, async () => {
+            await connector.createSprint(sprint.name, sprint.starts, sprint.ends);
+        });
+        if (made)
+            report.sprints.push(sprint.name);
+    }
+    if (pre.project !== undefined && !pre.project.plan.empty) {
+        const project = pre.project;
+        await attempt('Projects v2 fields', async () => {
+            const outcome = await provisionProjectGraphql(connector, project.id, project.plan);
+            report.projectFields = outcome.created.length;
+            report.projectOptions = outcome.optionsAdded.reduce((total, field) => total + field.added.length, 0);
+            // Re-resolve so the new field and option node ids land in the committed
+            // cache: the executor reads them rather than resolving again.
+            const input = projectInputOf(remote);
+            if (input !== undefined) {
+                await resolveProjectIds(connector, input, paths, remote.name, { refresh: true });
+            }
+        });
+    }
+    return report;
+}
+/** The Projects v2 target a mapping names, or `undefined` when it names none. */
+function projectInputOf(remote) {
+    const project = remote.mapping['project'];
+    if (project === undefined)
+        return undefined;
+    const repo = remote.connection['repo'];
+    if (typeof repo !== 'string' || repo === '') {
+        throw new BoardError(`Remote "${remote.name}" has no repository`, [
+            `Set remotes.${remote.name}.connection.repo to "owner/repo".`,
+        ]);
+    }
+    const fields = remote.mapping['fields'] ?? {};
+    return {
+        repo,
+        project: project,
+        fields: Object.fromEntries(Object.entries(fields).map(([key, value]) => [key, String(value)])),
+    };
+}
+//# sourceMappingURL=prerequisites.js.map

package/dist/remote/prerequisites.js.map

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