light-plan 0.0.0-stage → 0.1.0

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

@@ -0,0 +1,481 @@
+/**
+ * Projects v2 node-id resolution and caching (LP-310).
+ *
+ * Projects v2 is GraphQL-only and everything in it is a node id: the project,
+ * every field, and every option of a single-select field. A config that names
+ * a Project as `project: 7` or a title, and its fields in plain words, must
+ * not have to carry a `PVT_...` identifier — and nobody should have to read
+ * one. This module resolves those names to node ids once, caches the result
+ * under `.lpm/remotes/<name>/github.json` (committed, so a teammate's first
+ * sync is a read rather than a full re-resolution), and detects a field or
+ * option renamed upstream — reported with both names, never treated as
+ * "missing", which is exactly the mistake that would send `provision` off to
+ * create a duplicate.
+ *
+ * ## Cache by name, verify by id
+ *
+ * The cache keys fields and options by *name*, because a name is the only key
+ * a person writes. When the ids are re-resolved (a `--refresh`, or a cache
+ * miss) the fresh ids are compared against the cached ones: a cached id that
+ * survives under a new name is a rename, and is reported rather than dropped.
+ *
+ * ## Pure vs I/O
+ *
+ * The split mirrors `capabilities.ts`: `resolveProjectGraphql` is the network
+ * half (no disk), `loadProjectCache` / `saveProjectCache` the disk half, and
+ * `resolveProjectIds` the orchestrator that decides when a cache hit is good
+ * enough and when a fresh resolution must run.
+ */
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { BoardError } from '../../../core/errors.js';
+// ---------------------------------------------------------------------------
+// GraphQL documents
+// ---------------------------------------------------------------------------
+/** Resolve a Project by its number: `projectV2(number:)` is the one exact read. */
+const PROJECT_BY_NUMBER_QUERY = `
+query($owner: String!, $repo: String!, $number: Int!) {
+  repository(owner: $owner, name: $repo) {
+    projectV2(number: $number) {
+      id
+      number
+      title
+    }
+  }
+}
+`;
+/** Resolve a Project by its title: list the repo's projects and match the name. */
+const PROJECTS_BY_TITLE_QUERY = `
+query($owner: String!, $repo: String!) {
+  repository(owner: $owner, name: $repo) {
+    projectsV2(first: 100) {
+      nodes {
+        id
+        number
+        title
+      }
+    }
+  }
+}
+`;
+/** Resolve every field of a Project, with each single-select's options and
+ * each iteration field's iterations. */
+const FIELDS_QUERY = `
+query($projectId: ID!) {
+  node(id: $projectId) {
+    ... on ProjectV2 {
+      fields(first: 100) {
+        nodes {
+          id
+          name
+          ... on ProjectV2Field {
+            dataType
+          }
+          ... on ProjectV2SingleSelectField {
+            options(first: 50) {
+              nodes {
+                id
+                name
+              }
+            }
+          }
+          ... on ProjectV2IterationField {
+            configuration {
+              iterations {
+                id
+                title
+                startDate
+                duration
+              }
+            }
+          }
+        }
+        pageInfo {
+          hasNextPage
+          endCursor
+        }
+      }
+    }
+  }
+}
+`;
+// ---------------------------------------------------------------------------
+// The network half
+// ---------------------------------------------------------------------------
+/** Split `owner/repo` into its two parts. */
+function repoParts(repo) {
+    const slash = repo.indexOf('/');
+    if (slash <= 0 || slash === repo.length - 1) {
+        throw new BoardError(`Not an owner/repo: "${repo}"`, [
+            'The GitHub connection.repo must be "owner/repo".',
+        ]);
+    }
+    return { owner: repo.slice(0, slash), name: repo.slice(slash + 1) };
+}
+/** The `graphql` entry point, or a `BoardError` when the connector has none. */
+function graphqlOf(connector) {
+    if (typeof connector.graphql !== 'function') {
+        throw new BoardError(`The ${connector.name} connector has no GraphQL API`, [
+            'Projects v2 ids are GraphQL-only, so this provider must expose a GraphQL entry point to resolve them.',
+        ]);
+    }
+    return connector.graphql.bind(connector);
+}
+/** Read `body.data` as a plain record, or throw when the platform answered
+ * with errors (a missing repository, a permission loss). */
+function dataOf(body) {
+    if (body && typeof body === 'object') {
+        const errors = body['errors'];
+        if (Array.isArray(errors) && errors.length > 0) {
+            const first = errors[0]?.message;
+            throw new BoardError('GitHub GraphQL answered with errors', [
+                typeof first === 'string' ? first : JSON.stringify(errors[0]),
+            ]);
+        }
+        const data = body['data'];
+        if (data && typeof data === 'object')
+            return data;
+    }
+    return {};
+}
+/** Read a field's `dataType`, defaulting to a plain name when absent. */
+function fieldTypeOf(node) {
+    const dataType = node['dataType'];
+    return typeof dataType === 'string' ? dataType : '';
+}
+/** Read a single-select's options as a name → id map. */
+function optionsOf(node) {
+    const options = node['options'];
+    const out = {};
+    if (!options || typeof options !== 'object')
+        return out;
+    const nodes = options.nodes;
+    if (!Array.isArray(nodes))
+        return out;
+    for (const option of nodes) {
+        if (!option || typeof option !== 'object')
+            continue;
+        const record = option;
+        const id = record['id'];
+        const name = record['name'];
+        if (typeof id === 'string' && typeof name === 'string')
+            out[name] = id;
+    }
+    return out;
+}
+/** Read an iteration field's iterations, in the field's own order. Returns
+ * `undefined` for a field with no iteration configuration (every non-iteration
+ * field), so the resolved ids stay free of empty keys a caller must ignore. */
+function iterationsOf(node) {
+    const configuration = node['configuration'];
+    if (!configuration || typeof configuration !== 'object')
+        return undefined;
+    const iterations = configuration.iterations;
+    if (!Array.isArray(iterations))
+        return undefined;
+    const out = [];
+    for (const entry of iterations) {
+        if (!entry || typeof entry !== 'object')
+            continue;
+        const record = entry;
+        const id = record['id'];
+        const title = record['title'];
+        const startDate = record['startDate'];
+        const duration = record['duration'];
+        if (typeof id === 'string' && typeof title === 'string') {
+            out.push({
+                id,
+                title,
+                startDate: typeof startDate === 'string' ? startDate : '',
+                duration: typeof duration === 'number' ? duration : 0,
+            });
+        }
+    }
+    return out;
+}
+/**
+ * Resolve one Project's ids over GraphQL: the project node, then every field
+ * (and each single-select's options). Pure network — no disk.
+ *
+ * `input.project` is a number (resolve by `projectV2(number:)`) or a title
+ * (resolve by name among the repository's projects). A title that matches
+ * nothing, or a number naming no project, is a `BoardError` naming what was
+ * asked for.
+ */
+export async function resolveProjectGraphql(connector, input) {
+    if (input.project === undefined) {
+        throw new BoardError('No Project declared', [
+            'Set mapping.project to a Project number or title before resolving its fields.',
+        ]);
+    }
+    const graphql = graphqlOf(connector);
+    const { owner, name } = repoParts(input.repo);
+    let project;
+    if (typeof input.project === 'number') {
+        const body = await graphql(PROJECT_BY_NUMBER_QUERY, { owner, name, number: input.project });
+        const repository = dataOf(body)['repository'] ?? {};
+        const node = repository['projectV2'] ?? {};
+        const id = node['id'];
+        const title = node['title'];
+        if (typeof id !== 'string') {
+            throw new BoardError(`No Project #${input.project} in ${input.repo}`, [
+                'The repository has no Projects v2 project with that number, or the credential cannot see it.',
+            ]);
+        }
+        project = {
+            id,
+            number: typeof node['number'] === 'number' ? node['number'] : input.project,
+            title: typeof title === 'string' ? title : '',
+        };
+    }
+    else {
+        const body = await graphql(PROJECTS_BY_TITLE_QUERY, { owner, name });
+        const repository = dataOf(body)['repository'] ?? {};
+        const projects = repository['projectsV2'] ?? {};
+        const nodes = Array.isArray(projects.nodes) ? projects.nodes : [];
+        const match = nodes.find((entry) => {
+            if (!entry || typeof entry !== 'object')
+                return false;
+            return entry['title'] === input.project;
+        });
+        if (!match || typeof match['id'] !== 'string') {
+            throw new BoardError(`No Project named "${input.project}" in ${input.repo}`, [
+                'The title must match a Projects v2 project in this repository exactly.',
+            ]);
+        }
+        project = {
+            id: match['id'],
+            number: typeof match['number'] === 'number' ? match['number'] : null,
+            title: input.project,
+        };
+    }
+    const body = await graphql(FIELDS_QUERY, { projectId: project.id });
+    const node = dataOf(body)['node'] ?? {};
+    const fieldsConnection = node['fields'] ?? {};
+    const fields = {};
+    const rawFields = Array.isArray(fieldsConnection.nodes) ? fieldsConnection.nodes : [];
+    for (const entry of rawFields) {
+        if (!entry || typeof entry !== 'object')
+            continue;
+        const field = entry;
+        const id = field['id'];
+        const fieldName = field['name'];
+        if (typeof id !== 'string' || typeof fieldName !== 'string')
+            continue;
+        fields[fieldName] = {
+            id,
+            name: fieldName,
+            type: fieldTypeOf(field),
+            options: optionsOf(field),
+            ...(iterationsOf(field) !== undefined ? { iterations: iterationsOf(field) } : {}),
+        };
+    }
+    return { project, fields };
+}
+// ---------------------------------------------------------------------------
+// The cache on disk
+// ---------------------------------------------------------------------------
+/** The path to one remote's Project ids cache. */
+export function projectCachePath(paths, remoteName) {
+    return path.join(paths.remotesDir, remoteName, 'github.json');
+}
+/** Sort an object's keys, for byte-stable cache writes. */
+function sortedRecord(value) {
+    const out = {};
+    for (const key of Object.keys(value).sort())
+        out[key] = value[key];
+    return out;
+}
+/**
+ * Read the Project ids cache, or `undefined` when none has been recorded yet.
+ * A file that exists but is malformed (or a newer version) is a `BoardError`
+ * naming the path; delete it to re-resolve.
+ */
+export function loadProjectCache(paths, remoteName) {
+    const file = projectCachePath(paths, remoteName);
+    let raw;
+    try {
+        raw = readFileSync(file, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        throw new BoardError(`Cannot parse Project cache: ${file}`, [
+            error.message,
+            'Delete it to re-resolve the Project ids, or repair the JSON.',
+        ]);
+    }
+    const cache = parsed;
+    if (cache.version !== 1) {
+        throw new BoardError(`Unsupported Project cache version in ${file}`, [
+            `Found version ${JSON.stringify(cache.version)}; expected 1.`,
+            'Delete it to re-resolve the Project ids.',
+        ]);
+    }
+    const project = cache.project;
+    if (!project || typeof project.id !== 'string') {
+        throw new BoardError(`Invalid Project cache: ${file}`, [
+            'The cache is missing a valid project id.',
+            'Delete it to re-resolve the Project ids.',
+        ]);
+    }
+    const fields = cache.fields;
+    if (!fields || typeof fields !== 'object' || Array.isArray(fields)) {
+        throw new BoardError(`Invalid Project cache: ${file}`, [
+            'The cache is missing a valid fields object.',
+            'Delete it to re-resolve the Project ids.',
+        ]);
+    }
+    // A cache written before iterations were cached (LP-313) still loads — the
+    // iteration list is absent, which a fresh resolution refills.
+    const normalized = {};
+    for (const [name, field] of Object.entries(fields)) {
+        normalized[name] = {
+            ...field,
+            options: field.options ?? {},
+            ...(field.iterations !== undefined ? { iterations: field.iterations } : {}),
+        };
+    }
+    return {
+        version: 1,
+        resolvedAt: typeof cache.resolvedAt === 'string' ? cache.resolvedAt : '',
+        project: {
+            id: project.id,
+            number: typeof project['number'] === 'number' ? project['number'] : null,
+            title: typeof project['title'] === 'string' ? project['title'] : '',
+        },
+        fields: normalized,
+    };
+}
+/**
+ * Write the Project ids cache to disk, creating the per-remote folder if
+ * needed. Field keys and option keys are written sorted so two teammates
+ * resolving the same ids on different branches produce a non-overlapping diff.
+ */
+export function saveProjectCache(paths, remoteName, cache) {
+    const file = projectCachePath(paths, remoteName);
+    mkdirSync(path.dirname(file), { recursive: true });
+    const fields = {};
+    for (const [name, field] of Object.entries(sortedRecord(cache.fields))) {
+        fields[name] = { ...field, options: sortedRecord(field.options) };
+    }
+    const onDisk = {
+        version: 1,
+        resolvedAt: cache.resolvedAt,
+        project: cache.project,
+        fields,
+    };
+    writeFileSync(file, `${JSON.stringify(onDisk, null, 2)}\n`, 'utf8');
+}
+// ---------------------------------------------------------------------------
+// Mismatch detection
+// ---------------------------------------------------------------------------
+/** Index a field collection by id, so a rename can be traced from the id. */
+function byId(fields) {
+    const out = new Map();
+    for (const field of Object.values(fields))
+        out.set(field.id, field);
+    return out;
+}
+/**
+ * Compare a fresh resolution against the previous cache, for the fields the
+ * mapping names. A cached id that survives under a new name is a rename; a
+ * name with no match and no surviving id is missing. Option names are checked
+ * the same way, within the fields that still match by id.
+ */
+export function detectMismatches(previous, fresh, mappedFields) {
+    const fieldFindings = [];
+    const optionFindings = [];
+    const freshById = byId(fresh.fields);
+    for (const name of new Set(Object.values(mappedFields))) {
+        if (name === '')
+            continue;
+        const prev = previous?.fields[name];
+        const current = fresh.fields[name];
+        if (current !== undefined) {
+            // The name resolves today. When it also resolved before, and to the same
+            // id, its options are worth checking for renames.
+            if (prev !== undefined && prev.id === current.id) {
+                const optionById = new Map(Object.entries(current.options).map(([optionName, optionId]) => [optionId, optionName]));
+                for (const [optionName, optionId] of Object.entries(prev.options)) {
+                    if (current.options[optionName] === optionId)
+                        continue;
+                    const renamed = optionById.get(optionId);
+                    if (renamed !== undefined) {
+                        optionFindings.push({
+                            kind: 'renamed',
+                            field: name,
+                            name: optionName,
+                            id: optionId,
+                            newName: renamed,
+                        });
+                    }
+                    else {
+                        optionFindings.push({ kind: 'missing', field: name, name: optionName });
+                    }
+                }
+            }
+            continue;
+        }
+        // The name does not resolve. A previous id that still exists under another
+        // name is a rename; otherwise the field is genuinely absent.
+        if (prev !== undefined) {
+            const renamed = freshById.get(prev.id);
+            if (renamed !== undefined && renamed.name !== name) {
+                fieldFindings.push({ kind: 'renamed', name, id: prev.id, newName: renamed.name });
+            }
+            else {
+                fieldFindings.push({ kind: 'missing', name });
+            }
+        }
+        else {
+            fieldFindings.push({ kind: 'missing', name });
+        }
+    }
+    return { fieldFindings, optionFindings };
+}
+// ---------------------------------------------------------------------------
+// The orchestrator
+// ---------------------------------------------------------------------------
+/**
+ * Resolve one Project's ids, reading the cache when it exists and re-resolving
+ * on a cache miss or `refresh`.
+ *
+ * The cache is the committed `.lpm/remotes/<name>/github.json`, so a teammate
+ * who pulls the board reads the ids instead of re-resolving them; only a cache
+ * miss or an explicit `--refresh` reaches the network. When a resolution runs
+ * against a previous cache, renamed fields and options are reported with both
+ * names (never treated as missing), and the cache is rewritten.
+ */
+export async function resolveProjectIds(connector, input, paths, remoteName, opts = {}) {
+    const previous = loadProjectCache(paths, remoteName);
+    if (previous !== undefined && opts.refresh !== true) {
+        return {
+            ids: { project: previous.project, fields: previous.fields },
+            refreshed: false,
+            fieldFindings: [],
+            optionFindings: [],
+        };
+    }
+    const fresh = await resolveProjectGraphql(connector, input);
+    const { fieldFindings, optionFindings } = detectMismatches(previous, fresh, input.fields);
+    const cache = {
+        version: 1,
+        resolvedAt: new Date(opts.now ? opts.now() : Date.now()).toISOString(),
+        project: fresh.project,
+        fields: fresh.fields,
+    };
+    saveProjectCache(paths, remoteName, cache);
+    return {
+        ids: fresh,
+        refreshed: true,
+        fieldFindings,
+        optionFindings,
+    };
+}
+//# sourceMappingURL=projects.js.map

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

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

package/dist/remote/providers/github/translator.d.ts

@@ -0,0 +1,103 @@
+/**
+ * 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 { type Roster } from '../../accounts.js';
+import type { AttributeDefs, BoardOp, DescribeResult, FieldsFromRecordResult, RemoteRecord, Translator } from '../../provider.js';
+import { type LabelClaim } from '../../labels.js';
+import { type PeriodIndex } from '../../periods.js';
+import type { GithubMapping } from './config.js';
+/**
+ * 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 declare function labelClaimFromMapping(mapping: GithubMapping, _periods?: PeriodIndex): LabelClaim;
+/**
+ * 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 declare function describeRequest(op: BoardOp, mapping: Record<string, unknown>, attributes: AttributeDefs, roster?: Roster, periods?: PeriodIndex): DescribeResult;
+/**
+ * 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 declare function fieldsFromRecord(record: RemoteRecord, mapping: Record<string, unknown>, attributes: AttributeDefs, roster?: Roster, periods?: PeriodIndex): FieldsFromRecordResult;
+export declare const githubTranslator: Translator;