light-plan 0.0.0-stage → 0.1.0

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

@@ -0,0 +1,400 @@
+/**
+ * GitHub's two-way vocabulary translation.
+ *
+ * GitHub has no native issue types, no custom fields, and no workflow state
+ * beyond open/closed — so everything the board distinguishes rides on labels.
+ * This translator is the GitHub-specific bridge between the board vocabulary
+ * and the GitHub one, using the remote's `mapping` block:
+ *
+ *   push: a `BoardOp` plus the mapping becomes a `RemoteRequest` carrying
+ *         title, body and the labels that stand in for type / status /
+ *         attributes;
+ *   pull: a GitHub issue record plus the mapping becomes `BoardFieldsPatch`,
+ *         recovering type and status from labels when the mapping names them
+ *         unambiguously.
+ *
+ * Pure: no I/O. One translator serves every GitHub remote; the mapping and the
+ * board's attribute definitions are passed per call. Where a value cannot be
+ * mapped back unambiguously, the field is left absent rather than guessed —
+ * the pull planner, which sees the whole board and its hierarchy, is the layer
+ * that breaks ties (LP-268).
+ *
+ * Statuses are the one vocabulary element that is fully two-way here: the
+ * status engine (`mapping.ts`, LP-269) resolves a board status to the remote
+ * label a push writes, resolves the observed labels back to a board status,
+ * and carries the `closed` flag that maps a terminal status onto GitHub's
+ * open/closed state.
+ *
+ * Attributes go through the coercion engine (`attributes.ts`, LP-270): a value
+ * is coerced to its label form on the way out and back to its board type on
+ * the way in, with a reported failure when it cannot — an enum value with no
+ * matching option, a number field holding free text. On this provider the
+ * remote field kind is derived from the board type, because GitHub's only
+ * carrier is a label: an `array` attribute claims one label per item, every
+ * other type claims one label holding the value as text. A label the mapping
+ * does not claim is never read into an attribute, and is left for the executor
+ * to preserve — labels are shared with humans.
+ *
+ * Assignees go through the account mapping (`accounts.ts`, LP-271): a person
+ * whose `via` attribute holds a login becomes that login, a person with no
+ * login and a generic pool both go unassigned — the pool also carries a
+ * `pool:` label so the pull can restore it — and a login nobody on the roster
+ * matches is reported with the `lpm new person` that would add them, never
+ * invented.
+ *
+ * Periods go through the period mapping (`periods.ts`, LP-272, LP-313): the
+ * mapped level becomes the native carrier — a milestone or a Project iteration
+ * field — and every other level a `period:<type>` row in the managed block.
+ * The pull resolves the carrier's title back to a local period — recovering
+ * the dates for the planner to reconcile — and reads the degraded levels back
+ * out of the block.
+ */
+import { mapAssigneeFromRemote, mapAssigneeToRemote, normalizeAccountMapping, } from '../../accounts.js';
+import { coerceFromRemote, coerceToRemote, } from '../../attributes.js';
+import { boardTypesMatching, claimedTypeValues, isClosedRemote, mapStatusFromRemote, mapStatusToRemote, mapTypeToRemote, } from '../../mapping.js';
+import { parseManagedBlock } from '../../managed-block.js';
+import { labelClaim } from '../../labels.js';
+import { withBlockAssignee } from '../../accounts.js';
+import { degradedFromBlockFields, degradedTypesOf, mapPeriodFromRemote, mapPeriodToRemote, normalizePeriodMapping, } from '../../periods.js';
+import { projectStatusFieldOf, resolveProjectStatus, } from './project-status.js';
+/** Extract a GitHub issue's labels as plain strings. */
+function labelsOf(record) {
+    const labels = record.labels;
+    if (!Array.isArray(labels))
+        return [];
+    return labels
+        .map((label) => {
+        if (typeof label === 'string')
+            return label;
+        if (label && typeof label === 'object') {
+            const name = label.name;
+            if (typeof name === 'string')
+                return name;
+        }
+        return '';
+    })
+        .filter((label) => label.length > 0);
+}
+/**
+ * The remote field a board attribute of this type lands on, given that the
+ * only carrier GitHub has is a label. An `array` claims one label per item
+ * (`labels`); every other type claims a single label holding the value as text
+ * (`text`). The coercion then does the type work in both directions.
+ */
+function fieldFor(type) {
+    return type === 'array' ? { kind: 'labels' } : { kind: 'text' };
+}
+/** Skip a value that carries nothing to write. */
+function isEmptyValue(value) {
+    return value === undefined || value === null || value === '';
+}
+/**
+ * The labels a mapping claims, derived from its declaration (LP-308). Exact
+ * labels are the type labels and status states; prefixes are the attribute
+ * prefixes and the reserved `pool:` prefix (a pool assignment degrades to a
+ * label even when no account mapping is declared). Degraded period levels no
+ * longer ride labels — they ride the managed block (LP-313) — so the claim
+ * derives nothing from the timeline. Derived from the mapping rather than a
+ * convention, so a board that maps an attribute onto real label names still
+ * owns exactly those names and nothing else.
+ */
+export function labelClaimFromMapping(mapping, _periods = new Map()) {
+    const exact = [];
+    const prefixes = [];
+    exact.push(...claimedTypeValues(mapping.types ?? {}));
+    for (const entry of Object.values(mapping.statuses ?? {})) {
+        exact.push(...entry.remote);
+    }
+    for (const prefix of Object.values(mapping.attributes ?? {})) {
+        if (prefix.length > 0)
+            prefixes.push(`${prefix}:`);
+    }
+    // A generic pool degrades to a `pool:` label whatever the account mapping
+    // says, so the prefix is always claimed (LP-271).
+    prefixes.push('pool:');
+    return labelClaim(exact, prefixes);
+}
+/**
+ * Push: turn a board op into a GitHub request description.
+ *
+ * A create/update carries `title`, `body` and the labels derived from the
+ * mapping: the type's labels, the status's label, and one `<prefix>:<value>`
+ * label per mapped attribute (several for an `array`). An attribute value that
+ * will not coerce is omitted and reported in `problems` — nothing is written
+ * for it. The assignee is resolved through the account mapping (a login, or
+ * unassigned for a pool / a gap). A delete carries only its kind — GitHub
+ * issues cannot be hard-deleted, so the connector closes them.
+ *
+ * Every non-delete request also carries the label claim, so the connector can
+ * reconcile the list against the labels already on the issue (LP-308).
+ */
+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 labels = [];
+    const problems = [];
+    const resourceGaps = [];
+    const periodGaps = [];
+    let state;
+    let assignee;
+    let period;
+    let degradedPeriods;
+    let projectStatus;
+    // GitHub has no native type field in the REST issue body, so the mapped
+    // value rides a label — which carrier it lands in is this translator's
+    // call, never the mapping's.
+    const remoteType = mapTypeToRemote(m.types ?? {}, op.fields.type);
+    if (remoteType !== undefined)
+        labels.push(remoteType);
+    const remoteStatus = mapStatusToRemote(m.statuses ?? {}, op.fields.status);
+    if (remoteStatus !== undefined) {
+        labels.push(remoteStatus);
+        // A terminal status closes the remote issue; an explicitly-open status
+        // opens it (so a card moved back out of `done` reopens its twin).  When
+        // the mapping does not say, the state is left untouched rather than
+        // guessed — `lpm check` warns about a terminal status that never says.
+        const closed = isClosedRemote(m.statuses ?? {}, op.fields.status);
+        if (closed === true)
+            state = 'closed';
+        else if (closed === false)
+            state = 'open';
+        // Project status (LP-312): when the board's status lives in a Project
+        // single-select, the same label is also the column value the connector
+        // writes there — the executor asks for it only on a status-affecting
+        // write.
+        if (projectStatusFieldOf(m) !== undefined)
+            projectStatus = remoteStatus;
+    }
+    // Assignee: resolve the board resource to a GitHub login (LP-271).  A pool
+    // becomes unassigned plus a `pool:` label; a person with no login becomes
+    // unassigned and is reported.  Absent (`undefined`) means the op does not
+    // carry an assignee, so the remote side is left untouched.
+    if (op.fields.assignee !== undefined) {
+        const accounts = normalizeAccountMapping(m.accounts);
+        const push = mapAssigneeToRemote(roster, accounts, op.fields.assignee);
+        labels.push(...push.labels);
+        assignee = push.account ?? null;
+        if (push.gap)
+            resourceGaps.push(push.gap);
+    }
+    // Period: resolve the issue's period to a container (the mapped level) plus
+    // the degraded levels above it, which ride the managed block (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 milestone/iteration, 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);
+        }
+    }
+    for (const [attribute, prefix] of Object.entries(m.attributes ?? {})) {
+        const value = op.fields.attributes?.[attribute];
+        if (isEmptyValue(value))
+            continue;
+        const type = attributes[attribute]?.type ?? 'string';
+        const field = fieldFor(type);
+        const result = coerceToRemote(type, value, field);
+        if (!result.ok) {
+            problems.push({ attribute, direction: 'push', reason: result.reason, options: result.options });
+            continue;
+        }
+        if (field.kind === 'labels') {
+            for (const item of result.value)
+                labels.push(`${prefix}:${item}`);
+        }
+        else {
+            labels.push(`${prefix}:${String(result.value)}`);
+        }
+    }
+    return {
+        request: {
+            kind: op.kind,
+            title: op.fields.title,
+            body: op.fields.body,
+            labels,
+            labelClaim: labelClaimFromMapping(m, periods),
+            state,
+            assignee,
+            period,
+            ...(degradedPeriods !== undefined ? { degradedPeriods } : {}),
+            ...(projectStatus !== undefined ? { projectStatus } : {}),
+        },
+        problems,
+        resourceGaps,
+        periodGaps,
+    };
+}
+/**
+ * Pull: turn a GitHub issue record into board fields.
+ *
+ * `title` and `body` pass through; `type` is recovered when exactly one board
+ * type's mapped labels match the issue's labels; `status` when a mapped label
+ * names it; `attributes` from `<prefix>:<value>` labels, coerced back to each
+ * attribute's board type. A label value that will not coerce back (free text
+ * in a number field) is reported in `problems` and the attribute is left
+ * alone. Ambiguity leaves the field absent — the pull planner breaks ties with
+ * the board's hierarchy. The assignee is recovered through the account
+ * mapping: the `pool:` label restores a pool, a login restores a person, an
+ * unassigned issue clears it, and a login nobody matches is reported. The
+ * period is recovered through the period mapping (LP-272, LP-313): the
+ * carrier's title — a milestone or a Project iteration — resolves to a local
+ * period, its dates are passed through for the planner to reconcile, a
+ * carrier nobody on the timeline matches is reported in `result.period.missing`
+ * rather than invented, and the degraded levels ride back out of the managed
+ * block.
+ */
+export function fieldsFromRecord(record, mapping, attributes, roster = new Map(), periods = new Map()) {
+    const m = mapping;
+    const labels = labelsOf(record);
+    const patch = {};
+    const problems = [];
+    const unknownAccounts = [];
+    const result = { patch, problems, unknownAccounts };
+    if (typeof record.title === 'string')
+        patch.title = record.title;
+    // The managed block is the sync layer's own output, never the document's
+    // prose — it is stripped on the way back so the local body holds what a
+    // human wrote, not the `parent` / edge / period rows the encoder appended
+    // (LP-309, LP-314, LP-313).
+    let managedFields = {};
+    if (typeof record.body === 'string') {
+        const parsed = parseManagedBlock(record.body);
+        patch.body = parsed.found ? parsed.body : record.body;
+        if (parsed.found)
+            managedFields = parsed.fields;
+    }
+    // Period: the container (a milestone or an iteration, per the carrier)
+    // resolves to a local period by name among the mapped level's periods; its
+    // dates are the observed dates, carried for the planner to reconcile against
+    // the local period.  A container with no local counterpart is reported,
+    // never invented (LP-272, LP-313).
+    const periodMapping = normalizePeriodMapping(m.periods);
+    if (periodMapping) {
+        let name;
+        let ends;
+        if (periodMapping.carrier === 'iteration') {
+            // The iteration title arrives on the record via `project_iteration`,
+            // enriched by the connector's Project read (LP-313).
+            const iteration = record['project_iteration'];
+            if (typeof iteration === 'string')
+                name = iteration;
+        }
+        else {
+            const milestone = record.milestone;
+            if (milestone && typeof milestone === 'object') {
+                const title = milestone.title;
+                if (typeof title === 'string')
+                    name = title;
+                const due = milestone.due_on;
+                if (typeof due === 'string')
+                    ends = due;
+            }
+        }
+        const pull = mapPeriodFromRemote(periods, periodMapping, {
+            container: name,
+            ends,
+            degraded: degradedFromBlockFields(managedFields, degradedTypesOf(periods, periodMapping)),
+        });
+        if (pull.periodId !== undefined)
+            patch.period = pull.periodId;
+        result.period = pull;
+    }
+    // Assignee: the `pool:` label restores a pool, a login matching a person's
+    // `via` value restores that person, an explicitly-unassigned issue clears
+    // the local assignee, and a login nobody on the roster matches is reported
+    // with the `lpm new person` that would add them — never invented (LP-271).
+    const assignee = record.assignee;
+    let login;
+    if (assignee && typeof assignee === 'object') {
+        const value = assignee.login;
+        if (typeof value === 'string')
+            login = value;
+    }
+    // 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 accounts = normalizeAccountMapping(m.accounts);
+    const resolved = mapAssigneeFromRemote(roster, accounts, {
+        account: login,
+        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);
+    }
+    // Type: every board type whose mapped values appear on the issue.
+    const typeCandidates = boardTypesMatching(m.types ?? {}, { labels });
+    if (typeCandidates.length === 1)
+        patch.type = typeCandidates[0];
+    // Status: labels are the legacy carrier; the issue state and (when the
+    // mapping declares a Project status field) the Project column are the two
+    // signals that can override it. The state only names terminality (a closed
+    // issue is the terminal status); the column names a specific status. They
+    // resolve together with the configured precedence, and a disagreement is
+    // reported in `statusDiscrepancy` rather than silently chosen (LP-312).
+    const projectField = projectStatusFieldOf(m);
+    const column = projectField !== undefined && typeof record['project_status'] === 'string'
+        ? record['project_status']
+        : undefined;
+    const state = typeof record['state'] === 'string' ? record['state'] : undefined;
+    const projectResolution = resolveProjectStatus(m, { column, state });
+    if (projectResolution.status !== undefined) {
+        patch.status = projectResolution.status;
+    }
+    else {
+        const resolution = mapStatusFromRemote(m.statuses ?? {}, labels);
+        if (resolution.status !== undefined)
+            patch.status = resolution.status;
+    }
+    if (projectResolution.discrepancy !== undefined) {
+        result.statusDiscrepancy = projectResolution.discrepancy;
+    }
+    // Attributes: `<prefix>:<value>` labels, coerced back by prefix and type.
+    const recovered = {};
+    for (const [attribute, prefix] of Object.entries(m.attributes ?? {})) {
+        const type = attributes[attribute]?.type ?? 'string';
+        const field = fieldFor(type);
+        if (field.kind === 'labels') {
+            const items = labels
+                .filter((label) => label.startsWith(`${prefix}:`))
+                .map((label) => label.slice(prefix.length + 1))
+                .filter((item) => item.length > 0);
+            if (items.length > 0)
+                recovered[attribute] = items;
+            continue;
+        }
+        const marker = labels.find((label) => label.startsWith(`${prefix}:`));
+        if (marker === undefined)
+            continue;
+        const raw = marker.slice(prefix.length + 1);
+        const result = coerceFromRemote(type, raw, { values: attributes[attribute]?.values });
+        if (result.ok) {
+            recovered[attribute] = result.value;
+        }
+        else {
+            problems.push({ attribute, direction: 'pull', reason: result.reason, options: result.options });
+        }
+    }
+    if (Object.keys(recovered).length > 0)
+        patch.attributes = recovered;
+    return result;
+}
+export const githubTranslator = {
+    describeRequest,
+    fieldsFromRecord,
+};
+//# sourceMappingURL=translator.js.map

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

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

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

@@ -0,0 +1,96 @@
+/**
+ * The Jira provider's own slice of a remote declaration.
+ *
+ * Core validates the frame — that a remote has a `provider`, a scope, a
+ * direction and two policies. This schema validates the contents of the
+ * `connection` and `mapping` blocks for Jira Cloud specifically, and is called
+ * when the remote is opened (LP-259), exactly as `storage/views.ts` owns the
+ * contents of a view file.
+ *
+ * Jira Cloud has *native* issue types, workflow statuses (transition-mediated)
+ * and custom fields, so the mapping names them rather than encoding them onto
+ * labels:
+ *
+ *   - `types`      board type → the Jira issuetype name (`{ type: Story }`)
+ *   - `statuses`   board status id → the Jira status name(s) a push targets,
+ *                  plus whether the status is terminal (`closed`) — the flag
+ *                  that lets the sync tell a finished column from an open one
+ *   - `attributes` board attribute name → the Jira custom field id that
+ *                  carries it (`customfield_10016`). Resolving a *name* to an
+ *                  id is LP-324's discovery, not this schema's: the mapping
+ *                  names the id the instance actually has.
+ *   - `accounts`   `{ via: <attribute> }` — which resource attribute carries
+ *                  the Jira account (LP-271, LP-329). `via: email` resolves
+ *                  through Jira's user search and is refused with the
+ *                  `jira_account_id` alternative on a privacy-restricted
+ *                  instance; `via: jira_account_id` (or any other attribute)
+ *                  holds the account id and is used directly, no search.
+ *   - `periods`    `{ container: <period type> }` — which period level maps to
+ *                  a Jira sprint (LP-328); the other levels ride labels
+ *   - `transitions` `{ multi_hop: <bool> }` — whether a status change may walk
+ *                  the workflow several transitions (LP-326); off by default
+ *   - `transition_fields` field key → value, the answers for transition
+ *                  screens whose fields are required (a resolution, a reason)
+ *
+ * The connection block carries the Cloud site, the project key and the agile
+ * board id (enables sprint mapping), plus the identity resolved through the
+ * credential chain — `email` and `token` name *where* the secret comes from,
+ * never the secret itself (LP-290).
+ */
+import { z } from 'zod';
+export declare const jiraConfigSchema: z.ZodObject<{
+    connection: z.ZodObject<{
+        site: z.ZodString;
+        project: z.ZodString;
+        board: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>, z.ZodTransform<string | undefined, string | number | undefined>>;
+        email: z.ZodOptional<z.ZodString>;
+        token: z.ZodOptional<z.ZodString>;
+        tls_verify: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    mapping: z.ZodObject<{
+        types: z.ZodPipe<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodObject<{
+            remote: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+            type: z.ZodOptional<z.ZodString>;
+            labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>]>>>, z.ZodTransform<import("../../mapping.js").TypeMappings, Record<string, string | string[] | {
+            remote?: string | string[] | undefined;
+            type?: string | undefined;
+            labels?: string[] | undefined;
+        }>>>;
+        statuses: z.ZodPipe<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodObject<{
+            remote: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+            push: z.ZodOptional<z.ZodString>;
+            closed: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>]>>>, z.ZodTransform<import("../../mapping.js").StatusMappings, Record<string, string | string[] | {
+            remote: string | string[];
+            push?: string | undefined;
+            closed?: boolean | undefined;
+        }>>>;
+        transitions: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            multi_hop: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        transition_fields: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        attributes: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        accounts: z.ZodOptional<z.ZodObject<{
+            via: z.ZodString;
+        }, z.core.$strip>>;
+        hierarchy: z.ZodOptional<z.ZodEnum<{
+            labels: "labels";
+            "sub-issues": "sub-issues";
+        }>>;
+        periods: z.ZodOptional<z.ZodPipe<z.ZodObject<{
+            container: z.ZodString;
+        }, z.core.$strip>, z.ZodTransform<{
+            container: string;
+            carrier: "sprint";
+        }, {
+            container: string;
+        }>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** The validated shape of a Jira remote declaration. */
+export type JiraConfig = z.infer<typeof jiraConfigSchema>;
+/** The `mapping` block, after validation. */
+export type JiraMapping = JiraConfig['mapping'];
+/** The `connection` block, after validation (defaults applied, board stringified). */
+export type JiraConnection = JiraConfig['connection'];