light-plan 0.0.0-stage → 0.1.0

package/dist/remote/providers/jira/translator.js

@@ -0,0 +1,382 @@
+/**
+ * Jira's two-way vocabulary translation.
+ *
+ * Jira Cloud has *native* issue types, workflow statuses and custom fields, so
+ * the mapping names them rather than encoding them onto labels (the GitHub
+ * approach). This translator is the Jira-specific bridge, using the remote's
+ * `mapping` block:
+ *
+ *   push: a `BoardOp` plus the mapping becomes a `RemoteRequest` carrying
+ *         `type` (issuetype name), `state` (workflow status name, transition-
+ *         mediated), `title`, `body`, `assignee` and `parent` key;
+ *   pull: a Jira issue record plus the mapping becomes a `BoardFieldsPatch`,
+ *         recovering `type` from `fields.issuetype.name` and `status` from
+ *         `fields.status.name` when the mapping names them unambiguously.
+ *
+ * Pure: no I/O. One translator serves every Jira remote. Where a value cannot
+ * be mapped back unambiguously, the field is left absent rather than guessed —
+ * the pull planner breaks ties with the board's hierarchy (LP-268).
+ *
+ * Two things are deliberately deferred rather than half-encoded here:
+ * **custom fields** (LP-324) — `mapping.attributes` names a field id, but
+ * `RemoteRequest` has no field to carry it, so attributes are deferred until
+ * that wire shape exists. **Sprints** (LP-328) are carried natively: the
+ * period resolves to a `PeriodContainer` on push and the connector writes the
+ * sprint field, and on pull the connector's `record.sprint` enrichment resolves
+ * back to a period by name.
+ */
+import { adfToMarkdown, markdownToAdf } from '../../../shared/adf.js';
+import { stripManagedBlock } from '../../links.js';
+import { parseManagedBlock } from '../../managed-block.js';
+import { withBlockAssignee } from '../../accounts.js';
+import { boardTypesMatching, mapStatusFromRemote, mapStatusToRemote, mapTypeToRemote, } from '../../mapping.js';
+import { mapAssigneeFromRemote, mapAssigneeToRemote, normalizeAccountMapping, } from '../../accounts.js';
+import { degradedFromBlockFields, degradedTypesOf, mapPeriodFromRemote, mapPeriodToRemote, normalizePeriodMapping, } from '../../periods.js';
+import { isSubtaskType } from './types.js';
+/** A Jira issue's `fields` object, read loosely. */
+function fieldsOf(record) {
+    const fields = record['fields'];
+    if (fields && typeof fields === 'object' && !Array.isArray(fields)) {
+        return fields;
+    }
+    return {};
+}
+/** The Jira issuetype name, when the record carries one. */
+function issueTypeNameOf(record) {
+    const issuetype = fieldsOf(record)['issuetype'];
+    if (issuetype && typeof issuetype === 'object') {
+        const name = issuetype['name'];
+        if (typeof name === 'string')
+            return name;
+    }
+    return undefined;
+}
+/**
+ * Whether this record is a Jira **sub-task**, by Jira's own marker.
+ *
+ * Not the type's *name*, which a project may rename or localise, and not the
+ * board's type name, which says nothing about what Jira thinks. `isSubtaskType`
+ * is the one definition — it reads the `subtask` boolean and falls back to
+ * `hierarchyLevel === -1`, which is the same claim spelled the other way.
+ */
+function isSubtaskRecord(record) {
+    const issuetype = fieldsOf(record)['issuetype'];
+    if (issuetype === null || typeof issuetype !== 'object')
+        return false;
+    return isSubtaskType(issuetype);
+}
+/** The Jira status name, when the record carries one. */
+function statusNameOf(record) {
+    const status = fieldsOf(record)['status'];
+    if (status && typeof status === 'object') {
+        const name = status['name'];
+        if (typeof name === 'string')
+            return name;
+    }
+    return undefined;
+}
+/**
+ * Recover the local markdown body from a Jira `description` field.
+ *
+ * Jira Cloud returns `description` as an ADF document (an object) — never a
+ * markdown string — so this is where ADF → markdown happens. It also accepts
+ * the defensive spellings: a client that stringified the ADF, and a plain
+ * string left by an older write, both degrade gracefully rather than dropping
+ * the prose.
+ */
+export function bodyFromDescription(description) {
+    if (description === undefined || description === null)
+        return undefined;
+    if (typeof description === 'string') {
+        const trimmed = description.trim();
+        if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+            try {
+                const parsed = JSON.parse(trimmed);
+                if (parsed !== null && typeof parsed === 'object' && typeof parsed['type'] === 'string') {
+                    return adfToMarkdown(parsed);
+                }
+            }
+            catch {
+                // Not JSON — fall through and treat the string as literal prose.
+            }
+        }
+        return description;
+    }
+    if (typeof description === 'object' && typeof description['type'] === 'string') {
+        return adfToMarkdown(description);
+    }
+    return undefined;
+}
+/** The Jira labels as plain strings. */
+function labelsOf(record) {
+    const labels = fieldsOf(record)['labels'];
+    if (!Array.isArray(labels))
+        return [];
+    return labels.filter((label) => typeof label === 'string');
+}
+/**
+ * The assignee value the account mapping should match against (LP-329). The
+ * generic pull matches the observed value against each person's `via`
+ * attribute, so the value must be of the *same kind* as that attribute:
+ *
+ *   - `via: email` matches `assignee.emailAddress` — an email attribute against
+ *     an email. A privacy-restricted instance hides the address, in which case
+ *     the value falls back to the account id (which will not match, and the
+ *     pull reports the assignee as unknown rather than guessing);
+ *   - any other `via` (a `jira_account_id` attribute) matches the account id.
+ */
+function assigneeValueOf(record, via) {
+    const assignee = fieldsOf(record)['assignee'];
+    if (!assignee || typeof assignee !== 'object')
+        return undefined;
+    const a = assignee;
+    if (via === 'email') {
+        const email = a['emailAddress'];
+        if (typeof email === 'string' && email.length > 0)
+            return email;
+    }
+    const accountId = a['accountId'];
+    if (typeof accountId === 'string')
+        return accountId;
+    return undefined;
+}
+/**
+ * Push: a board op becomes a Jira request description.
+ *
+ * `type` is the mapped issuetype name; `state` the mapped workflow status name
+ * (a push writes it as a transition, resolved by the connector). A create/update
+ * also carries `title`, `body` and the resolved assignee account id. A delete
+ * carries only its kind — Jira deletes hard.
+ */
+export function describeRequest(op, mapping, _attributes, roster = new Map(), periods = new Map()) {
+    if (op.kind === 'delete') {
+        return { request: { kind: 'delete' }, problems: [], resourceGaps: [], periodGaps: [] };
+    }
+    const m = mapping;
+    const resourceGaps = [];
+    const periodGaps = [];
+    let state;
+    let assignee;
+    let period;
+    let degradedPeriods;
+    // Jira has a native issuetype, so the mapped value is written there.
+    const type = mapTypeToRemote(m.types ?? {}, op.fields.type);
+    const remoteStatus = mapStatusToRemote(m.statuses ?? {}, op.fields.status);
+    if (remoteStatus !== undefined)
+        state = remoteStatus;
+    if (op.fields.assignee !== undefined) {
+        const accounts = normalizeAccountMapping(m.accounts);
+        const push = mapAssigneeToRemote(roster, accounts, op.fields.assignee);
+        assignee = push.account ?? null;
+        if (push.gap)
+            resourceGaps.push(push.gap);
+    }
+    // Period: resolve the issue's period to a sprint (the container) plus the
+    // degraded levels above it, which ride the managed block (LP-328, LP-313).
+    // Absent (`undefined`) means the op does not carry a period, so the remote
+    // side is left untouched; a period at a degraded level has no container and
+    // clears the sprint, its membership riding on the block instead.
+    if (op.fields.period !== undefined) {
+        const periodMapping = normalizePeriodMapping(m.periods);
+        if (periodMapping) {
+            const push = mapPeriodToRemote(periods, periodMapping, op.fields.period);
+            if (push.degraded.length > 0)
+                degradedPeriods = push.degraded;
+            period = push.container ?? null;
+            if (push.gap)
+                periodGaps.push(push.gap);
+        }
+    }
+    // The body leaves here as **markdown**, with the managed block stripped: the
+    // block is the executor's to compose (it knows the degraded parent, the
+    // degraded period levels and the edges that landed), and it composes in
+    // markdown. Converting to ADF here meant the executor's
+    // `typeof body === 'string'` guard skipped the block entirely on create and
+    // sent raw markdown on a block rewrite, which Jira refused — so rung 4 did
+    // not work on Jira at all. The connector converts at the wire, which is
+    // where an encoding belongs.
+    let body;
+    if (op.fields.body !== undefined) {
+        body = stripManagedBlock(op.fields.body);
+    }
+    return {
+        request: {
+            kind: op.kind,
+            type,
+            title: op.fields.title,
+            body,
+            state,
+            assignee,
+            period,
+            ...(degradedPeriods !== undefined ? { degradedPeriods } : {}),
+        },
+        problems: [],
+        resourceGaps,
+        periodGaps,
+    };
+}
+/**
+ * Pull: a Jira issue record becomes board fields.
+ *
+ * `title` ← `fields.summary`; `body` ← `fields.description` (a string here —
+ * Jira Cloud returns ADF, and LP-322 is where the ADF → markdown conversion
+ * lands); `type` ← `fields.issuetype.name` matched against the mapping's
+ * native type names; `status` ← `fields.status.name`; `assignee` ← the account
+ * id matched against the roster.
+ */
+export function fieldsFromRecord(record, mapping, _attributes, roster = new Map(), periods = new Map()) {
+    const m = mapping;
+    const patch = {};
+    const unknownAccounts = [];
+    const result = { patch, problems: [], unknownAccounts };
+    const summary = fieldsOf(record)['summary'];
+    if (typeof summary === 'string')
+        patch.title = summary;
+    // `description` is ADF on Jira Cloud; ADF → markdown lands here (LP-323).
+    //
+    // The managed block is the sync layer's own output, never the document's
+    // prose, so it is **parsed off** the way GitHub and Linear have always parsed
+    // it. Jira used to do neither: the block's markdown was written straight into
+    // the local body on every pull, and everything it carried — the degraded
+    // period levels, the parent, the assignee a tracker cannot hold — was lost.
+    // A board pushed to Jira and pulled back somewhere else came out missing the
+    // half of itself that Jira has no field for, which is exactly what the block
+    // exists to prevent.
+    const body = bodyFromDescription(fieldsOf(record)['description']);
+    let managedFields = {};
+    if (body !== undefined) {
+        const parsed = parseManagedBlock(body);
+        patch.body = parsed.found ? parsed.body : body;
+        if (parsed.found)
+            managedFields = parsed.fields;
+    }
+    // Type: the native issuetype name matched against the mapping's `type`
+    // names. Ambiguity leaves the field absent — the pull planner breaks ties.
+    const remoteType = issueTypeNameOf(record);
+    if (remoteType !== undefined) {
+        const candidates = boardTypesMatching(m.types ?? {}, { remoteType, labels: [] });
+        if (candidates.length === 1)
+            patch.type = candidates[0];
+    }
+    // Status: the native status name resolved through the mapping.
+    const remoteStatus = statusNameOf(record);
+    if (remoteStatus !== undefined) {
+        const resolution = mapStatusFromRemote(m.statuses ?? {}, [remoteStatus]);
+        if (resolution.status !== undefined)
+            patch.status = resolution.status;
+    }
+    // Period: the sprint (enriched onto the record by the connector as
+    // `record.sprint`) resolves to a local period by name among the mapped
+    // level's periods; its dates are recovered for the planner to reconcile, and
+    // a sprint matching no local period is reported, never invented (LP-328).
+    //
+    // **A sub-task's sprint is not its own, so it is never read back.** Jira does
+    // not let a sub-task be scheduled independently: it reports the *parent's*
+    // sprint on the sub-task, the identical object, whether or not anything ever
+    // wrote it there. Reading that as the sub-task's own value is a remote edit
+    // nobody made — on this repository's board every one of the 13 sub-tasks came
+    // back `behind` on `period`, permanently, because the board schedules the
+    // story and Jira echoes that sprint onto each of its children. Pulling it
+    // would not settle anything either: it would write a derived sprint onto
+    // documents the plan deliberately schedules one level up, changing what the
+    // periods view and the Gantt add up, and every one of them would drift again
+    // the moment the parent moved sprint.
+    //
+    // Omitting the field is the whole fix, in both directions, because the base
+    // snapshot falls back to the *local* value for a field the record does not
+    // carry (`baseFromRecord` in execute.ts): board and base agree, so nothing is
+    // ahead, and there is no remote value, so nothing is behind. The sprint is
+    // still mirrored — by the parent's own twin, which is the document that owns
+    // it. Same family as `normalizeBody`: a round trip the remote performs
+    // anyway, absorbed rather than reported as drift.
+    const periodMapping = normalizePeriodMapping(m.periods);
+    if (periodMapping && !isSubtaskRecord(record)) {
+        const sprint = record['sprint'];
+        let name;
+        let starts;
+        let ends;
+        if (sprint !== null && typeof sprint === 'object') {
+            const observed = sprint;
+            if (typeof observed['name'] === 'string')
+                name = observed['name'];
+            if (typeof observed['starts'] === 'string')
+                starts = observed['starts'];
+            if (typeof observed['ends'] === 'string')
+                ends = observed['ends'];
+        }
+        const pull = mapPeriodFromRemote(periods, periodMapping, {
+            container: name,
+            starts,
+            ends,
+            // The levels above the mapped one ride the block, because a Jira sprint is
+            // the only native container there is. Reading them back is what lets a
+            // fresh board recover the increment an issue sat in.
+            degraded: degradedFromBlockFields(managedFields, degradedTypesOf(periods, periodMapping)),
+        });
+        if (pull.periodId !== undefined)
+            patch.period = pull.periodId;
+        result.period = pull;
+    }
+    // Assignee: the account id (or, for `via: email`, the email address) matched
+    // against the roster's `via` attribute. An assignee nobody matches is
+    // reported, never invented (LP-329).
+    const accounts = normalizeAccountMapping(m.accounts);
+    const account = assigneeValueOf(record, accounts?.via);
+    const labels = labelsOf(record);
+    // An assignee the remote could not hold rides the managed block (rung 4), and
+    // it is recovered by handing the block's value to the same pool resolution the
+    // `pool:` label uses — both carry a board resource id, so one reader serves
+    // both and there is no second way for an assignee to come back.
+    const resolved = mapAssigneeFromRemote(roster, accounts, {
+        account,
+        labels: withBlockAssignee(labels, managedFields),
+    });
+    if (resolved.resourceId !== undefined) {
+        patch.assignee = resolved.resourceId;
+    }
+    else if (resolved.unassigned) {
+        patch.assignee = null;
+    }
+    else if (resolved.unknown) {
+        unknownAccounts.push(resolved.unknown);
+    }
+    return result;
+}
+/**
+ * A board body as Jira will hand it back.
+ *
+ * Jira's description is ADF, and ADF has paragraphs but no source line breaks:
+ * a body hard-wrapped at eighty columns is one paragraph node on the way out
+ * and comes back as one long line. The base snapshot records what the remote
+ * echoed, so without this every wrapped document is permanently ahead — a push
+ * that rewrote all forty-three of them, and did it again on the next run.
+ *
+ * Running the board's own body through the same round trip makes the comparison
+ * like-for-like: re-wrapping stops counting as a change, and a real edit on
+ * either side still does.
+ */
+function normalizeBody(markdown) {
+    return adfToMarkdown(markdownToAdf(markdown));
+}
+/**
+ * Which of a remote user's fields answers a board attribute.
+ *
+ * Jira assigns by **account id** and nothing else; an `email` in the mapping
+ * is a lookup key the connector resolves by search, not the thing Jira stores.
+ * So an `email`-keyed roster wants the user's email and everything else wants
+ * the account id — and a user the instance reports without an email (a
+ * privacy-restricted site does exactly that) cannot answer an email-keyed
+ * attribute at all, which is `undefined` rather than a guess.
+ */
+function accountValue(user, via) {
+    if (via === 'email')
+        return user.email;
+    return user.id;
+}
+export const jiraTranslator = {
+    describeRequest,
+    fieldsFromRecord,
+    normalizeBody,
+    accountValue,
+};
+//# sourceMappingURL=translator.js.map

package/dist/remote/providers/jira/translator.js.map

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

package/dist/remote/providers/jira/types.d.ts

@@ -0,0 +1,112 @@
+/**
+ * The Jira issue-type scheme — the project's *actual* types and their
+ * hierarchy levels, and what the board's `mapping.types` means against them
+ * (LP-324).
+ *
+ * Jira's issue types are per-project configuration, never platform constants:
+ * an org may have renamed "Epic", deleted "Story", or added levels above Epic
+ * (a paid Premium feature). So the mapping is validated **by name** against
+ * what the project actually reports, and there is no built-in default table —
+ * a board's `epic` may be Jira's "Initiative" on one site and "Epic" on the
+ * next. This module is the judge: a project's reported types in, a report out.
+ * The connector fetches the types (`issueTypes()`); `validateTypeMapping` and
+ * `typeSchemeProblems` only judge them, and `preflightTypeScheme` is the one
+ * async composition that ties the fetch to the judge — the "fetched at
+ * preflight and validated against them" acceptance criterion, ready for the
+ * sync command to call before it plans a push.
+ *
+ * Hierarchy levels, from the Cloud API (`fields.issuetype.hierarchyLevel`):
+ *
+ *   -1  sub-task — must have a parent, never top-level
+ *    0  standard — Story, Task, Bug
+ *    1  epic — the classic ceiling
+ *    2+ levels above epic (Initiative, …) — a paid Premium feature
+ *
+ * The native *parent* levels a project supports is the span between its lowest
+ * and highest level, so "Epic › Story › Sub-task" is 2 and a Premium board
+ * with "Initiative" is 3. Detected, never assumed.
+ */
+import { type DegradedLevel } from '../../mapping.js';
+import type { Problem } from '../../../core/model/types.js';
+/** One issue type as the project reports it (`GET /rest/api/3/project/{key}?expand=issueTypes`). */
+export interface JiraIssueType {
+    /** The issue type name, e.g. "Story", "Epic", "Sub-task". */
+    name: string;
+    /** True for sub-task types — they must be created with a parent. */
+    subtask?: boolean;
+    /** The hierarchy level: -1 sub-task, 0 standard, 1 epic, 2+ above. */
+    hierarchyLevel?: number;
+}
+/** True when the type is a sub-task — the `subtask` flag, or a -1 level. */
+export declare function isSubtaskType(type: JiraIssueType): boolean;
+/** The hierarchy level a type sits at: sub-tasks force -1, the rest report theirs (default 0). */
+export declare function hierarchyLevelOf(type: JiraIssueType): number;
+/**
+ * The native parent levels a project's scheme supports: the span from its
+ * lowest level (sub-task -1, or 0 without sub-tasks) to its highest (0
+ * standard, 1 epic, 2+ Premium). A standard-only project is flat (0).
+ */
+export declare function hierarchyDepthOf(types: readonly JiraIssueType[]): number;
+/** A mapped type the project does not have. */
+export interface MissingType {
+    /** The board type name, e.g. `feature`. */
+    boardType: string;
+    /** The Jira issuetype name the mapping points at, e.g. `Feature`. */
+    mappedType: string;
+}
+/** The board's `mapping.types` judged against the project's actual scheme. */
+export interface TypeSchemeReport {
+    /** The project's issue type names, sorted — the list a bad mapping is shown. */
+    available: string[];
+    /** Board types whose mapped type the project does not have. */
+    missing: MissingType[];
+    /** Board types that map to a sub-task type (must always carry a parent). */
+    subtasks: string[];
+    /** The project's native parent levels, as the hierarchy capability reads. */
+    hierarchyDepth: number;
+    /** The board levels beyond the project's native depth — their parent degrades. */
+    degraded: DegradedLevel[];
+}
+/**
+ * Judge the board's `mapping.types` against the project's reported types.
+ *
+ * Pure: types + mapping + hierarchy in, a report out. A board type whose mapped
+ * type is absent is reported with the full `available` list, so a user can fix
+ * the mapping before filing anything. Types that map to a sub-task are named so
+ * the push knows they must carry a parent. The degraded levels come from
+ * `resolveHierarchyEncoding`, the same computation the push uses, so the report
+ * and the sync cannot disagree about which nesting degrades to labels plus the
+ * managed block.
+ */
+export declare function validateTypeMapping(mapping: Record<string, unknown>, types: readonly JiraIssueType[], hierarchy: string[][]): TypeSchemeReport;
+/**
+ * The preflight problems a `TypeSchemeReport` becomes, in the codebase's own
+ * report vocabulary (`Problem[]`) — the shape `lpm remote …` prints and
+ * `hasErrorProblems` gates on.
+ *
+ * A mapped type the project does not have is an **error** naming the missing
+ * type *and* the list the project does have, so the fix is read off the report
+ * rather than guessed. A level beyond the project's native depth is a
+ * **warning**: its parent degrades to labels plus the managed block, the push
+ * still works.
+ */
+export declare function typeSchemeProblems(report: TypeSchemeReport, remoteName: string, configPath: string): Problem[];
+/**
+ * The live preflight for the type scheme (LP-324): fetch the project's issue
+ * types through the connector and judge the board's `mapping.types` against
+ * them, returning the `Problem[]` a sync gates on (`hasErrorProblems`).
+ *
+ * This is the one async composition the pure halves cannot do on their own:
+ * the connector fetches, `validateTypeMapping` judges, `typeSchemeProblems`
+ * reports. A connector without `issueTypes()` — a provider with no native type
+ * scheme, or a fake in a test — is a no-op: there is no scheme to validate the
+ * mapping against, so there is nothing to report.
+ *
+ * `hierarchy` is the board's issue hierarchy (`hierarchyFor(config, 'issue')`);
+ * the report and the push both read it through `resolveHierarchyEncoding`, so
+ * the degraded levels named here are exactly the levels whose parent rides the
+ * managed block on the way out.
+ */
+export declare function preflightTypeScheme(connector: {
+    issueTypes?(): Promise<readonly JiraIssueType[]>;
+}, mapping: Record<string, unknown>, hierarchy: string[][], remoteName: string, configPath: string): Promise<Problem[]>;

package/dist/remote/providers/jira/types.js

@@ -0,0 +1,160 @@
+/**
+ * The Jira issue-type scheme — the project's *actual* types and their
+ * hierarchy levels, and what the board's `mapping.types` means against them
+ * (LP-324).
+ *
+ * Jira's issue types are per-project configuration, never platform constants:
+ * an org may have renamed "Epic", deleted "Story", or added levels above Epic
+ * (a paid Premium feature). So the mapping is validated **by name** against
+ * what the project actually reports, and there is no built-in default table —
+ * a board's `epic` may be Jira's "Initiative" on one site and "Epic" on the
+ * next. This module is the judge: a project's reported types in, a report out.
+ * The connector fetches the types (`issueTypes()`); `validateTypeMapping` and
+ * `typeSchemeProblems` only judge them, and `preflightTypeScheme` is the one
+ * async composition that ties the fetch to the judge — the "fetched at
+ * preflight and validated against them" acceptance criterion, ready for the
+ * sync command to call before it plans a push.
+ *
+ * Hierarchy levels, from the Cloud API (`fields.issuetype.hierarchyLevel`):
+ *
+ *   -1  sub-task — must have a parent, never top-level
+ *    0  standard — Story, Task, Bug
+ *    1  epic — the classic ceiling
+ *    2+ levels above epic (Initiative, …) — a paid Premium feature
+ *
+ * The native *parent* levels a project supports is the span between its lowest
+ * and highest level, so "Epic › Story › Sub-task" is 2 and a Premium board
+ * with "Initiative" is 3. Detected, never assumed.
+ */
+import { resolveHierarchyEncoding } from '../../hierarchy.js';
+import { normalizeTypeMappings } from '../../mapping.js';
+/** True when the type is a sub-task — the `subtask` flag, or a -1 level. */
+export function isSubtaskType(type) {
+    if (type.subtask !== undefined)
+        return type.subtask;
+    return type.hierarchyLevel === -1;
+}
+/** The hierarchy level a type sits at: sub-tasks force -1, the rest report theirs (default 0). */
+export function hierarchyLevelOf(type) {
+    if (isSubtaskType(type))
+        return -1;
+    return typeof type.hierarchyLevel === 'number' ? type.hierarchyLevel : 0;
+}
+/**
+ * The native parent levels a project's scheme supports: the span from its
+ * lowest level (sub-task -1, or 0 without sub-tasks) to its highest (0
+ * standard, 1 epic, 2+ Premium). A standard-only project is flat (0).
+ */
+export function hierarchyDepthOf(types) {
+    if (types.length === 0)
+        return 0;
+    let min = Infinity;
+    let max = -Infinity;
+    for (const type of types) {
+        const level = hierarchyLevelOf(type);
+        if (level < min)
+            min = level;
+        if (level > max)
+            max = level;
+    }
+    return Math.max(0, max - min);
+}
+/**
+ * Judge the board's `mapping.types` against the project's reported types.
+ *
+ * Pure: types + mapping + hierarchy in, a report out. A board type whose mapped
+ * type is absent is reported with the full `available` list, so a user can fix
+ * the mapping before filing anything. Types that map to a sub-task are named so
+ * the push knows they must carry a parent. The degraded levels come from
+ * `resolveHierarchyEncoding`, the same computation the push uses, so the report
+ * and the sync cannot disagree about which nesting degrades to labels plus the
+ * managed block.
+ */
+export function validateTypeMapping(mapping, types, hierarchy) {
+    const byName = new Map();
+    for (const type of types) {
+        if (!byName.has(type.name))
+            byName.set(type.name, type);
+    }
+    const missing = [];
+    const subtasks = [];
+    // Read straight off a remote declaration rather than through the provider
+    // schema, so it goes through the same normalizer the schema uses.
+    const typeMap = normalizeTypeMappings((mapping['types'] ?? {}));
+    for (const [boardType, entry] of Object.entries(typeMap)) {
+        // The mapped name is a Jira issuetype name here — the project must have
+        // the one it is asked to file against.
+        const mappedType = entry.remote;
+        const found = byName.get(mappedType);
+        if (found === undefined) {
+            missing.push({ boardType, mappedType });
+        }
+        else if (isSubtaskType(found)) {
+            subtasks.push(boardType);
+        }
+    }
+    const depth = hierarchyDepthOf(types);
+    const { degraded } = resolveHierarchyEncoding({ hierarchyDepth: depth }, hierarchy);
+    return {
+        available: [...byName.keys()].sort(),
+        missing: missing.sort((a, b) => a.boardType.localeCompare(b.boardType)),
+        subtasks: subtasks.sort(),
+        hierarchyDepth: depth,
+        degraded,
+    };
+}
+/**
+ * The preflight problems a `TypeSchemeReport` becomes, in the codebase's own
+ * report vocabulary (`Problem[]`) — the shape `lpm remote …` prints and
+ * `hasErrorProblems` gates on.
+ *
+ * A mapped type the project does not have is an **error** naming the missing
+ * type *and* the list the project does have, so the fix is read off the report
+ * rather than guessed. A level beyond the project's native depth is a
+ * **warning**: its parent degrades to labels plus the managed block, the push
+ * still works.
+ */
+export function typeSchemeProblems(report, remoteName, configPath) {
+    const problems = [];
+    for (const missing of report.missing) {
+        problems.push({
+            level: 'error',
+            path: configPath,
+            message: `remotes.${remoteName}.mapping.types.${missing.boardType}: the project has no issue type ` +
+                `"${missing.mappedType}" — it has: ${report.available.join(', ')}`,
+        });
+    }
+    for (const level of report.degraded) {
+        problems.push({
+            level: 'warn',
+            path: configPath,
+            message: `remotes.${remoteName}.mapping.types: level ${level.depth} (${level.types.join(', ')}) is deeper ` +
+                `than the project's ${report.hierarchyDepth} native parent level` +
+                `${report.hierarchyDepth === 1 ? '' : 's'} — its parent degrades to labels plus the managed block`,
+        });
+    }
+    return problems;
+}
+/**
+ * The live preflight for the type scheme (LP-324): fetch the project's issue
+ * types through the connector and judge the board's `mapping.types` against
+ * them, returning the `Problem[]` a sync gates on (`hasErrorProblems`).
+ *
+ * This is the one async composition the pure halves cannot do on their own:
+ * the connector fetches, `validateTypeMapping` judges, `typeSchemeProblems`
+ * reports. A connector without `issueTypes()` — a provider with no native type
+ * scheme, or a fake in a test — is a no-op: there is no scheme to validate the
+ * mapping against, so there is nothing to report.
+ *
+ * `hierarchy` is the board's issue hierarchy (`hierarchyFor(config, 'issue')`);
+ * the report and the push both read it through `resolveHierarchyEncoding`, so
+ * the degraded levels named here are exactly the levels whose parent rides the
+ * managed block on the way out.
+ */
+export async function preflightTypeScheme(connector, mapping, hierarchy, remoteName, configPath) {
+    if (typeof connector.issueTypes !== 'function')
+        return [];
+    const types = await connector.issueTypes();
+    return typeSchemeProblems(validateTypeMapping(mapping, types, hierarchy), remoteName, configPath);
+}
+//# sourceMappingURL=types.js.map